第十一章 避坑指南

一、新手 8 大坑

坑 1：一上来就追求"全自动"

典型表现：刚装上 OpenClaw 就想"让它每天自动给老板发周报"。

为什么是坑：

• 你还没掌握工具的脾气；
• AI 偶尔会"一本正经地胡说"，没经过审核就发出去会出大事；
• 反馈链路太长，错了你都不知道哪里错。

正确做法：从"半自动 + 人工 checkpoint"开始。

第 1 周：让 OpenClaw 起草 → 我看 → 我改 → 我发
第 2 周：让 OpenClaw 起草 → 我看一眼 → 直接发（80% 通过）
第 3 周：让 OpenClaw 起草 → 推送审批按钮 → 我点 OK → 自动发
第 4 周+：稳定的部分全自动，新加的功能从第 1 周开始

坑 2：不画流程图直接堆功能

典型表现：一个工作流写到 200 行 YAML，一报错根本不知道哪里错。

正确做法：动手写工作流前，先在纸上画 5 分钟：

[触发] 每天早 8 点
   ↓
[抓数据] 天气 / 邮件 / 日历 / 新闻 ← 哪个失败了能否跳过？
   ↓
[汇总] LLM 写早报          ← 字数限制？格式要求？
   ↓
[判断] 早报里有没有"待办"  ← 有的话怎么处理？
   ↓
[输出] 微信推送 + 存档     ← 推送失败怎么办？

写完代码再 dry-run 三遍。

坑 3：没有"人工兜底"就发到外部

典型表现：让 AI 自动回复客户邮件，结果客户收到了"作为一个大语言模型，我无法……"开头的乱七八糟文字。

正确做法：所有"会发到外部世界"的动作都加 confirm: true 或 approval-flow。哪怕只是看一眼"标题 + 前两行"，也比直接发出去好。

坑 4：上下文堆爆

典型表现：

• 把整个项目目录全塞进提示词
• 把 100 封邮件全文都丢给模型
• 一段对话进行了 50 轮还在继续

为什么是坑：

• 上下文超出模型窗口会被截断，模型"看不到开头"；
• 每多一个 token 都要钱；
• 信噪比降低，模型注意力变差。

正确做法：

坑 5：提示词写太长、太抽象

典型表现：写了 2000 字提示词，结果出来的还不如 200 字简洁版。

正确做法：

• 单段提示词 < 500 字；
• 角色 / 任务 / 约束 / 格式分段写；
• 把"长背景"挪到 memory 或 CONTEXT.md，不要塞在提示词里；
• 把"重复要求"放在最后一行（位置偏差会让模型更重视）。

坑 6：用错模型导致烧钱

典型表现：用 Claude Opus 4.7 跑"翻译这一句话"，一个月烧了 200 美元。

正确做法：参考 第三章 的"主大脑 + 廉价副脑"。

省钱口诀：能便宜就便宜，必须贵才贵。

坑 7：不做复盘

典型表现：工作流跑了 3 个月，从来没看过它的运行日志。

正确做法：每周留 30 分钟做"工作流复盘"：

• openclaw workflow stats --since 7d 看本周哪些跑得多、哪些没跑
• 失败率 > 5% 的工作流：要么修，要么删
• 成本 > 自己预算的工作流：换模型或降频
• 已经一个月没用过的工作流：删

坑 8：装来历不明的 Skill

典型表现：随便搜个"自动签到"Skill 装上，一周后发现 API Key 被偷。

正确做法：参考 第五章 的"7 问安全清单"，少于 5 个 Yes 就不要装。装之前一定跑：

clawhub audit <skill-name>

二、常见报错对照表

安装与启动

模型相关

Skill 相关

工作流相关

MCP / 集成相关

云端 / 同步相关

记忆与上下文相关

安全 / 提示注入相关

三、快速诊断命令

按这个顺序跑一遍，几乎所有问题都能定位：

# 1. 基础健康检查
openclaw status

# 2. 看版本
openclaw -v

# 3. 看模型是否通
openclaw models test deepseek/deepseek-chat

# 4. 看权限是否合理
openclaw security audit

# 5. 看最近的错误
openclaw logs --level error --since 1h

# 6. 看资源占用
openclaw stats

# 7. 完整诊断（一键打包）
openclaw doctor

openclaw doctor 会打包成 ~/.openclaw/diagnose-<timestamp>.tar.gz，去社区提 Issue 时直接附上，专家几乎立刻能帮你看。

四、性能调优清单

让 OpenClaw 自身跑得快

{
  "performance": {
    "max_concurrent_tasks": 3,        // 默认 5，电脑性能一般就调 3
    "cache_enabled": true,             // 缓存模型响应
    "cache_ttl_seconds": 3600,
    "stream_responses": true,          // 启用流式输出，体感更快
    "preload_skills": ["browser-pilot", "gmail-assistant"]   // 预加载常用
  }
}

让模型推理快

让工作流跑得快

# 串行 → 并行
steps:
  parallel:
    - task1
    - task2
    - task3

让本地大模型跑得快

• macOS：装 Apple Silicon 优化版的 Ollama，速度提升 3-5 倍
• Linux/Windows：装 CUDA 驱动，让 GPU 接管推理
• 选量化版本：qwen3:32b-q4 比 qwen3:32b 占用内存少一半，速度快近 2 倍

五、成本调优清单

月度成本预算建议

把成本降下来的 7 招

1. 能用便宜模型就用便宜的（参考第三章组合）

2. 缓存重复请求：相同提示词一小时内复用结果

3. 截断历史对话：长对话只保留最近 5 轮

4. 用子代理：把"体力活"分给便宜模型

5. 关掉无用工作流：用 openclaw workflow disable <name>

6. 设月度预算告警：

   name: cost-alert
   schedule: "0 12 * * *"
   steps:
     - { skill: openclaw-stats, args: { since: "this-month" }, output: stats }
     - if: "{{stats.total_cost > 50}}"
       then:
         - { skill: notify-bridge, args: { content: "本月已消耗 ¥{{stats.total_cost}}，请关注" } }
   

7. 本地化重复任务：每天跑 1000 次的简单分类，干脆用 Ollama 本地 Qwen3-8b，零成本

看本月花了多少钱

openclaw stats --cost --since 2026-04-01

输出：

Provider       Calls    Tokens         Cost
─────────────  ─────    ──────────     ─────
deepseek       2,148    8,432,109      ¥9.27
anthropic        134      856,222      ¥18.40
openai            42      245,809      ¥4.21
google            12       54,120      ¥0.31

Total                                  ¥32.19

按 Skill / 工作流分组：

openclaw stats --cost --group-by workflow --since 30d

六、何时该寻求"人工兜底"

不是所有事 AI 都能处理。下列场景永远留人工：

设置策略：

{
  "permissions": {
    "purchase": "ask",
    "send_email_to_external": "ask",
    "delete_file": "ask",
    "git_push": "ask",
    "post_social_media": "ask"
  }
}

七、何时该把 AI 关掉

是的，有时候最好的策略是不用 AI：

• 5 秒能完成的事（比直接做还慢）
• 需要原创性 / 灵感（AI 给的永远是中位数水平）
• 你正在学习（让 AI 替你做你就学不会了）
• 你心情不好需要发泄（让 AI 写充满怨气的邮件，可能后悔）

工具是工具，分清楚什么时候用、什么时候放下。

八、复盘模板：每周 30 分钟做一次

把这段贴进你的 Notion / 飞书：

# 第 X 周 OpenClaw 复盘

## 1. 本周花了多少钱
- 总成本：¥
- 单价最贵的工作流：

## 2. 本周哪些任务节省了我的时间
- 任务 A：节省约 X 小时
- 任务 B：节省约 X 小时
- 总计：X 小时

## 3. 本周翻车 / 不满意的
- 翻车 1：（什么场景，错在哪里，下周怎么改）
- 翻车 2：

## 4. 本周新尝试的
- 新装的 Skill：
- 新建的工作流：
- 新优化的提示词：

## 5. 下周要做的
- [ ] 优化哪个工作流
- [ ] 删掉哪个不用的
- [ ] 试哪个新场景

本章一图回顾

              新手避坑导航
        ┌──────────────────────────┐
        │ 第 1 周：手动 + 半自动      │
        │   ↓                        │
        │ 第 2 周：起草 + 我审 + 我发│
        │   ↓                        │
        │ 第 3 周：起草 + 推送审批    │
        │   ↓                        │
        │ 第 4 周：稳定部分全自动     │
        │   ↓                        │
        │ 永远做的：                  │
        │   - 流程图先于代码          │
        │   - 高危操作必须 ask        │
        │   - 每周 30 分钟复盘        │
        │   - 每月 security audit     │
        └──────────────────────────┘

下章预告

读到这里，你已经是 OpenClaw 的"中阶老用户"。下一章 第十二章 从用户到创造者 我们带你迈向最后一步——自己写 Skill、发布到 Claw Hub、加入开源社区，甚至把 AI 自动化做成副业。