跳到正文
🟠 需外部服务 — 需自备相关账号/权限 进阶 入门上手

OpenClaw 中文文档站:276篇深度教程

yeuxuan 整理的 276 篇中文教程,覆盖源码剖析/安装部署/Gateway配置/AI框架,4条学习主线

⚔️ 难度 ★★☆ 进阶
⏱ 配置耗时 按需选取
🎁 掉落 节省 按需选取
🦞 部署 可一键部署

🎯 做完你会得到

系统理解 OpenClaw 架构,掌握高级配置和源码级别的调试能力

👤 适合谁

  • 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
#中文文档#源码#Gateway#架构#深度教程