OpenClawGuide — Development skill for Claude Code

OpenClaw 2.0 实战蓝皮书

[](./LICENSE) [](./docs/bluebook/index.md)

一本以**真实任务为主线**的 OpenClaw 中文实战读本。

它不打算做功能说明书，只回答一个问题：**你手上有件事，怎么让 OpenClaw 替你把它做完，而且做完是能验收的。**

本书由社区维护，**不是 OpenClaw 官方出品**。命令与能力边界以你机器上 `openclaw --help` 为准。

---

这本书适合谁

• 刚装好 OpenClaw、不确定第一件事该让它干什么的人；
• 已经会让它跑简单任务，但一碰到「要连着做好几步」就翻车的人；
• 想把重复操作固化下来，交给它定时跑的人；
• 需要判断「这件事到底该不该交给 Agent」的团队负责人。

不太适合：想查完整参数列表的人（请直接看官方 CLI 帮助）。

---

内容地图（37 章）

篇	内容	章数
第一篇 · 使用手册	先把 OpenClaw 跑起来：安装、核心概念、接聊天工具、选模型、Skill、MCP、定时任务、安全边界	10
第二篇 · 入门篇	从一些小事开始：整理目录、材料变文档、每日简报、手机上接活、找文件、固化重复操作	6
第三篇 · 场景篇	放进真实工作：开发者 / 运维 / 数据 / 研究写作 / 内容与日常，共 5 组场景	15
第四篇 · 进阶篇	把案例变成自己的执行系统：Skill 编写、多 Agent 编排、沙箱与后端、自动化可靠性、记忆治理	4
第五篇 · 岗位与行业落地	岗位路线图与团队落地：信任边界、角色分工、验收标准	2

另有**附录 A（常用指令模板）**、**附录 B（场景速查表）**，以及 **3 个社区案例**（开发者 / 运维 / 数据抓取）。

不知道从哪读起？看 [`docs/reading-guide.md`](./docs/reading-guide.md)，里面给了三条路线： 「只想赶紧用起来」「照着场景抄」「想把团队也带上」。

---

每章长什么样

固定六件套，翻到任何一章结构都一样：

1. 这个场景的痛点
2. 适合交给 OpenClaw 的任务（以及不该交给它的）
3. 推荐流程（每步配图）
4. 提示词示例——六要素齐全，可直接复制
5. 进阶实战
6. 常见错误与修正方式（表格）

**提示词六要素**：目标 / 输入 / 动作 / 约束 / 输出 / 验收，末尾统一带一句红线：

在我确认前，不执行不可逆操作。

---

本地跑起来

需要 Node.js 20~24。

npm install
npm run dev        # 本地预览 http://127.0.0.1:5173
npm run build      # 构建，产出 docs/.vitepress/dist

技术栈是 **VitePress**：SEO 友好、中文全文搜索、Markdown 写作、侧边栏自动扫描（加一章不用改代码）。

---

目录结构

OpenClawGuide/
├─ docs/
│  ├─ .vitepress/
│  │  ├─ book.config.mts      # 改书名/产品名/域名/仓库，只动这里
│  │  ├─ config.mts           # 通用 VitePress 配置
│  │  └─ sidebar.ts           # 自动扫描生成侧边栏
│  ├─ bluebook/               # 正文：篇 → 章 → index.md + assets/
│  ├─ cases/submissions/      # 社区投稿案例
│  └─ facts.md                # 术语与事实基线
├─ templates/                 # 章节 / 篇导读 / 案例 写作模板
├─ scripts/
├─ BLUEBOOK-PLAYBOOK.md       # 配方：这本书是怎么搭起来的
├─ QUALITY-REVIEW.md          # 质量对照（橙皮书基准）
└