OpenClaw 中文文档 — 简介概览

上周在 GitHub Trending 上刷到一个项目------OpenClaw，Star 数蹿得挺快。点进去一看：一个能把 WhatsApp、Telegram、Discord 统一接入 AI Agent 的开源网关。

我第一反应是：又一个套壳项目？结果 clone 下来跑了一下，发现完全不是那回事。

它是什么

OpenClaw 不是一个 AI 产品，是一个网关。

你在自己的机器上跑一个 Gateway 进程，它就变成了聊天应用和 AI Agent 之间的桥梁。WhatsApp 发条消息过去，AI 直接回你。Telegram 也行，Discord 也行，甚至 iMessage 也行------一个 Gateway 全搞定。

而且是真正的自托管，数据全程在你手上。MIT 开源，没有商业锁定。

架构一览

这个设计我觉得挺巧妙的------所有东西都围绕一个 Gateway 转：

scss 复制代码

WhatsApp / Telegram / Discord / iMessage / Mattermost(插件)
                        │
                    Gateway（核心）
                   ╱   │    ╲     ╲
                CLI  Web面板  macOS  移动节点

不管你从哪个聊天应用发消息，走的都是同一套 Agent 逻辑。渠道只是入口，核心是 Gateway。

能力清单

多渠道：WhatsApp(Baileys)、Telegram(grammY)、Discord、iMessage，一个进程全部搞定
插件机制：Mattermost 等平台通过插件接入
多 Agent 路由：不同发送者、不同工作区可以对接不同的 Agent，会话隔离
媒体收发：图片、音频、文档都支持
流式输出：长回复分块推送，不用干等
Web 面板 + macOS 应用：浏览器里就能管理一切
移动节点：iOS/Android 配对，Canvas、相机、语音全有

跑起来看看

强烈建议你亲手试一下，5 分钟的事：

bash 复制代码

# 安装（macOS/Linux/WSL2）
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows 用 PowerShell
# iwr -useb https://openclaw.ai/install.ps1 | iex

# 引导配置
openclaw onboard --install-daemon

# 配对 WhatsApp（会弹出二维码）
openclaw channels login

# 启动 Gateway
openclaw gateway --port 18789

# 打开控制面板
openclaw dashboard

浏览器打开 http://127.0.0.1:18789/，看到面板就说明成了。

要求不高：Node 24（推荐）或 Node 22 LTS，macOS/Linux/Windows(WSL2) 都行。

最简配置

默认配置就能用。但建议至少限制一下谁能给你发消息，不然所有消息都会触发 Agent：

json5 复制代码

// ~/.openclaw/openclaw.json
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],  // 你的号码
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

这篇先把 OpenClaw 的定位和核心能力过了一遍。下一篇写快速上手的完整流程，包括不同安装方式的选择。

完整中文文档：OpenClaw 中文文档

GitHub 仓库：openclaw/openclaw

OpenClaw 中文文档系列第一篇，后面会一篇篇写完。觉得有用点个赞，有问题评论区聊。