OpenClaw常见问题：先查注册再查工作区

OpenClaw 出问题，先不要重装。它是聚焦本地文件、命令行和可组合工作流的 Agent，故障通常能收成四类：Skill 没有真正注册、当前工作区不是你以为的目录、批量任务没先用样本跑通、把网页 HTML 当成了安装包。站内《OpenClaw是什么》讲适不适合用，《OpenClaw安装Skill》讲第一次怎么挂，《Workbuddy排错指南》按办公场景归因。本文只处理 OpenClaw 已经能对话之后的高频症状。文中命令以 VibeMKT Hub 产品页 2026年9月7日的写法为准；界面名称若和你的版本不一致，以 OpenClaw 当天文档为准，不要用过期截图硬套。

先按这个顺序排除，成本从低到高

1. 问自己：这次要动的是只读检查，还是写文件、删文件、外传？后者先停自动执行。
2. 在同一终端跑注册检查，确认 Skill 名出现在列表里。
3. 让 Agent 打印“当前工作目录”和它打算读写的路径，人工对一眼。
4. 用 5 到 10 条样本重跑同一任务，不要直接对全站或全表。

VibeMKT Hub 的 OpenClaw 营销 Skill 页把装完验证写成：运行 openclaw skills list 确认已注册，再用一条只读样本检查调用。产品页给各 Skill 的安装示例形如 openclaw skills install ./skill-schema --as schema_skill。目录名随 Skill 变化，不要复制过期别名。

症状一：说了触发词，行为完全不像该 Skill

可能原因：装的是产品页 HTML；ZIP 解压后缺少 SKILL.md；--as 别名和你口头叫的名字不一致；列表里根本没有它。最小验证：看安装目录里是不是完整包（SKILL.md 加配套文件），再执行 openclaw skills list，核对别名。站点约定写得很死：网页 HTML 不能当作 Skill 文件，必须用 ZIP。修复：按该 Skill 产品页重新下载 packages 下的完整包，用文档里的 install 命令注册，再用只读小任务看它是否声明了自己的步骤。成功信号：列表出现预期别名，且回复里出现该 Skill 特有的输入检查，而不是通用闲聊。预防：把 ZIP 校验（产品页提供 manifest 与 SHA256）写进安装记录，不要用“另存网页”。

症状二：任务显示成功，文件却在另一个文件夹

可能原因：对话开始时的工作区不是项目目录；Skill 把输出写进默认家目录；你在资源管理器看的是旧路径。最小验证：先让 Agent 只输出将要写入的绝对路径，不执行写入。对照你的项目文件夹。修复：先 cd 到独立项目目录再调用 Skill，或在提示词里写死输入输出路径；不要授权它写到桌面以外的“看起来方便”的位置。成功信号：样本文件出现在你指定的目录，文件名和任务卡一致。这是 OpenClaw 相对图形化 Agent 更典型的坑——命令行成功不等于路径正确。

症状三：前几条很好，扩到全量就中断或质量塌

OpenClaw 营销 Skill 页建议先跑 5 至 10 条样本，确认格式再扩大。直接对几百个 URL 或整份关键词表，失败会停在一半，还留下半成品。最小验证：用同一提示词只跑样本，检查输出字段是否稳定。修复：样本不合格就改输入契约或换 Skill，不要加条数；全量跑之前冻结输出格式。成功信号：样本字段能对上任务卡，抽查事实能回到原始资料。产品页还提醒：前一个 Skill 的结果要能直接交给下一个，关键事实和链接已经核对。批量中断时，先保存已完成清单，再从未完成行续跑，不要从头覆盖。

症状四：一提就想写盘、删文件或外传

可能原因：提示词没写“只读”；Skill 声明需要网络或写目录，当前权限却一次性开太大；第三方 Skill 未在隔离目录试过。《OpenClaw是什么》写明：涉及删除、移动或外部上传时，应先看将执行的操作再批准；不要给含密钥和客户数据的目录授权。最小验证：把任务改写成“只列出将执行的命令，不要执行”。修复：收回写权限，先在隔离文件夹复现；需要联网下载 ZIP 时，只开下载所需权限。成功信号：只读报告能独立完成决策，写入单独走一次批准。预防：营销工作流里把“写盘 / 外传 / 发布”标成人工接管点，与本站自动发文审核文同一原则，只是对象从 CMS 换成了本地命令。

什么时候不该继续在 OpenClaw 里修

任务本质是点选网页后台、填在线表单，却要 OpenClaw 用命令行硬模拟——《OpenClaw是什么》已把它列为更适合 Workbuddy 的场景，继续排错是方向错误。需要从零写复杂集成代码，应评估 Claude Code 或 Codex，而不是把报错当“常见问题”堆在这里。Skill 触发和 YAML 格式这类跨 Agent 问题，走《Skill安装失败怎么排查》或《Skill触发不生效怎么办》，本文不重复那五层。

人工接管线和预防

出现即将删除、覆盖已发布内容、提交表单或推送外部 API 的命令，立刻停自动执行，改由人在可回滚环境操作。预防三件：每个项目一个工作目录；安装只用完整 ZIP；任何批量在样本通过前不得扩大。OpenClaw 适合把重复的文件和批处理变成可再跑的流程，前提是注册、路径和样本这三件事每次都可见。这三件可见了，大多数“OpenClaw 不好用”会变成可定位的配置问题，而不是 Agent 本身失效。