OpenClaw ACP Harness 系列 07:多平台集成——飞书/Discord/Telegram 接入实战

AI 助手在哪里工作，取决于你在哪里工作。本篇手把手接入三个最常用的平台。

一、接入原理

如图所示，所有渠道通过 OpenClaw Gateway 统一接入，AI 核心只有一个：

消息渠道 → Webhook → OpenClaw Gateway → AI Core → 回复渠道

每个渠道配置独立的 Bot Token，OpenClaw 自动识别来源并路由。

二、飞书接入

2.1 创建飞书机器人

1. 飞书开发者后台：open.feishu.cn
2. 创建企业自建应用
3. 填写应用名称和描述
4. 开启机器人功能
5. 添加权限：
   - im:message（发送消息）
   - im:message:receive_v1（接收消息）
   - im:chat（群聊管理）
6. 发布应用

2.2 配置 Webhook

# openclaw 配置文件（config.yaml 或环境变量）
channels:
  feishu:
    enabled: true
    appId: "cli_xxxxxxxxxxxx"
    appSecret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    verificationToken: "xxxxxxxxxxxx"
    encryptKey: "xxxxxxxxxxxx"# 可选，启用加密
    webhookPath: "/webhook/feishu"# Gateway 接收路径

2.3 飞书特有能力

// 发送飞书卡片消息（富文本）
message({
action: "send",
channel: "feishu",
card: {
config: { wide_screen_mode: true },
elements: [
      {
tag: "div",
text: { content: "**重要通知**", tag: "lark_md" }
      }
    ]
  }
})

// 发送文件
message({
action: "send",
channel: "feishu",
filePath: "/mnt/d/project/article/report.pdf"
})

// 在 Thread 中回复
message({
action: "thread-reply",
threadId: "om_xxx",
message: "这是在消息线程中的回复"
})

三、Discord 接入

3.1 创建 Discord Bot

1. Discord Developer Portal：discord.com/developers
2. New Application → 填写 Bot 名称
3. Bot → Reset Token（复制 Token）
4. Privileged Gateway Intents：
   ✅ MESSAGE CONTENT INTENT
   ✅ SERVER MEMBERS INTENT
5. OAuth2 → URL Generator：
   选择 bot + applications.commands 权限
   生成邀请链接，将 Bot 邀请到服务器

3.2 配置

channels:
  discord:
    enabled: true
    token: "MTxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    guildId: "1234567890"# 可选，限定服务器

3.3 Discord 特有能力

// Thread 模式：ACP Harness 的理想环境
sessions_spawn({
runtime: "acp",
agentId: "claude-code",
mode: "session",
thread: true// 自动在 Discord 创建 Thread
})

// 表情反应
message({
action: "react",
messageId: "xxx",
emoji: "✅"
})

// 使用 Slash Commands
// 在 Discord 中输入 /task 直接触发特定功能

四、Telegram 接入

4.1 创建 Telegram Bot

1. 在 Telegram 中找到 @BotFather
2. 发送 /newbot
3. 输入 Bot 名称和用户名（必须以 bot 结尾）
4. 复制 Token（格式：1234567890:ABCDxxxx）
5. 可选：/setcommands 设置命令菜单

4.2 配置

channels:
  telegram:
    enabled: true
    token: "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi"
# 可选：限制只响应特定用户
    allowedUserIds: [123456789]

4.3 Telegram 特有能力

// 发送语音消息
tts({ text: "你的提醒：会议10分钟后开始" })
// 配合 [[audio_as_voice]] 标记以语音消息形式发送

// 发送图片（不压缩）
message({
action: "send",
channel: "telegram",
media: "/path/to/image.png",
forceDocument: true// 发为文件，避免压缩
})

// 发送带按钮的消息（需要 inlineButtons 权限）
message({
action: "send",
message: "确认执行这个操作？",
// 按钮配置（如果渠道支持）
})

五、多渠道统一管理

// 向特定渠道发消息
message({ action: "send", channel: "feishu", message: "飞书消息" })
message({ action: "send", channel: "discord", message: "Discord 消息" })
message({ action: "send", channel: "telegram", message: "Telegram 消息" })

// 向当前渠道回复（自动识别来源）
// 直接在 AI 回复中包含内容即可，OpenClaw 自动路由

六、群聊 vs 私聊行为差异

七、接入建议

下一篇：打造你的专属 Proactive Agent——从零到生产