OpenClaw 🦞

跨平台消息网关 - 连接 AI 编程代理到你的消息应用

通过 WhatsApp、Telegram、Discord、iMessage 等平台与 AI 代理对话。支持 Any OS + 多种消息平台连接 AI 编程代理。

快速开始 安装指南
多平台支持
AI 集成
安全可靠
实时响应

支持的平台

OpenClaw 支持多种即时通讯平台，你可以选择自己常用的平台来与 AI 代理交互

WhatsApp

通过 Baileys 实现 WhatsApp Web 协议，支持 QR 码登录

Telegram

通过 grammY 支持 Bot API，支持 DM 和群组

Discord

通过 discord.js 支持 DM 和频道消息

iMessage

通过 BlueBubbles macOS 服务器支持

Mattermost

插件方式支持，支持 Bot token 和 WebSocket

Signal

通过 signal-cli 支持隐私优先的消息

快速开始

从零开始，最快的方式在 5 分钟内完成设置并与 AI 代理对话

安装指南

Linux/macOS 安装

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 安装 (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

注意：Windows 推荐使用 WSL2

npm 全局安装

npm install -g openclaw@latest

pnpm 全局安装

pnpm add -g openclaw@latest

系统要求

  • Node.js: >= 22
  • pnpm: 推荐用于源码安装
  • Windows: 推荐使用 WSL2 (Ubuntu)
  • macOS: 需要 Xcode/CLT 用于构建应用

安装后台服务

安装后台服务让 Gateway 持续运行：

openclaw onboard --install-daemon

或手动安装：

openclaw gateway install

服务管理命令：

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw logs --follow

配置指南

配置文件位置

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

配置示例

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": { "*": { "requireMention": true } }
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  },
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "your-long-random-token"
    }
  }
}

配置命令

# 重新配置
openclaw configure

# 添加另一个代理
openclaw agents add <name>

# 配置 Brave Search API
openclaw configure --section web

# 修复无效配置
openclaw doctor

工作原理

了解 OpenClaw 的架构和组件如何协同工作

网络模型

  • 每个主机建议一个 Gateway：唯一允许拥有 WhatsApp Web 会话的进程
  • Loopback 优先：Gateway WS 默认为 ws://127.0.0.1:18789
  • 令牌认证：Wizard 默认生成 gateway token
  • 远程访问：通过 SSH tunnel 或 Tailscale 访问

频道配置

详细了解各个消息平台的配置方法

📱 WhatsApp

使用 Baileys 实现 WhatsApp Web 协议，需要 QR 码配对。

# 登录 WhatsApp
openclaw channels login

配置允许列表：

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"]
    }
  }
}

✈️ Telegram

通过 grammY 支持 Bot API，需要 Bot Token。

创建 Bot：

  1. 在 Telegram 中联系 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 获取 Bot Token

配置：

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

注意：你的第一个 DM 会返回配对码，需要批准后才能回复

🎮 Discord

通过 discord.js 支持，需要 Bot Token。

创建 Bot：

  1. 访问 Discord Developer Portal
  2. 创建新应用并添加 Bot
  3. 获取 Bot Token
  4. 邀请 Bot 到服务器

配置：

{
  "channels": {
    "discord": {
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

🍎 iMessage (BlueBubbles)

推荐使用 BlueBubbles macOS 服务器，支持完整功能。

要求：

  • 运行 BlueBubbles 的 Mac
  • macOS 设备上的 BlueBubbles 服务

配置：

{
  "channels": {
    "imessage": {
      "bluebubbles": {
        "url": "http://your-mac.local:1234",
        "apiKey": "your-api-key"
      }
    }
  }
}

高级功能

流式处理

块流式输出 + Telegram 草稿流式

多代理路由

隔离的代理工作区

订阅认证

Anthropic Claude + OpenAI ChatGPT/Codex OAuth

会话管理

直接聊天合并为共享 main 会话

群组支持

@提及激活，支持切换 /activation always|mention

媒体支持

图像、音频、文档收发

语音笔记

可选转录钩子

macOS 应用

本地 UI + 菜单栏伴侣

iOS 节点

配对并暴露 Canvas 表面

Android 节点

配对并暴露 Canvas + Chat + Camera

安全配置

了解如何保护你的 OpenClaw 部署

安全审计

# 运行安全审计
openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

审计检查内容：

  • 入站访问：DM 策略、组策略、允许列表
  • 工具影响范围：高权限工具 + 开放房间
  • 网络暴露：Gateway 绑定/认证、Tailscale
  • 本地磁盘安全：权限、配置包含

DM 访问策略

支持四种策略：

  • pairing（默认）：未知发送者收到配对码
  • allowlist：阻止未知发送者
  • open：允许任何人 DM
  • disabled：完全忽略入站 DM
{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing"
    }
  }
}

组策略

{
  "channels": {
    "whatsapp": {
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

安全最佳实践

  1. 身份优先：决定谁可以和机器人对话（DM 配对/允许列表）
  2. 范围其次：决定机器人可以在哪里操作
  3. 模型最后：假设模型可被操纵，设计时让操纵有有限的影响范围
  4. 使用现代模型：最新一代模型对提示注入识别更好
  5. 启用沙箱：限制代理的操作范围
  6. 保持更新：定期更新 OpenClaw 到最新版本

故障排除

常见问题

Gateway 无法启动

检查端口是否被占用：

openclaw gateway --force

WhatsApp 未连接

重新登录：

openclaw channels login

DM 没有回复

检查配对状态：

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <message-id>

健康检查

openclaw status
openclaw health
openclaw security audit --deep

命令参考

Gateway 管理

openclaw gateway --port 18789         # 启动 Gateway
openclaw gateway status                  # 检查状态
openclaw gateway stop                    # 停止
openclaw gateway restart                 # 重启
openclaw gateway install                 # 安装服务

消息发送

openclaw message send --target +15555550123 --message "Hello"
openclaw agent --message "Hi" --to <target>

频道管理

openclaw channels login              # 登录频道
openclaw channels list                  # 列出频道
openclaw pairing list                   # 配对列表
openclaw pairing approve <channel> <id> # 批准配对

系统信息

openclaw status                       # 状态
openclaw health                         # 健康检查
openclaw security audit                 # 安全审计
openclaw doctor                         # 修复配置