OpenClaw从入门到精通:零基础打造全能AI助理电子书

前言

基础篇

第1章 CHAPTER 1 认识OpenClaw：定义、能力边界与阅读路径

1.1 定义：住在你计算机中的AI助理

1.1.1 OpenClaw到底是什么

1.1.2 OpenClaw基本结构

1.2 典型使用场景

1.2.1 场景1：自动整理日报

1.2.2 场景2：资料搜集与报告生成

1.2.3 场景3：团队即时协作

1.3 能力边界：3个常见误解

1.3.1 误解1：OpenClaw是ChatGPT的替代品

1.3.2 误解2：数据存储在第三方服务器上

1.3.3 误解3：Agent会自行发起有风险的操作

1.4 AI Agent的发展趋势和本书的阅读路径

1.4.1 大语言模型能力达到实用水平

1.4.2 工程化工具趋于成熟

1.4.3 实际工作价值得到验证

1.4.4 阅读路径：3种起点的建议顺序

1.5 动手试试

第2章 CHAPTER 2 安装：从准备工作到问题排查

2.1 准备工作

2.1.1 系统要求

2.1.2 网络要求

2.1.3 什么是API Key

2.1.4 获取国内主流大语言模型供应商的API Key

2.1.5 API Key的保管建议

2.2 环境检查与安装

2.2.1 Node.js检查与安装

2.2.2 安装OpenClaw

2.2.3 验证安装结果

2.3 运行初始化向导

2.3.1 启动向导

2.3.2 初始化向导的10个步骤

2.3.3 daemon安装失败问题分析和解决方案

2.3.4 记录关键信息

2.3.5 完成首次冷启动对话

2.4 常见问题排查

2.4.1 command not found错误

2.4.2 权限问题

2.4.3 端口被占用

2.4.4 网络问题

2.4.5 401/403错误

2.4.6 界面正常但Agent无响应

2.4.7 Windows用户的特别说明

2.4.8 排障决策树

2.5 动手试试

第3章 CHAPTER 3 运行逻辑解析

3.1 组件协作关系

3.2 一次请求如何被处理

3.2.1 一次请求的生命周期（逐步拆解）

3.2.2 纯聊天AI和带Skills的Agent的差别

3.3 Workspace的边界

3.3.1 Workspace的拆分边界

3.3.2 Session、Agent与Workspace的职责边界

3.4 动手试试

第4章 CHAPTER 4 接入飞书：从单机版到在线协作版的跨越

4.1 飞书接入的整体流程

4.1.1 接入的4个阶段

4.1.2 为什么要按这个顺序执行

4.2 4个阶段的落地操作

4.2.1 平台侧准备

4.2.2 本地配置与启动

4.2.3 接入验证与建立连接

4.2.4 安全配置：私聊策略与群聊策略

4.3 常见问题排查

4.3.1 长连接订阅失败

4.3.2 消息无响应

4.3.3 机器人出现非预期回复

4.4 动手试试

进阶篇

第5章 CHAPTER 5 配置管理

5.1 目录结构与日志

5.1.1 ～/.openclaw目录结构

5.1.2 日志

5.2 配置文件路径、查看和编辑

5.2.1 主配置文件路径

5.2.2 如何查看和编辑

5.3 配置的分层与优先级

5.3.1 实例演示

5.3.2 查看当前生效的配置

5.4 环境变量与敏感信息管理

5.4.1 不要做的事

5.4.2 推荐做法

5.4.3 泄露的应对方法

5.5 多环境配置策略

5.5.1 家用

5.5.2 公司/专业开发

5.5.3 云主机/团队共享

5.6 配置变更的验证方式

5.6.1 标准验证流程

5.6.2 配置出错时快速回滚

5.7 动手试试

第6章 CHAPTER 6 模型管理

6.1 选择模型与接入策略

6.1.1 先选哪一家

6.1.2 接入策略

6.2 最小可用模型的接入

6.2.1 Kimi

6.2.2 MiniMax

6.2.3 GLM

6.3 主/备模型设置与动态切换

6.3.1 主/备模型设置

6.3.2 动态切换模型

6.4 模型配置常见误区

6.5 动手试试

第7章 CHAPTER 7 安全配置：权限、审批与凭证管理

7.1 Agent最小权限原则与工具权限配置

7.1.1 Agent最小权限原则

7.1.2 工具权限配置

7.2 审批策略与流程

7.2.1 配置审批策略

7.2.2 审批流程

7.3 沙箱配置

7.3.1 理解3个核心字段

7.3.2 沙箱配置示例

7.4 凭证管理进阶

7.4.1 使用环境变量

7.4.2 使用SecretRef

7.5 安全配置最佳实践

7.5.1 企业级安全组合原则

7.5.2 个人使用安全原则

7.6 动手试试

第8章 CHAPTER 8 工具与Skills入门及应用

8.1 Tools与Skills的分工

8.2 工具组

8.2.1 工具组概念

8.2.2 常用官方工具组总览

8.2.3 PDF分析工具

8.3 高风险工具安全使用

8.3.1 exec

8.3.2 process管理

8.3.3 elevated权限

8.4 设置提供商权限

8.5 Skills的基本结构

8.6 Skills注册、安装与管理

8.6.1 安装ClawHub CLI

8.6.2 搜索Skills

8.6.3 更新与同步

8.6.4 版本管理

8.7 Skills加载优先级与运行期配置

8.7.1 加载顺序

8.7.2 skills.entries运行期配置

8.7.3 上线前可用性检查

8.7.4 可用性门控与生效规则

8.8 编写第一个Skills：日报生成器

8.8.1 创建目录并编写SKILL.md

8.8.2 验证与测试Skills

8.9 Skills发布与维护

8.9.1 准备并发布到ClawHub

8.9.2 后续维护

8.9.3 让Skills稳定可靠

8.10 动手试试

第9章 CHAPTER 9 运维管理

9.1 多Workspace、多Agent与运行环境的维护

9.1.1 多Workspace与多Agent

9.1.2 远程访问

9.1.3 服务维护策略

9.2 社区资产管理

9.2.1 使用的优先级

9.2.2 评估与隔离

9.3 隐私、合规与变化应对

9.3.1 隐私与合规底线

9.3.2 变化应对

9.4 Channel的维护

9.4.1 Telegram

9.4.2 Discord

9.4.3 Slack

9.4.4 Google Chat

9.4.5 其他内置Channel

9.4.6 Channel插件的最小运维动作

9.5 动手试试

附录

附录A APPENDIX A CLI命令速查

A.1 最常用的诊断命令

A.2 安装、升级与初始化

A.3 Gateway网关管理

A.4 配置与模型

A.5 Channel与配对

A.6 Skills、插件与Agent

A.7 安全与审批

A.8 会话与重置（慎用）

附录B APPENDIX B 配置文件完整示例

B.1 先记住配置位置

B.2 模板1：单人最小可运行配置

B.3 模板2：个人开发常用（可写代码，但有护栏）

B.4 模板3：双Agent分流（工作/个人）

B.5 修改配置的稳妥流程（建议优先阅读）

B.6 回滚配置（出现问题时使用）

附录C APPENDIX C 官方资源索引

C.1 OpenClaw官方入口

C.2 高频使用的文档入口

C.3 国内模型厂商入口（本书常用）

C.4 常用基础工具