OpenClaw 中文文档 — 简介概览

0 阅读2分钟

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

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

它是什么

OpenClaw 不是一个 AI 产品,是一个网关

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

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

架构一览

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

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 分钟的事:

# 安装(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:

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

下一篇

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

完整中文文档:OpenClaw 中文文档

GitHub 仓库:openclaw/openclaw


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