Skip to main content

​
OpenClaw 🦞

OpenClaw

“去角质！去角质！” — 一只太空龙虾，大概是说的

支持 WhatsApp、Telegram、Discord、iMessage 等多渠道的任意操作系统 AI 代理网关。
发消息即可从口袋中获得代理回复。插件支持 Mattermost 等更多渠道。

快速开始

安装 OpenClaw，几分钟内启动网关。

运行向导

使用 openclaw onboard 和配对流程的引导设置。

打开控制界面

启动浏览器仪表盘，管理聊天、配置和会话。

​
什么是 OpenClaw？

OpenClaw 是一个 自托管网关，连接你喜欢的聊天应用——WhatsApp、Telegram、Discord、iMessage 等——与像 Pi 这样的 AI 编码代理。你只需在自己的机器（或服务器）上运行单个网关进程，就能搭建起聊天应用与全天候 AI 助手之间的桥梁。 适合谁？ 开发者和高级用户，想拥有一个可以随时随地聊天的私人 AI 助手，同时不丢失数据控制权或依赖托管服务。 有什么不同？
  • 自托管：运行在你的硬件上，由你掌控
  • 多通道：一台网关同时支持 WhatsApp、Telegram、Discord 等多个平台
  • 代理原生：为具备工具使用、会话、记忆和多代理路由的编码代理构建
  • 开源：MIT 许可，社区驱动
需要什么？ Node 22+，你选择的提供商的 API 密钥，以及 5 分钟。为了最佳质量和安全，建议使用最新一代最强模型。

​
工作原理

网关是会话、路由和渠道连接的唯一权威。

​
主要功能

多通道网关

用一个网关进程支持 WhatsApp、Telegram、Discord 和 iMessage。

插件渠道

通过扩展包添加 Mattermost 及更多渠道。

多代理路由

每个代理、工作区或发送者隔离会话。

媒体支持

支持发送和接收图片、音频和文档。

网页控制界面

浏览器仪表盘，管理聊天、配置、会话和节点。

移动节点

配对 iOS 和 Android 节点，实现 Canvas、摄像头/屏幕和语音支持的工作流。

​
快速开始

1

安装 OpenClaw

npm install -g openclaw@latest
2

初始化并安装服务

openclaw onboard --install-daemon
3

配对 WhatsApp 并启动网关

openclaw channels login
openclaw gateway --port 18789
需要完整安装和开发环境？参见 快速开始。

​
仪表盘

网关启动后，打开浏览器的控制界面。

OpenClaw

​
配置（可选）

配置文件位于 ~/.openclaw/openclaw.json。
  • 如果你不做任何操作，OpenClaw 会使用捆绑的 Pi 二进制文件，以 RPC 模式和按发送者区分的会话运行。
  • 如果想严格控制访问，可从 channels.whatsapp.allowFrom 以及（群组的）提及规则开始配置。
示例： 
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

​
从这里开始

文档中心

按使用场景组织的所有文档和指南。

配置

核心网关设置、令牌和提供商配置。

远程访问

SSH 和 tailnet 访问模式。

渠道

WhatsApp、Telegram、Discord 等渠道的专门设置。

节点

iOS 和 Android 节点，支持配对、Canvas、摄像头/屏幕及设备操作。

帮助

常见解决方案和故障排查起点。

​
了解更多

完整功能列表

详细的渠道、路由和媒体能力。

多代理路由

工作区隔离和按代理区分的会话。

安全性

令牌、白名单和安全控制。

故障排查

网关诊断和常见错误。

关于与鸣谢

项目起源、贡献者和许可证信息。