🎯 做完你会得到
系统理解 OpenClaw 架构,掌握高级配置和源码级别的调试能力
👤 适合谁
- OpenClaw 中文文档站:276篇深度教程
⚡ 效果预览
输入需求后,AI 会围绕「OpenClaw 中文文档站:276篇深度教程」生成可执行方案、关键步骤和提醒。
🔧 Step 0:先配置消息接收渠道
⚠️ 本案例需要发送通知到你的手机,先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →
这个场景解决什么问题
官方英文文档对中文用户不友好,遇到底层问题时不知道去哪查。这个文档站 276 篇全中文,从入门安装到源码级别的架构解析,是目前最全面的中文 OpenClaw 技术文档。
直接复制这段:本地搭建中文文档站
git clone https://github.com/yeuxuan/openclaw-docs.git
cd openclaw-docs
npm install
npm run docs:dev
# 浏览器打开 http://localhost:5173
核心步骤
4条学习主线
Track 0:安装教程(147篇) — 适合所有人
| 子模块 | 内容 |
|---|---|
| 快速入门 | onboard 向导、首次配置 |
| 安装方式 | Docker / Node.js / 云服务器 |
| Gateway 配置 | 端口、认证、HTTPS |
| 渠道接入 | Telegram/WhatsApp/Discord/飞书 |
| AI 模型配置 | Claude/GPT/DeepSeek/Ollama |
| 故障排查 | 常见错误和解决方案 |
Track A:完整工程主线(59篇) — 适合开发者
深入 OpenClaw 源码:
- CLI 启动框架和 Gateway 控制平面
- 通道适配器实现(如何新增渠道)
- 路由与会话键设计
- Agent 执行链路和流式订阅
- 子智能体编排(sessions_spawn 原理)
Track B:AI 核心框架(22篇)
- 上下文工程和 token 优化
- Agent 状态机设计
- 工具策略与审批流程
- 模型回退和容错
- 记忆系统实现原理
- Hook 插件注入机制
如何使用文档站
在线访问:https://openclaw-docs.dx3n.cn
本地搭建(贡献修改时):
git clone https://github.com/yeuxuan/openclaw-docs.git
cd openclaw-docs
npm install
npm run docs:dev
关键配置
支持的 AI 模型完整列表(来自文档):
国际模型:
- Anthropic Claude(claude-3-5-sonnet-20241022)
- OpenAI GPT(gpt-4o / gpt-4o-mini)
- DeepSeek(deepseek-chat / deepseek-coder)
国产模型:
- 通义千问(qwen-plus / qwen-max)
- Kimi(moonshot-v1-32k / moonshot-v1-128k)
- 智谱 GLM(glm-4-flash / glm-4)
- MiniMax(abab6.5-chat)
本地模型:
- Ollama(llama3 / qwen2 / gemma2 等)
支持的聊天平台: WhatsApp · Telegram · Discord · Slack · Signal · iMessage · 飞书 · Mattermost · Google Chat · Teams · Matrix · Zalo
预期结果
- 快速找到特定配置的中文说明
- 理解 Gateway 和 Agent 的架构关系
- 遇到报错时有对应的排查文档
注意事项
- 文档站同步官方版本更新,偶尔有几天延迟
- 源码剖析部分对应 OpenClaw 主仓库,代码有变动时可能过时
- Track A/B 难度较高,建议先完成 Track 0
- 如发现错误可提 PR:https://github.com/yeuxuan/openclaw-docs
🦞 跑完这个副本了?
加入虾农微信群,跟 300+ 玩家交流踩坑经验、分享配置技巧
二维码过期?添加微信 深夜开发者LND 备注「虾农」拉你入群
AI Android 配对恢复助手:重连、排障、状态校验一条龙
用 OpenClaw 管理 Android 配对后的常见问题,自动检查连接状态、重做配对、校验权限和恢复消息通道。
AI 模型目录上线记分牌:新 catalog 上线后该不该放量,一眼看清
用 OpenClaw 给新 provider catalog 和新模型 rollout 做记分牌,比较稳定性、成本、错误率和适用场景,再决定是否放量。
AI 配置 diff 复核助手:改动前后差异一眼看清
用 OpenClaw 读取原始配置 diff,自动标出关键变更、风险项和潜在回滚点,减少改配置时的盲区。
AI 高危安装闸门:命中 critical 风险时先拦下再谈
用 OpenClaw 在安装插件、依赖或扩展前做高危风险拦截,发现 critical 级漏洞时默认阻断,避免带病上线。