Skip to content

OpenClaw 中文文档零基础搭建你的 AI 聊天机器人

手把手教程,5分钟让AI助手跑在 Telegram、WhatsApp、Discord、飞书。支持 Claude、GPT、DeepSeek、本地 Ollama,完全免费开源。

00

安装教程

从安装到配置,手把手带你跑起来。涵盖 AI 服务商接入、聊天频道配置、智能体概念与常见问题解答。

01

完整工程主线

从 CLI 到 Gateway,再到 Routing 与 Auto-reply,按真实执行链路拆解模块边界与调用关系。

02

AI 核心框架

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

03

通道适配器实现

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

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

不需要编程经验,按步骤操作即可。安装 OpenClaw → 接入 AI 模型 → 连接 Telegram/WhatsApp/Discord,你的 AI 助手就上线了。想深入研究?源码剖析和架构分析一样有。

零基础可上手5分钟快速入门手把手步骤完全免费开源多平台同时接入AI 模型自由选

从这里开始 →

安装教程 · 新手必看

还没装好 OpenClaw?从这里开始。一行命令安装,配置向导手把手,接入 Claude/GPT/DeepSeek,连接 Telegram/WhatsApp/Discord,零基础也能跑起来。

开始安装 →

Track A

项目完整拆解主线

从 CLI 到 Gateway,理解消息如何从输入走到 AI 再回到通道。涵盖全链路架构与源码入口,想深入研究就从这里开始。

进入主线 →

Track B

AI 重点框架专项

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

进入专项 →

Track C

通道适配器框架

学习如何对接 Telegram、WhatsApp、Discord 等平台的技术原理,了解通道注册、账号生命周期与消息路由机制。

看函数级实战 →

推荐入门路径(零基础 5 步上手)

  1. 第一步:选择安装方式,找到适合你系统的安装方法(macOS / Linux / Windows WSL2)。
  2. 第二步:命令行向导安装,运行 openclaw onboard,按提示填入 AI 模型 API Key。
  3. 第三步:在通道接入教程里选你要用的平台(Telegram / WhatsApp / Discord / 飞书),跟着步骤接入。
  4. 第四步:在AI 模型配置里选你的 AI(Claude / GPT / DeepSeek / Ollama 本地模型)。
  5. 进阶:看项目完整拆解主线,建立全局架构认知,按需复刻核心能力。

常见问题(新手必读)

搭建 AI 机器人需要编程基础吗?

不需要。OpenClaw 提供命令行向导(openclaw onboard),按提示一步步操作即可完成安装和配置,零编程基础的用户也能在 5 分钟内让 AI 机器人在 Telegram 或 WhatsApp 上跑起来。如果你只是想用,不用看懂代码。

怎么搭建 Telegram AI 机器人?

三步完成:① 安装 OpenClaw(npm install -g openclaw@latest);② 在 Telegram 向 @BotFather 发送 /newbot 申请 Bot Token;③ 运行 openclaw onboard,填入 Token 和 AI 模型的 API Key。详见Telegram 接入教程

怎么搭建 WhatsApp AI 机器人?

OpenClaw 支持通过 WhatsApp Business API 或 Baileys 方案接入 WhatsApp。安装后在配置向导中选择 WhatsApp 通道,扫码或填入凭证即可。详见通道接入教程

OpenClaw 免费吗?要花多少钱?

OpenClaw 本身完全免费开源(MIT 协议),不收任何费用。费用只来自 AI 模型 API:Claude/GPT 按用量收费;DeepSeek 非常便宜;Ollama 本地模型完全零费用,数据不出本地。对于个人用户,每月几元到几十元足够日常使用。

Claude、GPT、DeepSeek 选哪个?

对新手来说:DeepSeek 中文能力强、价格最低,适合入门;Claude(Anthropic) 逻辑和长文档处理出色;GPT(OpenAI) 生态最成熟。也可以用 Ollama + 本地模型完全免费运行,适合隐私敏感场景。OpenClaw 支持随时切换。

OpenClaw 是什么?

OpenClaw(原名 ClawdBot)是一款开源的多通道 AI 智能体框架,让你的 AI 助手运行在 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、飞书等任意平台上,支持接入 Claude、GPT、DeepSeek、Ollama 等主流 AI 模型。

OpenClaw 支持哪些聊天平台?

支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、飞书(Feishu)、Mattermost、Google Chat、MS Teams、Matrix、Zalo、IRC 等主流即时通讯平台。

OpenClaw 支持哪些 AI 模型?

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

OpenClaw 支持本地大模型吗?不想花 API 费用怎么办?

支持。安装 Ollama 后即可在本地运行 DeepSeek、Llama、Qwen 等开源大模型,OpenClaw 直接接入,完全私有化部署,无需外网,数据不出本地,API 费用为零。详见Ollama 本地模型教程

OpenClaw 和 Dify、Coze、FastGPT 有什么区别?

OpenClaw 专注于多通道即时通讯接入,让 AI 助手直接运行在你日常用的聊天软件里。Dify 和 FastGPT 更侧重知识库问答;Coze 是字节跳动的闭源平台。OpenClaw 完全开源、可自部署、AI 模型自由选择,是真正的多平台 AI 机器人框架。

OpenClaw 和 ClawdBot 是什么关系?

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

OpenClaw Gateway 是什么?

OpenClaw Gateway 是核心常驻进程,负责统一管理所有通道连接、消息路由、Agent 调度与会话存储。通过 openclaw gateway 命令启动,默认监听 18789 端口。新手不需要深入理解它,按安装向导配置即可自动启动。

OpenClaw 和 AstrBot 有什么区别?哪个更适合我?

两者都是开源多平台 AI 机器人框架,定位略有差异:

  • OpenClaw:Node.js/TypeScript,专注 Telegram、WhatsApp、Discord、飞书、Signal、iMessage 等有官方 API 的平台,文档完整,适合源码学习与二次开发。
  • AstrBot:Python,侧重 QQ、微信公众号等国内平台,有可视化 Web 管理面板。

如果你主要用 Telegram / WhatsApp / Discord,选 OpenClaw;如果需要接入 QQ / 微信公众号,AstrBot 是更好的选择。

OpenClaw 安全吗?我的聊天记录会被收集吗?

OpenClaw 完全开源(MIT 协议),代码在 GitHub 公开审计,不含任何后门或数据收集逻辑。你的机器人运行在自己的服务器或本地机器上,消息数据不经过任何第三方。

  • 使用 Ollama 本地模型:AI 推理也在本地,数据完全不出本地,零隐私风险。
  • 使用 Claude / GPT / DeepSeek 等云端 API:消息会发给对应 AI 服务商,和直接使用这些服务没有区别,OpenClaw 不额外参与。
OpenClaw 支持微信或 QQ 吗?

目前不支持个人微信或 QQ 接入。微信个人账号接入存在封号风险,且官方不提供开放 API;QQ 同样缺乏稳定的官方机器人接口。OpenClaw 专注有正式 API 的平台:Telegram、WhatsApp Business API、Discord、Slack、Signal、iMessage、飞书等。如果你必须接入微信/QQ,可以考虑 AstrBotkirara-ai

OpenClaw 可以在 NAS 或迷你主机上部署吗?

可以。OpenClaw 支持在群晖 NAS(通过 Docker 或 Node.js 环境)、迷你主机、树莓派等任何能运行 Node.js 的设备上部署。配合 Ollama 本地大模型,可以实现完全离线私有化部署,7×24 小时待机,数据不出本地,AI API 费用为零。

关于 OpenClaw(原 ClawdBot)

OpenClaw 前身为 ClawdBot,是一款面向开发者的开源多通道 AI 智能体框架,支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、飞书(Feishu)、Mattermost、MS Teams、Google Chat、Matrix 等主流即时通讯平台。项目于品牌升级后正式更名为 OpenClaw,功能持续迭代,文档同步覆盖全部核心模块。

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

如果你是从 ClawdBot 搜索过来的,这里就是你要找的地方。本文档覆盖安装部署、源码剖析、架构分析与复刻实战。

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