Skip to content
OpenClaw 书稿预览
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
总览
首页
V1 稳定稿
V2 重写稿
V1 书稿
全书目录大纲(v1)
内容合规与事实核验自检清单
写作风格与格式规范
V1 章节
第一篇:从 0 到 1(让读者今天就跑起来)
第1章 为什么是 OpenClaw
1.1 Agent 是什么(零基础版)
1.2 为什么“现在”变得可用
1.3 OpenClaw 到底是什么:一句话 + 三个关键词
1.4 本书怎么读:四条最短路径
1.5 版本冻结点与事实承诺(很重要)
第2章 10 分钟上手
2.1 运行环境检查
2.2 安装 OpenClaw(最短路径)
2.3 最小配置(模型 Key 与基础参数)
2.4 启动与第一次对话
2.5 10 分钟内最常见 5 个坑
第3章 OpenClaw 的心智模型
3.1 四个核心概念一句话
3.2 一张图讲清结构
3.3 一次请求的生命周期
3.4 Skills 为什么是生产力
3.5 Workspaces 的边界
第4章 安全第一
4.1 为什么 Agent 更需要最小权限
4.2 Key 与凭证管理
4.3 技能来源与供应链风险
4.4 执行审批与可视化确认
4.5 成本控制(费用/速率/上下文)
第二篇:把 OpenClaw 当成工具(稳定、可控、可维护)
第5章 配置与目录结构
5.1 配置的分层与优先级
5.2 目录结构与数据落盘
5.3 环境变量与敏感信息
5.4 多环境策略(家用/公司/云主机)
5.5 配置变更的验证方式
第6章 模型接入
6.1 模型与推理的基本概念
6.2 供应商选择原则
6.3 路由与回退(Failover)思路
6.4 Key 管理与泄露预防(进阶版)
6.5 模型侧故障排查
第7章 运维与升级
7.1 观测入口(日志/指标/事件)
7.2 健康检查与自测
7.3 升级策略(冻结点/变更记录)
7.4 备份与回滚预案
7.5 “坏的是模型还是配置”
第8章 Channels:飞书主线
8.1 Channels 的通用抽象
8.2 飞书(Feishu/Lark)接入
8.3 其他渠道入口(转补充章)
8.4 群聊/私聊/提及与路由
8.5 风控与可靠性
第三篇:Tools(工具)与 Skills(技能)才是生产力
第9章 工具与技能系统全解
9.1 Tools 与 Skills:是什么、不是什么
9.2 技能安装与启用
9.3 权限与执行边界
9.4 调试与日志
9.5 最小可用规范
第10章 写第一个技能
10.1 选题与边界
10.2 需求拆解(输入/输出/失败)
10.3 实现最小闭环
10.4 加入可靠性(幂等/重试/限流)
10.5 文档化与发布
第11章 Tools全景:OpenClaw能拿什么工具
11.1 Tools vs Skills:零件 vs 说明书
↳ 11.1.1 一个类比
↳ 11.1.2 实际例子
↳ 11.1.3 为什么需要区分
11.2 文件工具组
↳ 11.2.1 读取文件(read_file)
↳ 11.2.2 写入文件(write_file)
↳ 11.2.3 编辑文件(edit_file)
↳ 11.2.4 列出目录(list_directory)
11.3 命令工具组
↳ 11.3.1 执行命令(execute_command)
↳ 11.3.2 进程管理
11.4 Web工具组
↳ 11.4.1 网页搜索(search_web)
↳ 11.4.2 获取网页(fetch_url)
↳ 11.4.3 浏览器自动化
11.5 消息工具组
↳ 11.5.1 发送消息(send_message)
↳ 11.5.2 读取频道消息(read_channel)
11.6 新手最稳组合推荐
↳ 11.6.1 安全优先组合
↳ 11.6.2 开发助手组合
↳ 11.6.3 聊天机器人组合
第四篇:排障与进阶
第12章 使用现成Skills:从ClawHub安装
12.1 ClawHub是什么
↳ 12.1.1 类比理解
↳ 12.1.2 ClawHub的特点
↳ 12.1.3 ClawHub地址
12.2 搜索与安装
↳ 12.2.1 命令行搜索
↳ 12.2.2 查看详情
↳ 12.2.3 安装Skill
12.3 验证可用性
↳ 12.3.1 查看已安装Skills
↳ 12.3.2 检查Skills是否可用
↳ 12.3.3 查看Skill详情
12.4 第一个Skill:从安装到调用
↳ 12.4.1 安装示例Skill
↳ 12.4.2 调用Skill
↳ 12.4.3 查看执行结果
12.5 更新与卸载
↳ 12.5.1 更新Skills
↳ 12.5.2 卸载Skills
12.6 推荐Skills清单
↳ 12.6.1 生产力类
↳ 12.6.2 开发类
↳ 12.6.3 内容类
第13章 写第一个Skill:日报生成器
13.1 选题:为什么选择"日报生成"
↳ 13.1.1 好的第一个Skill的特点
↳ 13.1.2 我们要实现的功能
13.2 SKILL.md结构
↳ 13.2.1 文件位置
↳ 13.2.2 SKILL.md完整结构
↳ 13.2.3 Frontmatter字段说明
13.3 编写过程
↳ 13.3.1 Step 1:创建目录
↳ 13.3.2 Step 2:编写SKILL.md
↳ 13.3.3 Step 3:验证Skill
↳ 13.3.4 Step 4:测试Skill
13.4 测试与调试
↳ 13.4.1 常见问题
↳ 13.4.2 调试技巧
13.5 发布到ClawHub
↳ 13.5.1 准备发布
↳ 13.5.2 打包Skill
↳ 13.5.3 提交到ClawHub
↳ 13.5.4 审核流程
第14章 Skill进阶:让它稳定可靠
14.1 幂等性:重复执行不乱套
↳ 14.1.1 什么是幂等性
↳ 14.1.2 为什么重要
↳ 14.1.3 如何实现幂等性
14.2 错误处理:失败时给明确的下一步
↳ 14.2.1 错误处理原则
↳ 14.2.2 在Skill中处理错误
↳ 14.2.3 错误信息格式
14.3 超时与重试:别让卡住的调用拖死
↳ 14.3.1 设置超时
↳ 14.3.2 配置重试
↳ 14.3.3 重试策略
14.4 限流与降级:保护你的API额度
↳ 14.4.1 限流配置
↳ 14.4.2 降级策略
↳ 14.4.3 成本保护
14.5 文档与版本:CHANGELOG的重要性
↳ 14.5.1 版本号规范
↳ 14.5.2 CHANGELOG格式
↳ 14.5.3 文档要求
14.6 生产级Skill检查清单
第五篇:补充篇(全渠道速查)
第15章 排障手册:从现象到根因
15.1 排障方法论
↳ 15.1.1 核心口诀
↳ 15.1.2 排障流程图
↳ 15.1.3 诊断命令详解
15.2 安装问题排查
↳ 15.2.1 "command not found"
↳ 15.2.2 安装卡住/失败
↳ 15.2.3 Node版本不兼容
15.3 模型问题排查
↳ 15.3.1 401/403错误
↳ 15.3.2 模型响应慢/超时
↳ 15.3.3 "Model not found"
15.4 渠道问题排查
↳ 15.4.1 消息发出去没反应
↳ 15.4.2 飞书长连接失败
↳ 15.4.3 @机器人没反应
15.5 Skill问题排查
↳ 15.5.1 Skill不显示在列表
↳ 15.5.2 Skill运行失败
↳ 15.5.3 Skill依赖缺失
15.6 排障决策树
15.7 何时寻求帮助
V2 书稿
全书目录大纲(v2)
内容合规与事实核验自检清单(v2)
写作风格与格式规范(v2)
V2 章节
第一篇:入门(对应 wiki:入门)
第1章 WIKI 首页导读:先知道你要得到什么
1.1 OpenClaw 到底是什么
1.2 开始前你只需要准备三样
1.3 5 分钟结果导向:先看到它回你一句
1.4 架构图别硬啃:先看三块就够
1.5 本书阅读路线图(新手版)
第2章 快速开始(照抄就能跑)
2.1 环境检查:Node/npm/网络
2.2 安装 OpenClaw:最短路径
2.3 onboard:每一步到底在配什么
2.4 第一轮对话与结果验证
2.5 10 分钟排坑手册
第3章 核心概念(人话版)
3.1 Gateway/Agent/Session/Channel 一句话
3.2 Tools/Skills/Workspace 一句话
3.3 一条消息在系统里怎么走
3.4 为什么你懂概念后,排障会快很多
3.5 一图总览(记住就够用)
第4章 频道配置总览(先选再配)
4.1 渠道选择:先按场景,不要按热度
4.2 WebChat:零门槛体验通道
4.3 Discord:稳定入门线
4.4 飞书:本书主线渠道
4.5 路由与会话隔离
第二篇:配置(对应 wiki:配置)
第5章 高级配置(openclaw.json 看得懂改得对)
5.1 配置分层与优先级
5.2 关键字段最小解释
5.3 workspace 与 state 的区别
5.4 多环境配置(家用/公司/云)
5.5 改配置后的验收流程
第6章 模型接入与推理配置(国内读者优先)
6.1 provider/model 统一写法
6.2 MiniMax / Z.AI / Moonshot 选择策略
6.3 主备模型与自动回退
6.4 密钥轮换与失效处理
6.5 模型异常快速排查
第7章 安全指南(新手也能执行)
7.1 最小权限基线
7.2 私聊/群聊/白名单
7.3 凭证与敏感信息管理
7.4 工具审批与沙箱
7.5 成本与频率控制
第8章 飞书接入实战(截图版)
8.1 飞书开放平台准备
8.2 openclaw channels add 实操
8.3 发布与长连接订阅顺序
8.4 配对放行与消息闭环
8.5 高概率报错与修复
第三篇:Tools & Skills(对应 wiki:工具与技能)
第9章 Tools 全景图(先认识再上手)
9.1 Tools 与 Skills 的关系
9.2 常用工具组与典型用途
9.3 工具权限边界怎么收紧
9.4 工具日志怎么看
9.5 新手最稳组合
第10章 Skills 安装与第一个实战(从 0 到 1)
10.1 先安装再动手
10.2 选题与边界
10.3 最小闭环实现
10.4 幂等/重试/限流
10.5 发布与更新
第11章 Skills 工程化(从能用到稳用)
11.1 结构化 I/O 与可测试性
11.2 会话一致性与可回放
11.3 超时、降级与熔断
11.4 成本与频率控制
11.5 失败可解释体验设计
第四篇:进阶(对应 wiki:平台/部署/排障)
第12章 平台指南(macOS/iOS/Android/Canvas)
12.1 macOS App 能力
12.2 iOS/Android 节点接入
12.3 Canvas 能力
12.4 语音与系统工具
12.5 平台问题速查
第13章 部署与运维(本地到云主机)
13.1 部署形态怎么选
13.2 远程访问
13.3 服务守护与自启动
13.4 升级与回滚
13.5 日常维护清单
第14章 故障排查手册(从现象到根因)
14.1 五步诊断法
14.2 安装与启动问题
14.3 模型/渠道/权限问题
14.4 技能执行异常
14.5 重大故障应急流程
第五篇:补充章(速查与全渠道索引)
第15章 补充章:CLI 与全渠道速查
15.1 CLI 高频命令速查
15.2 内置渠道最小接入
15.3 插件渠道最小接入
15.4 通用排障顺序
15.5 官方文档索引
V3 主稿(v2026.2.17)
V3 书稿
OpenClaw 从入门到精通(V3版大纲)
V3版事实核验清单
V3版写作风格指南
V3 章节
第一部分:初识(读完这部分,你会说"原来如此")
第1章 3分钟搞懂:OpenClaw到底是什么
1.1 一句话解释:你的AI助理,住在你的电脑里
1.2 它能做什么:三个真实场景
↳ 1.2.1 场景一:自动整理日报(拯救打工人)
↳ 1.2.2 场景二:查资料写报告(研究员的福音)
↳ 1.2.3 场景三:飞书里@它办事(团队协作神器)
1.3 它不是什么:澄清常见误解
↳ 1.3.1 误解一:它是ChatGPT替代品
↳ 1.3.2 误解二:它是云端服务,数据存在别人服务器上
↳ 1.3.3 误解三:它会自己上网乱买东西、乱发邮件
1.4 为什么2026年它突然火了
↳ 1.4.1 原因一:大模型能力到了"可用"的临界点
↳ 1.4.2 原因二:工程化工具成熟了
↳ 1.4.3 原因三:从"玩具"到"工具"的转变
1.5 阅读路线图:三种读者的最短路径
↳ 1.5.1 路径A:我只想快速用起来(推荐所有人先走这条)
↳ 1.5.2 路径B:我想深度定制,让它做特定任务
↳ 1.5.3 路径C:我是技术用户,想部署到服务器
第2章 准备工作:你只需要这三样东西
2.1 别慌,你只需要这三样东西
2.2 第一样东西:一台电脑
↳ 2.2.1 系统要求
↳ 2.2.2 网络要求
2.3 第二样东西:一个API Key
↳ 2.3.1 API Key是什么?
↳ 2.3.2 国内三家Coding Plan(推荐)
• 2.3.2.1 方案A:KIMI Coding Plan(推荐)
• 2.3.2.2 方案B:MiniMax Coding Plan(推荐)
• 2.3.2.3 方案C:GLM Coding Plan(推荐)
↳ 2.3.3 三家对比表
↳ 2.3.4 备选方案
• 2.3.4.1 OpenRouter
• 2.3.4.2 Anthropic(Claude官方)
2.4 第三样东西:10分钟时间
2.5 提前看看你会得到什么
第二部分:跑起来(读完这部分,你已经能跟AI对话了)
第3章 5分钟安装:照着点就行
3.1 环境检查:Node.js是什么?
↳ 3.1.1 Node.js简介
↳ 3.1.2 检查Node.js版本
↳ 3.1.3 如果Node.js不符合要求
↳ 3.1.4 验证安装
3.2 安装命令:就一行,复制粘贴
↳ 3.2.1 验证安装成功
3.3 运行向导:openclaw onboard
↳ 3.3.1 向导第一步:选择配置方式
↳ 3.3.2 向导第二步:配置模型
↳ 3.3.3 向导第三步:配置Channel(先Skip!)
↳ 3.3.4 向导第四步:确认配置
↳ 3.3.5 向导第五步:启动Gateway
3.4 验证成功:看到Web UI长什么样
3.5 发第一条消息:"你好,请介绍一下你自己"
3.6 如果出错了怎么办
↳ 3.6.1 问题一:Gateway启动失败
↳ 3.6.2 问题二:发送消息无回复
↳ 3.6.3 问题三:Web UI打不开
第4章 10分钟排坑:当事情不顺利时
4.1 排障方法论:别慌,按步骤来
4.2 问题一:"command not found"
↳ 4.2.1 一眼症状
↳ 4.2.2 可能原因
↳ 4.2.3 解决动作
4.3 问题二:端口被占用
↳ 4.3.1 一眼症状
↳ 4.3.2 可能原因
↳ 4.3.3 解决动作
4.4 问题三:401/403错误
↳ 4.4.1 一眼症状
↳ 4.4.2 可能原因
↳ 4.4.3 解决动作
4.5 问题四:页面打开但不出回复
↳ 4.5.1 一眼症状
↳ 4.5.2 可能原因
↳ 4.5.3 解决动作
4.6 问题五:Windows用户的特殊注意事项
↳ 4.6.1 推荐方案:使用WSL2
↳ 4.6.2 如果一定要在Windows原生环境运行
4.7 排障决策树
4.8 什么时候该求助
第三部分:接上飞书(读完这部分,你在公司里能@AI干活了)
第5章 飞书接入:从0到能@机器人
5.1 为什么第3章让你先Skip Channel
5.2 飞书接入的整体流程
5.3 阶段一:飞书私聊机器人(降低复杂度)
5.4 Step 1:在飞书开放平台创建应用
↳ 5.4.1 打开平台并创建企业应用
↳ 5.4.2 获取App ID与App Secret
↳ 5.4.3 权限配置(批量导入)
↳ 5.4.4 启用Bot能力
↳ 5.4.5 首次发布应用(⚠️ 关键步骤!)
5.5 Step 2:在OpenClaw配置飞书
↳ 5.5.1 启用飞书插件
↳ 5.5.2 交互式添加Channel
↳ 5.5.3 验证配置
5.6 Step 3:开启事件订阅(长连接)
↳ 5.6.1 关键时序(⚠️ 血的教训)
↳ 5.6.2 启动Gateway
↳ 5.6.3 在飞书平台开启事件订阅
↳ 5.6.4 添加事件订阅
5.7 Step 4:配对与放行
↳ 5.7.1 私聊机器人触发配对
↳ 5.7.2 在OpenClaw查看配对请求
↳ 5.7.3 批准配对
↳ 5.7.4 验证私聊
5.8 Step 5:开启群聊(可选)
↳ 5.8.1 修改Channel配置
↳ 5.8.2 把机器人拉进群
↳ 5.8.3 群里@机器人测试
5.9 验收清单
第6章 飞书进阶:别让它乱回消息
6.1 为什么需要安全配置
6.2 私聊策略:谁能和机器人说话
↳ 6.2.1 策略一:pairing(推荐)
↳ 6.2.2 策略二:allowlist
↳ 6.2.3 策略三:open(不推荐)
6.3 群聊策略:别让它乱回消息
↳ 6.3.1 requireMention:群聊的保险栓
↳ 6.3.2 群聊白名单:谁能拉机器人进群
6.4 风控checklist:上线前的5个检查项
↳ 6.4.1 Checklist
↳ 6.4.2 设置预算上限
↳ 6.4.3 限制高风险工具
6.5 常见问题排查
↳ 6.5.1 问题一:长连接订阅失败
↳ 6.5.2 问题二:消息发出去,机器人没反应
↳ 6.5.3 问题三:@机器人没反应
↳ 6.5.4 问题四:机器人回复很慢
↳ 6.5.5 问题五:机器人乱回消息
6.6 安全配置最佳实践
↳ 6.6.1 企业级部署建议
↳ 6.6.2 个人使用建议
第四部分:配置深入(读完这部分,你知道怎么调教它了)
第7章 模型配置:KIMI、MiniMax、GLM怎么选
7.1 三家对比:能力、速度、成本、稳定性
↳ 7.1.1 快速对比表
↳ 7.1.2 我的建议
7.2 KIMI Coding Plan配置
↳ 7.2.1 获取API Key
↳ 7.2.2 在OpenClaw配置KIMI
↳ 7.2.3 KIMI可用模型
7.3 MiniMax Coding Plan配置
↳ 7.3.1 获取API Key
↳ 7.3.2 在OpenClaw配置MiniMax
↳ 7.3.3 MiniMax可用模型
7.4 GLM Coding Plan配置
↳ 7.4.1 获取API Key
↳ 7.4.2 在OpenClaw配置GLM
↳ 7.4.3 GLM可用模型
7.5 模型切换与回退
↳ 7.5.1 配置主模型和备用模型
↳ 7.5.2 动态切换模型
7.6 成本监控
↳ 7.6.1 设置预算上限
↳ 7.6.2 查看使用统计
↳ 7.6.3 成本控制技巧
第8章 配置文件:openclaw.json解剖
8.1 配置文件在哪里
↳ 8.1.1 配置文件路径
↳ 8.1.2 如何编辑
8.2 配置分层:优先级规则
↳ 8.2.1 示例
8.3 关键字段详解
↳ 8.3.1 gateway:网关配置
↳ 8.3.2 models:模型配置
↳ 8.3.3 agents:智能体配置
↳ 8.3.4 channels:渠道配置
8.4 多环境配置
↳ 8.4.1 场景:家用/公司/云主机
↳ 8.4.2 方案:使用Workspace配置
8.5 修改后的验证
↳ 8.5.1 验证配置语法
↳ 8.5.2 查看生效配置
↳ 8.5.3 测试配置
↳ 8.5.4 回滚配置
第9章 安全第一:权限与沙箱
9.1 为什么Agent更需要最小权限
↳ 9.1.1 一个假设场景
↳ 9.1.2 最小权限原则
9.2 工具权限配置
↳ 9.2.1 三种配置方式
↳ 9.2.2 profile详解
↳ 9.2.3 常见工具清单
9.3 执行审批:高风险动作的二次确认
↳ 9.3.1 配置审批策略
↳ 9.3.2 审批命令
↳ 9.3.3 审批通知
9.4 沙箱配置
↳ 9.4.1 什么是沙箱
↳ 9.4.2 三种沙箱模式
↳ 9.4.3 沙箱路径配置
9.5 凭证管理
↳ 9.5.1 API Key存储
↳ 9.5.2 使用环境变量
↳ 9.5.3 使用系统密钥管理器
9.6 成本控制
↳ 9.6.1 预算上限
↳ 9.6.2 频率限制
↳ 9.6.3 成本监控
第五部分:Tools与Skills(读完这部分,它能帮你干活了)
第10章 Tools全景:OpenClaw能拿什么工具
10.1 Tools vs Skills:零件 vs 说明书
10.2 文件工具组
10.3 命令工具组
10.4 Web工具组
10.5 消息工具组
10.6 新手最稳组合推荐
第11章 使用现成Skills:从ClawHub安装
11.1 ClawHub是什么
11.2 搜索与安装
11.3 验证可用性
11.4 第一个Skill
11.5 更新与卸载
第12章 写第一个Skill:日报生成器
12.1 选题
12.2 SKILL.md结构
12.3 编写过程
12.4 测试与调试
12.5 发布到ClawHub
第13章 Skill进阶:让它稳定可靠
13.1 幂等性
13.2 错误处理
13.3 超时与重试
13.4 限流与降级
13.5 文档与版本
第六部分:进阶与排障(读完这部分,你能自己解决问题了)
第14章 排障手册:从现象到根因
14.1 排障方法论
14.2 安装问题
14.3 模型问题
14.4 渠道问题
14.5 Skill问题
第15章 多Workspace与多Agent
15.1 什么时候需要拆分Workspace
↳ 15.1.1 什么是Workspace
↳ 15.1.2 拆分Workspace的场景
↳ 15.1.3 不拆分的场景
15.2 多Agent的配置与路由
↳ 15.2.1 什么是多Agent
↳ 15.2.2 配置多个Agent
↳ 15.2.3 Agent路由
15.3 Session隔离策略
↳ 15.3.1 什么是Session
↳ 15.3.2 Session隔离级别
↳ 15.3.3 Session持久化
15.4 反模式:过度拆分的问题
↳ 15.4.1 反模式1:每个项目都新建Workspace
↳ 15.4.2 反模式2:Agent划分过细
↳ 15.4.3 反模式3:过度隔离
↳ 15.4.4 最佳实践总结
第16章 部署与运维:从本地到服务器
16.1 本地 vs 云主机
↳ 16.1.1 什么时候需要上云
↳ 16.1.2 选择建议
↳ 16.1.3 云主机选择
16.2 远程访问方案
↳ 16.2.1 方案A:Tailscale(推荐)
↳ 16.2.2 方案B:SSH隧道
↳ 16.2.3 方案C:公网访问(谨慎!)
16.3 服务守护配置
↳ 16.3.1 Linux(systemd)
↳ 16.3.2 macOS(LaunchAgent)
16.4 备份与恢复
↳ 16.4.1 需要备份的内容
↳ 16.4.2 备份脚本
↳ 16.4.3 自动备份(cron)
↳ 16.4.4 恢复
16.5 升级策略
↳ 16.5.1 升级前检查
↳ 16.5.2 升级步骤
↳ 16.5.3 回滚
↳ 16.5.4 自动升级(谨慎!)
第七部分:附录(速查与索引)
附录A CLI命令速查
附录B 配置文件完整示例
附录C 官方资源索引
附录D 版本冻结点记录
GitHub
Select theme
Dark
Light
Auto
V1 稳定稿
V1 稳定稿
Section titled “V1 稳定稿”
这是当前稳定版书稿(原有 draft),用于对照与回溯。
目录大纲
写作规范
自检清单
继续阅读章节请使用左侧
V1 章节
导航。