OpenClaw 中文文档 | 源码剖析 · 安装教程 · AI 智能体框架

OpenClaw（原名 ClawdBot）是一个开源多通道 AI 智能体框架，支持 WhatsApp、Telegram、Discord、飞书等平台，可接入 Claude、GPT、DeepSeek、Ollama 等模型。本仓库是其完整中文文档站，包含 276 篇深度教程，覆盖安装部署、源码剖析、Gateway 配置与 AI 核心框架解析。

📖 立即在线阅读 → openclaw-docs.dx3n.cn

📚 文档覆盖范围

本文档站包含 276 篇原创中文教程，分为 4 条学习主线：

主线	内容覆盖	篇数	链接
Track 0 安装教程	快速安装、向导配置、AI 服务商接入（Claude/GPT/DeepSeek/Ollama）、通道接入（Telegram/WhatsApp/Discord/飞书）、Gateway 运维、常见问题排查	147 篇	→ 教程中心
Track A 完整工程主线	CLI 启动框架、Gateway 控制平面、通道适配器、路由与会话键、Agent 执行链路、流式订阅、子智能体编排、函数级源码剖析	59 篇	→ 工程主线
Track B AI 核心框架	上下文工程、Agent 状态机、工具策略与审批、模型回退、记忆系统、Hook 插件注入机制	22 篇	→ AI 框架
Track C 通道适配器	接口合同、注册链路、账号生命周期、入站路由、出站发送解耦	含于 Track A	→ 适配器索引

🤖 OpenClaw 是什么？

OpenClaw（前身 ClawdBot）是一款开源的多通道 AI 智能体框架，让你的 AI 助手运行在任意即时通讯平台上。

支持的聊天平台

WhatsApp · Telegram · Discord · Slack · Signal · iMessage · 飞书（Feishu） · Mattermost · Google Chat · Microsoft Teams · Matrix · Zalo · IRC · Nostr · Twitch

支持的 AI 模型

Anthropic Claude · OpenAI GPT · DeepSeek · 通义千问（Qwen） · Kimi（月之暗面） · 智谱 GLM · MiniMax · Ollama（本地大模型） · OpenRouter · LiteLLM · Cloudflare AI Gateway · Vercel AI Gateway · NVIDIA NIM · Together AI · HuggingFace · vLLM

🚀 快速开始（本地运行文档站）

git clone https://github.com/yeuxuan/openclaw-docs.git
cd openclaw-docs
npm install
npm run docs:dev

打开终端输出的本地地址即可预览完整文档站。

npm run docs:build    # 构建静态产物到 docs/.vitepress/dist/
npm run docs:preview  # 本地预览构建结果

📁 仓库结构

openclaw-docs/
├── docs/
│   ├── index.md                            # 首页
│   ├── tutorials/                          # Track 0：安装教程（147 篇）
│   │   ├── getting-started/                #   快速入门与向导安装
│   │   ├── installation/                #   Docker / Node / 云服务器部署
│   │   ├── gateway/                        #   Gateway 配置与运维
│   │   ├── channels/                       #   通道接入（Telegram/WhatsApp/Discord 等）
│   │   ├── providers/                      #   AI 模型 Provider 配置
│   │   ├── concepts/                       #   核心概念（上下文/记忆/状态机等）
│   │   ├── tools/                          #   工具系统（浏览器/执行/技能/子智能体）
│   │   ├── automation/                     #   自动化（Webhook/Cron/Poll）
│   │   └── help/                           #   故障排查与常见问题
│   ├── beginner-openclaw-guide/            # Track A：完整工程主线（59 篇）
│   └── beginner-openclaw-framework-focus/  # Track B：AI 核心框架（22 篇）
├── docs/.vitepress/
│   ├── config.mts                          # 站点配置（SEO / 导航 / 侧边栏）
│   └── theme/                             # 自定义主题与样式
└── scripts/
    ├── convert-mdx.mjs                     # MDX → VitePress Markdown 批量转换
    └── ping-indexnow.mjs                   # 构建后自动推送 URL 到 Bing IndexNow

✨ 文档特点

函数级精度：关键模块精确到具体函数的源码入口与调用链路
小白友好：安装教程全程图文，零基础 10 分钟跑起来
可直接复刻：每个核心能力都给出落地步骤，可直接用于自己的项目
持续更新：跟随 OpenClaw 版本迭代，覆盖最新 API 与配置方式
SEO 完备：276 页独立 description、sitemap、IndexNow 自动推送

🔗 相关链接

OpenClaw 官方：github.com/openclaw
官方英文文档：docs.openclaw.ai
本站中文文档：openclaw-docs.dx3n.cn
部署平台：Azure Static Web Apps

yeuxuan/openclaw-docs