# openclaw-cn
**Repository Path**: civil-engineering-cloud/openclaw-cn
## Basic Information
- **Project Name**: openclaw-cn
- **Description**: OpenClaw 中文完整教程 | AI Agent 部署与实战
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-04-01
- **Last Updated**: 2026-05-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# OpenClaw 中文教程
> OpenClaw 中文完整教程 | AI Agent 部署与实战 | 飞书·企微·钉钉集成 | Skills 扩展 | 从安装到高级应用 | 15 章正文 + 15 附录 | 70+ 实战案例 | Claude Code v2.1.88 源码泄露解读
[](https://github.com/xianyu110/awesome-openclaw-tutorial)
[](https://github.com/xianyu110/awesome-openclaw-tutorial)
[](LICENSE)
[](https://github.com/xianyu110/awesome-openclaw-tutorial)
[](docs/00-getting-started/PROJECT-SUMMARY.md)
---
## 📁 项目结构
```
cec-openclaw-tutorial/
├── docs/ # 教程文档
│ ├── 00-getting-started/ # 入门指南（一键部署、快速上手）
│ ├── 01-basics/ # 第一部分：零基础入门
│ ├── 02-core-features/ # 第二部分：核心功能
│ ├── 03-advanced/ # 第三部分：进阶技能
│ ├── 04-practical-cases/ # 第四部分：实战案例
│ ├── _site/ # 构建输出文件（搜索索引等）
│ └── images/ # 文档共用图片
├── appendix/ # 附录（命令参考、配置模板、FAQ等）
├── examples/ # 配置示例和实战代码
│ ├── configs/ # JSON 配置文件
│ ├── automation/ # 自动化脚本示例
│ └── skills/ # Skills 代码示例
├── scripts/ # 工具脚本
│ ├── publish/ # CSDN/公众号发布脚本
│ ├── check-*.sh # 内容检查脚本
│ ├── fix-*.sh # 格式修复脚本
│ └── generate_*.py # 内容生成脚本
├── updates/ # 版本更新记录
├── README.md # 项目说明
└── LICENSE # GPL-3.0 许可证
```
---
## 🚀 30秒快速选择：哪种部署方式适合你？
| 你的情况 | 推荐方案 | 为什么 | 开始时间 |
|---------|---------|------|---------|
| **完全小白，想最快体验** | [**飞书妙搭**](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md#1飞书妙搭-openclaw--强烈推荐) ⭐ | **免费** + **1分钟完成** + **每日100万Tokens** | → 立即开始 |
| **有服务器，想可视化管理** | [**宝塔面板**](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md#11宝塔面板-openclaw) | **免费插件** + **面板管理** + **一键安装** | → 3分钟搞定 |
| **企业级，需要高安全性** | [**JVSClaw**](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md#10jvsclaw阿里云无影) | **14天免费** + **6核12GB** + **端到端加密** | → 需邀请码 |
| **想用浏览器操控** | [Kimi Claw](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md#3kimi-openclaw) | **Kimi K2.5** + **浏览器控制** | → 200元/月 |
| **量化交易/多IM** | [腾讯 WorkBuddy](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md#4腾讯-openclawworkbuddy) | **桌面端Agent** + **多IM支持** | → 送5000积分 |
| **Agent生态丰富** | [扣子 OpenClaw](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md#2扣子-openclaw) | **1800+Skills** | → 99元/月起 |
📖 **[查看完整一键部署教程 →](docs/00-getting-started/Openclaw史上最简单教程，小白一键部署.md)**
---
## 📊 教程导航（按学习路径）
### 🎯 零基础入门（必读）
- 📖 [第1章：认识OpenClaw](docs/01-basics/01-introduction.md) - 5分钟了解核心价值
- 🚀 [第2章：快速部署](docs/01-basics/02-installation.md) - 选择适合你的部署方式
- 💬 [第3章：快速上手](docs/01-basics/03-quick-start.md) - 发送第一条消息
### 🔥 核心功能（实战）
- 📁 [第4章：文件管理](docs/02-core-features/04-file-management.md) - 效率提升81%
- 🧠 [第5章：知识库](docs/02-core-features/05-knowledge-management.md) - 第二大脑系统
- 📅 [第6章：日程管理](docs/02-core-features/06-schedule-management.md) - AI自动创建日程
- ⚙️ [第7章：自动化](docs/02-core-features/07-automation-workflow.md) - 24小时为你工作
### 💎 进阶技能（提升）
- 🔌 [第8章：Skills扩展](docs/03-advanced/08-skills-extension.md) - 1800+技能
- 🤖 [第9章：多平台集成](docs/03-advanced/09-multi-platform-integration.md) - 飞书/企微/钉钉
- 🔗 [第10章：API集成](docs/03-advanced/10-api-integration.md) - 绘图/视频/语音
- ⚙️ [第11章：高级配置](docs/03-advanced/11-advanced-configuration.md) - 性能优化
### 🎯 实战案例（直接套用）
- 👔 [第12章：5类人群实战](docs/04-practical-cases/12-personal-productivity.md) - 效率提升85%
- 🔗 [第13章：高级自动化](docs/04-practical-cases/13-advanced-automation.md) - ROI 9000%-15900%
- 🎨 [第14章：创意应用](docs/04-practical-cases/14-creative-applications.md) - AI绘画/视频/翻译
- 🚀 [第15章：超级个体](docs/04-practical-cases/15-solo-entrepreneur-cases.md) - 一人顶一个团队
### 📚 附录工具（速查）
- [命令速查表](appendix/A-command-reference.md) | [必装Skills](appendix/B-skills-catalog.md)
- [常见问题](appendix/E-common-problems.md) | [API对比](appendix/C-api-comparison.md)
- [配置模板](appendix/H-config-templates.md) | [避坑指南](appendix/F-best-practices.md)
---
## 🆘 遇到问题？快速解决
🔧 常见问题速查（点击展开）
### 安装配置问题
- [安装失败怎么办？](appendix/E-common-problems.md#安装配置问题)
- [API连接失败？](appendix/E-common-problems.md#api连接问题)
- [飞书Bot不回复？](docs/03-advanced/09-multi-platform-integration.md#常见问题)
### 使用问题
- [AI变"哑巴"了？](#🔧-202632-版本ai变哑巴了) → 切换到 `full` profile
- [Gateway启动失败？](appendix/E-common-problems.md#gateway问题) → 检查认证配置
### 成本优化
- [API费用太高？](docs/03-advanced/11-advanced-configuration.md#成本优化)
- [如何省钱？](appendix/F-best-practices.md) - 使用国产模型节省95%
**找不到答案？**
- 📖 [完整FAQ](appendix/E-common-problems.md)
- 💬 [提交问题](https://github.com/xianyu110/awesome-openclaw-tutorial/issues)
---
## 🚨 重要版本提示
### ⚠️ 2026.3.7版本：Gateway认证要求（Breaking Change）
Gateway认证现在**必须显式设置** `gateway.auth.mode`（`token` 或 `password`）
**快速修复**：
```bash
openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "your-secret-token"
openclaw gateway restart
```
### 🔧 2026.3.2版本：AI变"哑巴"了？
**症状**：只能聊天不能干活（文件管理、命令执行失效）
**原因**：默认profile改为 `messaging`（纯聊天模式）
**修复**：切换到 `full` profile
```bash
openclaw config set tools.profile full
openclaw gateway restart
```
**5种Profile说明**：
| Profile | 功能说明 |
|---------|---------|
| `messaging` | 只能发布消息、管理会话 |
| `default` | 默认工具集（不含命令执行） |
| `coding` | 编程相关工具 |
| **`full`** | **完整工具集，包含命令执行（推荐）** |
| `all` | 所有工具全开 |
---
### 🆕 v2026.3.12 重大更新（2026年3月）
> 建议所有用户升级，包含大量安全修复
**新功能**
- **Control UI 全面重设计**：模块化 Dashboard，含概览/聊天/配置/Agent/Session 视图，支持命令面板、移动端底部 Tab、slash 命令、消息导出和消息置顶
- **`/fast` 快速模式开关**：支持切换 OpenAI / Anthropic 的 fast tier，更省钱更快
- **Kubernetes 支持**：新增 K8s 安装路径（支持 Kind 和 raw manifests）
- **`sessions_yield` 工具**：Agent 可立即结束当前轮次并携带后续载荷，流程控制更灵活
- **Slack Block Kit**：Slack 频道消息支持 Block Kit 富文本格式
**重要安全修复**（建议立即升级）
- 修复跨站 WebSocket 劫持路径
- 修复 workspace plugin 隐式自动加载（防止恶意代码执行）
- 修复 `/config`、`/debug` 权限绕过
- 修复共享 token 范围自我提权
- 多处 exec 审批绕过修复
---
### 🆕 v2026.3.13 更新（2026年3月中旬）
**新功能**
- **Chrome DevTools MCP attach 模式**：可直接连接已登录的 Chrome 浏览器进行自动化操作，无需重新登录
- **Ollama 一键安装引导**：支持 Local 和 Cloud+Local 混合模式，本地模型更好用
- **多模态记忆索引**：图片/音频内容可用 Gemini Embedding 进行语义检索
- **Docker 时区支持**：新增 `OPENCLAW_TZ` 环境变量
- **iOS 首次运行引导页**：新用户体验大幅提升
**Bug 修复**
- 修复工具密集型运行时 Dashboard UI 卡死/重渲染风暴
- 修复 Windows 下 gateway 重启时弹出控制台黑窗口
- 修复 setup code 可被重放攻击的安全漏洞
- 插件 SDK 去重，修复约 2 倍内存膨胀问题
---
### 🆕 v2026.3.24 更新（2026年3月26日，当前最新）
**重要变更**
- **Node.js 最低版本要求提升**：macOS 现在要求 Node >= 22.16.0（Linux/Windows 要求 >= 22.14.0），如安装失败请先检查 Node 版本
- 多平台（Discord / Telegram / Slack / 飞书）频道稳定性修复
- exec approvals 安全策略多处收紧
**升级命令**：
```bash
npm install -g openclaw@latest
openclaw --version # 确认版本为 2026.3.24
```
> ⚠️ **WSL/Linux 安装提示**：如升级后提示缺少 UI 资产，请确认 Node 版本 >= 22.14，然后重新执行 `npm install -g openclaw@latest`
---
## 📖 纸质书预告：《OpenClaw超级个体实操手册》
⚠️ **重要提示**：本教程从第10章开始存在skill找不到和配置参数错误的问题（[#34](https://github.com/xianyu110/awesome-openclaw-tutorial/issues/34)）
**纸质书已全面修正，即将上市！**
清华大学出版社即将出版《OpenClaw超级个体实操手册》，在开源教程基础上做了**全面重写+逐条验证**：
- 🔍 **144条CLI命令**对照官方文档逐条核对（教程中约60%已删除或修正）
- ✅ **9套配置模板**全部在v2026.3.7+实际跑通
- 🛡️ **新增安全防护指南** + 国产Claw全景指南
- 📦 **7份随书附赠**电子资料
📅 **预计上市时间**：2026年3月底
⭐ **Star本仓库**第一时间获取上市通知！
---
### 📖 关于本教程
### 🎯 教程特色
1. **超级个体定位** - 一个人+OpenClaw=无限可能，效率提升10倍
2. **云端部署优先** - 降低技术门槛，手机随时使用
3. **国产模型为主** - 成本低、速度快、中文友好
4. **实战案例丰富** - 70+完整工作流，可直接应用
5. **中国本土化** - 企业微信/钉钉/飞书深度集成
6. **完整资源导航** - 官方资源、社区资源、学习路径
### 📊 教程规模
- ✅ **15章节正文**：约267,000字
- ✅ **15个附录**：约141,000字
- ✅ **总字数**：408,000字
- ✅ **70+实战案例**：可直接应用
- ✅ **完整配图**：50+张配置截图
### 🎯 适合人群
- 🚀 **超级个体**：想要一个人顶一个团队，实现个人价值最大化
- 🔰 **完全新手**：从零开始，手把手教你安装配置
- 💼 **知识工作者**：学习如何用OpenClaw提升10倍个人效率
- 👨💻 **开发者**：深入了解Skills开发和API集成
- ✍️ **内容创作者**：探索自动化工作流和高级应用
---
## 📚 完整教程目录
### 第一部分：零基础入门（3章节）
- [第1章：OpenClaw是什么？](docs/01-basics/01-introduction.md)
- [第2章：5分钟完成部署](docs/01-basics/02-installation.md)
- [第3章：发送第一条消息](docs/01-basics/03-quick-start.md)
### 第二部分：核心功能（4章节）
- [第4章：本地文件管理](docs/02-core-features/04-file-management.md)
- [第5章：个人知识库](docs/02-core-features/05-knowledge-management.md)
- [第6章：日程管理](docs/02-core-features/06-schedule-management.md)
- [第7章：自动化工作流](docs/02-core-features/07-automation-workflow.md)
### 第三部分：进阶技能（4章节）
- [第8章：Skills扩展](docs/03-advanced/08-skills-extension.md)
- [第9章：多平台集成](docs/03-advanced/09-multi-platform-integration.md)
- [第10章：API服务集成](docs/03-advanced/10-api-integration.md)
- [第11章：高级配置](docs/03-advanced/11-advanced-configuration.md)
### 第四部分：实战案例（4章节）
- [第12章：5类人群效率提升实战](docs/04-practical-cases/12-personal-productivity.md)
- [第13章：高级自动化工作流](docs/04-practical-cases/13-advanced-automation.md)
- [第14章：创意应用探索](docs/04-practical-cases/14-creative-applications.md)
- [第15章：超级个体实战案例](docs/04-practical-cases/15-solo-entrepreneur-cases.md)
---
## 🔗 官方资源
- **OpenClaw官方网站**：https://openclaw.ai
- **OpenClaw官方文档**：https://docs.openclaw.ai
- **GitHub仓库**：https://github.com/openclaw/openclaw
- **ClawHub技能广场**：https://clawhub.ai
- **Awesome Skills合集**：https://github.com/VoltAgent/awesome-openclaw-skills
## 💡 实战案例精选
### 📦 配置示例（开箱即用）
- [基础配置](examples/configs/basic-config.json)
- [多模型配置](examples/configs/multi-model-config.json)
- [多Agent配置](examples/configs/multi-agent-config.json)
- [飞书Bot配置](examples/configs/feishu-config.json)
### 🎬 实战场景
- [文件管理：找发票](docs/02-core-features/04-file-management.md)
- [知识管理：网页存档](docs/02-core-features/05-knowledge-management.md)
- [日程管理：截图识别](docs/02-core-features/06-schedule-management.md)
- [自动化：网站监控](docs/02-core-features/07-automation-workflow.md)
---
## 📊 成本对比
| 方案 | 月费用 | 适用场景 |
|------|--------|---------|
| 飞书妙搭 | **免费** | 新手推荐（限时） |
| 云端部署 | 20-50元 | 无Mac/24小时运行 |
| 本地部署 | 0元 | 有Mac电脑 |
| API费用（DeepSeek） | 5-30元 | 日常使用 |
| API费用（Kimi） | 10-50元 | 长文档处理 |
💡 **省钱技巧**：使用国产大模型（DeepSeek、Kimi）节省**50%-70%**成本
---
## 🤝 贡献指南
欢迎贡献你的经验和案例！
1. Fork本仓库
2. 创建你的分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的修改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交Pull Request
---
## 🆕 Claude Code 架构设计对 OpenClaw 的启示
> 2026年3月，Anthropic Claude Code v2.1.88 源码泄露，约 51.2 万行代码全网扩散。以下是从中提炼出对 OpenClaw 有参考价值的改进方向。
### 1. 记忆系统：三层压缩架构
Claude Code 实现了分层记忆管理：
| 层级 | 触发时机 | 特点 |
|------|----------|------|
| **Micro Compact** | 每轮 API 请求前 | 轻量剪枝，无额外开销 |
| **Session Memory Compact** | 后台持续运行 | 无 LLM 调用 |
| **LLM Compact** | 上下文超限 | 需要 LLM 调用，成本高 |
**对 OpenClaw 的启发**：
- 设计"主动压缩"而非"被动溢出"——不要等上下文满了才处理
- 参考增量裁剪思路，每轮对话后微调，而非全量重建
- 三层记忆（Redis → PostgreSQL → Milvus）的分层设计方向正确
### 2. 权限验证：风险分级模型
Claude Code 的六级验证体系值得借鉴：
```
基础权限检查 → 风险分级(LOW/MED/HIGH) → ML分类器自动审批 → YOLO快判 → 用户交互确认 → 结果验证
```
**对 OpenClaw 的启发**：
- 消息网关（微信/钉钉/飞书）入口的消息来源更复杂，需要严格验证
- 设计轻量级**风险评分**：高风险操作（如文件删除、命令执行）才触发人工确认
- 低风险操作可由 AI 自动审批，提升用户体验
### 3. 安全防护：输入净化机制
Claude Code 防护了多种攻击向量：
| 攻击类型 | 防护措施 |
|----------|----------|
| 路径遍历 | 路径标准化 + 安全路径检查 |
| Unicode 标准化 | 字符正规化后双重验证 |
| 反斜杠注入 | 专门的黑名单检测 |
| 敏感文件访问 | `.gitconfig`、`.bashrc` 等文件保护 |
**对 OpenClaw 的启发**：
- 消息网关收到的用户指令需要"净化"处理，防止指令注入
- 文件操作、系统命令要有明确的安全边界
- 特别是涉及`rm`、`curl`等危险命令时，要有多重确认
### 4. 异步任务：离线执行模式
Claude Code 的 **KAIROS 守护进程** 模式（7×24 小时自主运行）是很好的参考：
- 用户离线后 AI 继续执行任务
- 后台任务队列 + 任务持久化
- 支持 Webhooks 触发自动响应
**对 OpenClaw 的启发**：
- 实现"微信发指令 → Agent 执行 → 微信接收结果"的异步模式
- 任务可中断、可恢复，用户离线不影响执行
- 类似"后台任务队列"的设计可以参考 Claude Code 的实现
### 5. 遥测设计：用户行为分析
Claude Code 追踪的指标（可借鉴但需谨慎）：
| 指标 | 用途 |
|------|------|
| `frustration metric` | 用户是否对 AI 不耐烦 |
| `continue 追踪` | 用户是否频繁使用"继续" |
| 会话元数据 | 模型使用、环境详情 |
**对 OpenClaw 的启发**：
- 可以追踪消息频率、任务完成率、用户反馈等运营指标
- **隐私合规**：敏感信息脱敏后才上传，不记录原始消息内容
- 用聚合统计代替个体追踪
---
## 🔍 关键词检索
> **快速定位**：Claude Code v2.1.88 | Anthropic | OpenClaw | 记忆系统架构 | 权限验证设计 | 安全防护 | 异步任务
---
## 📈 项目进度
- ✅ **v1.6**（2026-03-18）：新增一键部署教程（8个平台）
- ✅ **v1.7**（2026-03-27）：同步 OpenClaw v2026.3.12 ~ v2026.3.24 版本更新内容，追加多版本重要提示
- 🔄 **v1.8**（进行中）：优化内容质量，补充实战案例
---
## 📄 许可证
本项目采用 [GPL-3.0 License](LICENSE)
### ⚠️ 重要声明：禁止倒卖
- ❌ **严禁倒卖**：禁止将本教程打包后进行商业售卖
- ❌ **严禁闭源商用**：任何基于本项目的衍生作品必须同样开源
- ✅ **允许学习**：欢迎个人学习和使用
- ✅ **允许分享**：欢迎分享给更多需要的人
- ✅ **允许修改**：可以修改并分享，但必须保持开源
---
**最后更新**：2026年3月27日
**教程版本**：v1.7
**总字数**：408,000字（15章节 + 15附录）
**适用OpenClaw版本**：2026.3.24（推荐最新版）
🎉 **教程已完成 | 支持续优化 | 完全免费** 🎉
🚀 **一个人 + OpenClaw = 无限可能** 🚀
⭐ **如果觉得有用，请给个Star支持一下** ⭐