💡

页面重定向

子章节 "telegram" 的内容包含在主文档中

channels-telegram 重定向到 channels

聊天渠道

OpenClaw 可以在你已经使用的任何聊天应用上与你交流。每个渠道通过网关连接。 文本在所有地方都受支持;媒体和反应因渠道而异。

支持的渠道

  • WhatsApp — 最受欢迎;使用 Baileys,需要 QR 码配对
  • Telegram — 通过 grammY 的 Bot API;支持群组
  • Discord — Discord Bot API + 网关;支持服务器、频道和私信
  • IRC — 经典 IRC 服务器;频道 + 私信,带配对/白名单控制
  • Slack — Bolt SDK;工作区应用
  • Feishu — 通过 WebSocket 的飞书/Lark 机器人(插件,需单独安装)
  • Google Chat — 通过 HTTP webhook 的 Google Chat API 应用
  • Mattermost — Bot API + WebSocket;频道、群组、私信(插件,需单独安装)
  • Signal — signal-cli;注重隐私
  • BlueBubbles — 推荐用于 iMessage;使用 BlueBubbles macOS 服务器 REST API,完整功能支持(编辑、撤回、效果、反应、群组管理 — 编辑功能在 macOS 26 Tahoe 上目前损坏)
  • iMessage(传统) — 通过 imsg CLI 的传统 macOS 集成(已弃用,新设置请使用 BlueBubbles)
  • Microsoft Teams — Bot Framework;企业支持(插件,需单独安装)
  • Synology Chat — 通过传出+传入 webhooks 的 Synology NAS Chat(插件,需单独安装)
  • LINE — LINE Messaging API 机器人(插件,需单独安装)
  • Nextcloud Talk — 通过 Nextcloud Talk 的自托管聊天(插件,需单独安装)
  • Matrix — Matrix 协议(插件,需单独安装)
  • Nostr — 通过 NIP-04 的去中心化私信(插件,需单独安装)
  • Tlon — 基于 Urbit 的消息应用(插件,需单独安装)
  • Twitch — 通过 IRC 连接的 Twitch 聊天(插件,需单独安装)
  • Zalo — Zalo Bot API;越南流行的消息应用(插件,需单独安装)
  • Zalo Personal — 通过 QR 登录的 Zalo 个人账户(插件,需单独安装)
  • WebChat — 通过 WebSocket 的网关 WebChat 界面

注意事项

  • 渠道可以同时运行;配置多个,OpenClaw 将按聊天路由
  • 最快的设置通常是 Telegram(简单的机器人令牌)。WhatsApp 需要 QR 码配对并在磁盘上存储更多状态
  • 群组行为因渠道而异;参见群组
  • 为了安全,强制执行私信配对和白名单;参见安全性
  • Telegram 内部:grammY 注意事项
  • 故障排除:渠道故障排除
  • 模型提供商单独记录;参见模型提供商

渠道配置

使用 CLI 添加和管理渠道:

bash
# 列出配置的渠道
openclaw channels list

# 添加新渠道(交互式)
openclaw channels add

# 添加 Telegram 机器人
openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN

# 添加 Discord 机器人
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN

# 检查渠道健康状况
openclaw channels status --probe

# WhatsApp 登录(QR 码配对)
openclaw channels login

# 删除渠道
openclaw channels remove --channel discord --account work --delete

下一步

非官方中文版本

本网站为非官方中文版本。此项目的目的是为了让国内用户快速了解如何使用 OpenClaw 而汉化的内容。 官方英文文档请访问 docs.openclaw.ai