Skip to content

OpenClaw 中文教程先让你用懂,再带你看懂源码

覆盖最新版 Gateway、Web 控制 UI、节点、插件、通道、模型、工具和智能体执行链路。先用零基础教程跑起来,再用工程视角拆源码。

00

安装教程

从安装到控制 UI、Gateway、通道和模型配置,手把手带你跑起来。先能用,再深入。

01

完整工程主线

从 CLI 到 Gateway、插件、节点、Routing 与 Agent 执行,按真实链路拆解模块边界与调用关系。

02

AI 核心框架

深挖上下文管理、状态机、工具策略、模型回退、记忆系统、Hook 与插件注入机制。

03

通道适配器实现

重点讲接口合同、注册链路、账号生命周期、入站路由与出站发送的工程实现。

200+深度文档
3学习主线
623教程文档
40+函数级剖析

本项目文档面向「要动手实现」的读者,而不只是看概念。你会系统理解 OpenClaw 的智能体框架、通道适配器、上下文管理、状态机、Gateway 控制面与工程化边界。

源码路径明确小白友好讲解可直接复刻覆盖 AI 核心函数级精度状态机驱动

Track 0

新手入门 · 安装教程

还没装好 OpenClaw?从这里开始。按“准备、复制命令、看到什么算成功、失败看哪里”的节奏,一步一步跑起来。

零基础照着做 →

Track A

项目完整拆解主线

先建立全局工程脑图,理解系统如何从输入消息走到模型回复再返回通道。涵盖 CLI、Gateway、插件、节点、路由、Agent 全链路。

进入主线 →

Track B

AI 重点框架专项

聚焦上下文工程、执行状态机、工具策略与审批、模型回退、记忆系统等 AI 实现核心,可直接复刻。

进入专项 →

Track C

通道适配器框架

重点学习通道接口合同、注册机制、账号生命周期、路由与发送解耦,是对接外部平台的关键。

看函数级实战 →

推荐阅读路径(从 0 到 1)

  1. 第一步:看「零基础照着做」,把 OpenClaw 装好,并先用控制 UI 发出第一条消息。
  2. 第二步:看「项目完整拆解主线」,建立全局工程脑图与模块边界概念。
  3. 第三步:看「AI 重点框架专项」,吃透上下文、状态机与工具策略实现原理。
  4. 最后:看函数级剖析章节,按步骤复刻核心能力到你自己的项目中。

常见问题

OpenClaw 是什么?

OpenClaw 是一款自托管的多通道 AI 助手平台。它通过 Gateway 统一连接浏览器控制 UI、聊天通道、移动节点、工具和模型,让你的 AI 助手运行在 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、飞书等入口上。

OpenClaw 支持哪些聊天平台?

支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage/BlueBubbles、飞书(Feishu)、Mattermost、Google Chat、Microsoft Teams、Matrix、LINE、Zalo、QQ、WeChat、Nostr、Twitch、IRC、WebChat 等入口。

OpenClaw 支持哪些 AI 模型?

支持 Anthropic Claude、OpenAI GPT、DeepSeek、通义千问(Qwen)、Kimi(月之暗面)、智谱 GLM、MiniMax、Ollama 本地大模型,以及通过 OpenRouter、LiteLLM、Cloudflare AI Gateway 接入的其他模型。

OpenClaw 怎么安装?

推荐使用安装脚本,或运行 npm install -g openclaw@latest,然后执行 openclaw onboard --install-daemon 完成配置并安装 Gateway 后台服务。支持 macOS、Linux、Windows,Windows 完整体验推荐 WSL2。详见安装教程

OpenClaw 和 ClawdBot 是什么关系?

OpenClaw 的前身就是 ClawdBot,项目品牌升级后正式更名为 OpenClaw,功能与代码库保持延续。如果你之前使用过 ClawdBot,OpenClaw 就是它的新版本。

OpenClaw Gateway 是什么?

OpenClaw Gateway 是核心常驻进程,负责统一管理所有通道连接、消息路由、Agent 调度与会话存储。新手推荐通过 openclaw onboard --install-daemon 安装为后台服务,默认监听 18789 端口。

OpenClaw 支持本地大模型吗?

支持。OpenClaw 可通过 Ollama 接入本地大模型(如 Llama、Qwen、DeepSeek 等),实现完全私有化部署,无需外部 API,数据不出本地。

关于 OpenClaw

OpenClaw 是一款面向开发者和高级用户的开源个人 AI 助手平台,支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage/BlueBubbles、飞书(Feishu)、Mattermost、Microsoft Teams、Google Chat、Matrix、LINE、Zalo、QQ、WeChat、WebChat 等入口。本文档同步覆盖最新 Gateway、Control UI、节点、插件与 Agent 核心模块。

支持接入 Anthropic Claude、OpenAI GPT、DeepSeek、通义千问(Qwen)、Kimi(月之暗面)、智谱 GLM、MiniMax、Ollama 本地大模型等主流 AI 提供商,也可通过 OpenRouter、LiteLLM、Cloudflare AI Gateway 统一代理。

如果你想先用起来,先看零基础照着做;如果你想理解实现,再进入源码剖析、架构分析与复刻实战。

用工程视角拆解 AI 智能体框架