OpenClaw 🦞

OpenClaw

“EXFOLIATE! EXFOLIATE!” — 一只太空龙虾如是说

跨 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 密钥(推荐 Anthropic)和 5 分钟。

工作原理

flowchart LR
  A["聊天应用 + 插件"] --> B["网关"]
  B --> C["Pi 代理"]
  B --> D["CLI"]
  B --> E["Web 控制 UI"]
  B --> F["macOS 应用"]
  B --> G["iOS 和 Android 节点"]

网关是会话、路由和渠道连接的单一事实来源。

核心功能

使用单个网关进程连接 WhatsApp、Telegram、Discord 和 iMessage。 使用扩展包添加 Mattermost 等更多功能。 每个代理、工作区或发送者都有隔离的会话。 发送和接收图像、音频和文档。 用于聊天、配置、会话和节点的浏览器仪表板。 配对支持 Canvas 的 iOS 和 Android 节点。

快速开始

```bash npm install -g openclaw@latest ``` ```bash openclaw onboard --install-daemon ``` ```bash openclaw channels login openclaw gateway --port 18789 ```

需要完整的安装和开发设置?请参阅快速开始

仪表板

网关启动后打开浏览器控制 UI。

配置(可选)

配置文件位于 ~/.openclaw/openclaw.json

  • 如果您什么都不做,OpenClaw 在 RPC 模式下使用捆绑的 Pi 二进制文件,每个发送者都有独立会话。
  • 如果您想锁定它,从 channels.whatsapp.allowFrom 和(对于群组)提及规则开始。

示例:

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

从这里开始

按用例组织的所有文档和指南。 核心网关设置、令牌和提供商配置。 SSH 和 tailnet 访问模式。 WhatsApp、Telegram、Discord 等的渠道特定设置。 带有配对和 Canvas 的 iOS 和 Android 节点。 常见修复和故障排除入口。

了解更多

完整的渠道、路由和媒体功能。 工作区隔离和每个代理的会话。 令牌、允许列表和安全控制。 网关诊断和常见错误。 项目起源、贡献者和许可证。