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
V2 重写稿
V2 重写稿
Section titled “V2 重写稿”
这是面向普通小白读者的全新重写版本。
目标是:更通俗、更好读、更接地气,同时保留技术准确性。
目录大纲
写作规范
自检清单
说明:V2 正在持续重写,未完成章节会暂时沿用 V1 内容作为占位,完成后逐章替换。