先分流：安装启用失败 vs 已启用仍调用失败
搜「OpeClaw 工具调用失败」「Skill 执行报错」时，先确认现象属于哪一类：Skills 装不上或开关找不到；工具/Skill 已启用，但一调用就报没权限；跑到一半停下并给出错误提示；文件路径找不到；或界面出现错误码/失败原因。
Skills 安装与启用专题管「怎么装上、怎么打开」。本文只管「已启用但仍调用失败」的运行时排查：权限、路径、参数与返回提示怎么读。读工作区文件走本地文件夹专题；看日志走日志诊断；输出文字被截断走回复截断专题。
不编造具体工具 API 名、未公开权限开关名称或官方错误码表。工具是否可用、权限范围与提示文案，一律以当前客户端可见工具状态与日志提示为准。分享日志前请脱敏路径、密钥与账号。
- 装不上 / 无入口：Skills 安装与启用。
- 已启用仍失败：本文（权限、路径、参数、返回提示）。
- 读不到工作区文件：本地文件夹与工作区。
- 需要完整时间线：日志诊断；文字写一半停：输出截断。
工具没权限：先看可见授权，再缩小范围
「工具没权限」常见表现是：调用被拒绝、提示无法访问某资源、或 Skill 一开始就被拦下。先在当前客户端里核对该工具/Skill 的启用状态，以及是否弹出过文件、脚本、网络等相关授权——具体开关名称以界面为准，不要按网上传闻猜未公开选项。
处理顺序建议：只保留当前要测的一个工具或 Skill → 按弹窗或设置页给出的最小权限重试 → 确认目标路径落在你已允许的范围内 → 仍失败再取日志关键行（脱敏后）。一次开很多扩展，很难判断是哪一个权限边界触发。
公司机、学校账号或受管设备上，系统策略可能允许打开客户端，却禁止脚本或扩展目录写入。这时应向管理员确认策略，而不是寻找来源不明的「一键提权」包。
文件路径找不到：核对字符串，而不是反复重装
「文件路径找不到」时，先区分：工作区根本没接上，还是路径字符串写错、相对路径基准不对、或目标已移出允许目录。前者优先走本地文件夹与工作区专题；后者在本文核对本次调用里出现的路径。
核对清单：路径是否完整、大小写是否与本机一致（尤其 macOS/Linux）、空格与特殊字符是否被截断、相对路径是否相对于当前工作区根目录。不要把「模型口头说读过」当成已成功读到；以工具返回或日志中的失败提示为准。
粘贴路径到对话或工单时，用占位符替换用户名、项目私有目录与密钥文件名。脱敏后再对照日志诊断文取关键错误行。
- 工作区未接入 / 系统权限对话框：本地文件夹专题。
- 路径字符串、相对基准、越界访问：本文核对。
- 分享前脱敏：用户目录、密钥、内网主机名。
Skill 跑一半停：区分执行报错与输出中断
Skill 跑一半停下时，先看有没有明确的工具/Skill 错误提示。有拒绝、路径无效、参数不合规或失败原因时，按运行时失败继续查权限与参数；没有工具错误、只是回答文字中途停止，则改走回复截断与输出中断专题。
可复现的最小步骤：同一 Skill 只跑一条短任务、不碰敏感目录；记录停下时刻的界面原文（脱敏）；必要时用日志诊断专题按当前版本取日志，只保留时间戳与错误行。
不要根据感觉编造「某错误码 = 某固定官方含义」。同一数字在不同版本或不同工具上可能含义不同，以当前客户端可见提示与版本说明为准。
参数与返回提示：怎么读，不编造错误码表
工具返回错误提示时，优先保存完整原文（含前后几行上下文），而不是只记住一个数字。参数类失败常见于：必填项缺失、类型不符、路径为空、或请求超出当前工具声明的能力范围——具体字段名以当前客户端/工具说明为准。
阅读顺序：界面短提示 → 日志关键错误行 → 当前版本发布说明中与工具/Skills 相关的已知限制。本站不提供未公开的官方错误码对照表，也不列举具体工具 API 名称清单。
若提示指向认证失败、额度或代理连不上模型，那是模型通道问题，应改走 API Key 与额度或代理连接专题，而不是在本文里改 Skills 参数。
对照表：按现象选下一篇，避免混查
下表只做分流。具体菜单名、权限文案与错误提示，以你当前客户端为准。
| 现象 | 优先判断 | 下一步 |
|---|---|---|
| Skills 装不上或找不到启用入口 | 安装/启用层 | Skills 安装与启用专题 |
| 已启用，提示没权限或访问被拒 | 运行时权限 | 本文：缩小授权范围后重试 |
| 提示路径不存在或读不到文件 | 工作区或路径字符串 | 先本地文件夹，再核对本路径 |
| Skill 跑一半且有工具错误提示 | 执行失败 | 本文 + 日志诊断（脱敏） |
| 文字写一半停、无工具错误 | 输出中断 | 回复截断与输出中断专题 |
| 401 / 429 / 代理连不上 | 模型通道 | API Key 或代理连接专题 |
不编造具体工具 API 名、未公开权限开关或官方错误码表；以当前客户端可见工具状态与日志提示为准。
最小验证与求助前清单
最小验证：只启用一个相关工具或 Skill → 对非敏感测试目录执行一条短任务 → 成功则逐步恢复其他扩展；失败则固定该复现步骤，再查权限与路径。
求助或自查日志前：记下客户端版本、操作系统、是否刚更新、完整错误原文（脱敏路径与密钥）、已尝试过的权限与路径核对。日志怎么取、关键行怎么读，见日志诊断专题。
需要安装入口或核对发布状态时回到下载页；通用产品问题对照 FAQ。若问题其实是「忘了前文」而不是工具报错，改看上下文与会话管理专题。
工具与 Skill 调用失败常见问题
OpeClaw 工具调用失败，是不是 Skills 没装好？
先分清两层：若 Skills 开关本身找不到、装不上或启用后完全无入口，请走 Skills 安装与启用专题。本文处理的是「已启用仍调用失败」：权限不足、路径找不到、参数不合规、工具返回错误提示等运行时问题。以当前客户端可见的工具状态与日志提示为准。
Skill 跑一半停下，算工具失败还是输出截断？
若界面或日志明确提示工具/Skill 执行出错、权限拒绝或路径无效，按本文排查。若模型文字写到一半停下、代码围栏未闭合，且没有工具错误提示，改走回复截断与输出中断专题。两者可能先后出现，先处理有明确错误提示的那一层。
工具返回错误码怎么看？有没有官方错误码表？
本站不编造未公开的官方错误码表，也不列举具体工具 API 名。请复制客户端或日志中的完整提示（脱敏后），对照当前版本说明与可见工具状态。需要时间线时，用日志诊断专题按版本取日志。
提示找不到文件路径，按本文还是本地工作区文？
工作区未接入、系统权限对话框未通过、整目录读不到，优先看本地文件夹与工作区专题。工具已声明可访问某路径却仍失败，再按本文核对该次调用的路径字符串、相对/绝对路径与是否越出允许范围。