OpenClaw 平台插件配置:连接 20+ 聊天平台

OpenClaw 最强大的功能之一是可以在你已经在使用的聊天平台上工作。本文将详细介绍如何配置各种聊天渠道,让你的 AI 助手无处不在。

支持的平台列表

OpenClaw 支持 20+ 聊天平台,可以同时运行多个渠道,OpenClaw 会自动根据来源路由对话。

主流平台

平台 接入方式 说明 难度
WhatsApp Baileys 最流行,需 QR 扫码配对 ⭐⭐
Telegram Bot API 最简单,支持群组
Discord Bot API 支持服务器和频道 ⭐⭐
Slack Bolt SDK 工作区应用 ⭐⭐
Google Chat HTTP Webhook 简单易用 ⭐⭐
Microsoft Teams Bot Framework 企业支持 ⭐⭐⭐

其他平台

  • Signal:通过 signal-cli,隐私优先
  • iMessage:推荐使用 BlueBubbles(已废弃传统 imsg CLI)
  • Feishu(飞书):WebSocket 插件
  • Matrix:去中心化通信协议
  • IRC:经典 IRC 服务器
  • LINE:LINE Messaging API
  • Mattermost:Bot API + WebSocket
  • Nextcloud Talk:自托管聊天
  • Nostr:去中心化 DM
  • Synology Chat:Synology NAS
  • Tlon:基于 Urbit 的通讯器
  • Twitch:聊天室
  • Zalo / Zalo Personal:越南流行通讯工具

Telegram 配置(最快入门)

Telegram 是最快的入门方式,只需要几步:

步骤 1:创建 Bot

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 按照提示设置名称和用户名
  4. 获取 Bot Token(格式:123456789:ABCDefGHIjKL...

步骤 2:配置 OpenClaw

编辑配置文件 ~/.openclaw/openclaw.json

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN_HERE"
    }
  }
}

步骤 3:重启网关

$ openclaw gateway restart

步骤 4:开始聊天

在 Telegram 中搜索你的机器人用户名,开始对话!

WhatsApp 配置

WhatsApp 是最流行的平台之一,但配置稍复杂:

步骤 1:配置渠道

编辑配置文件:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "authType": "qr"
    }
  }
}

步骤 2:扫码配对

运行配对命令:

$ openclaw channel pair whatsapp

终端会显示 QR 码,用 WhatsApp 扫码完成配对。

Discord 配置

步骤 1:创建 Discord Bot

  1. 访问 Discord 开发者门户
  2. 创建新应用
  3. 在 Bot 选项中创建 Bot
  4. 复制 Bot Token
  5. 启用以下权限:服务器、频道、DM

步骤 2:邀请 Bot 到服务器

  1. 在 OAuth2 页面配置权限
  2. 生成邀请链接
  3. 访问链接邀请 Bot 到你的服务器

步骤 3:配置 OpenClaw

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN"
    }
  }
}

Slack 配置

步骤 1:创建 Slack App

  1. 访问 Slack API
  2. 创建新 App
  3. 配置 Bot Token Scopes(需要以下权限):
    • chat:write
    • channels:history
    • im:history
    • groups:history
  4. 安装到工作区
  5. 复制 Bot Token(xoxb-...

步骤 2:配置 OpenClaw

{
  "channels": {
    "slack": {
      "token": "xoxb-YOUR-TOKEN-HERE"
    }
  }
}

Feishu(飞书)配置

飞书需要单独安装插件:

步骤 1:安装插件

$ npm install -g @openclaw/channel-feishu

步骤 2:创建飞书应用

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 启用机器人功能
  4. 获取 App ID 和 App Secret

步骤 3:配置 WebSocket

{
  "channels": {
    "feishu": {
      "appId": "YOUR_APP_ID",
      "appSecret": "YOUR_APP_SECRET",
      "encryptKey": "YOUR_ENCRYPT_KEY"
    }
  }
}

多渠道同时运行

OpenClaw 可以同时运行多个渠道,配置文件示例:

{
  "channels": {
    "telegram": {
      "token": "TELEGRAM_BOT_TOKEN"
    },
    "whatsapp": {
      "enabled": true,
      "authType": "qr"
    },
    "discord": {
      "token": "DISCORD_BOT_TOKEN"
    }
  }
}

DM 安全策略

OpenClaw 连接到真实的通讯平台,为了安全,默认对陌生私信使用配对策略:

配对模式(默认)

陌生人会收到配对码,机器人不会处理消息,直到你批准:

# 查看待批准的配对
$ openclaw pairing list

# 批准配对
$ openclaw pairing approve telegram 123456

# 拒绝配对
$ openclaw pairing deny telegram 123456

开放模式

如果你想接收公共私信,需要显式启用:

{
  "channels": {
    "telegram": {
      "token": "YOUR_TOKEN",
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

⚠️ 警告:开放模式存在安全风险,仅在受信任的环境中使用。

渠道限制

不同渠道的功能支持不同:

  • 文本消息:所有渠道都支持
  • 媒体:大部分渠道支持,格式可能不同
  • 回复:大部分渠道支持
  • 反应:部分渠道支持(Discord、Slack 等)
  • 群组:大部分渠道支持

故障排查

常见问题

Telegram Bot 无法接收消息

  • 检查 Bot Token 是否正确
  • 确认 Bot Token 是从 BotFather 获取的
  • 检查网关日志:openclaw gateway logs

WhatsApp QR 扫码失败

  • 确保网络可以访问 WhatsApp 服务器
  • 尝试重新配对:openclaw channel pair whatsapp

Discord Bot 无响应

  • 检查 Bot 权限是否足够
  • 确认 Bot 已邀请到服务器
  • 检查 Discord Gateway 状态

总结

OpenClaw 的多渠道支持让你可以在任何平台上使用你的 AI 助手。Telegram 最简单适合快速上手,WhatsApp 最流行适合日常使用,Discord/Slack 适合团队协作。

在下一篇文章中,我们将学习如何使用 OpenClaw 的工具系统,让 AI 助手能够执行更复杂的任务。

相关资源

发表回复

后才能评论