渠道配置

概述

**渠道（Channels）**允许将工作空间的 Agent 连接到外部 IM 平台，用户可以在 Telegram、WhatsApp、钉钉等社交或企业通讯工具中直接与 Agent 交互。

渠道配置在 APP 端的 IMSettings 组件中进行。

---

已实现渠道（14+ 平台）

全球 IM

企业协作

社交平台

客服平台

自动化与 CRM

完整渠道列表与多模态能力矩阵请参考 渠道列表。

---

接入流程

通用步骤

1. 配置凭证：在 IMSettings 中输入渠道要求的 API Key / Token / Webhook URL
2. 连接性检测：系统自动执行 ConnectivityCheck
3. 检测结果：

4. 上线：检测通过后启用渠道

Telegram 配置示例

1. 在 BotFather 创建 Telegram Bot，获取 Bot Token
2. 在 IMSettings 中选择 Telegram，粘贴 Token
3. 系统自动配置 Webhook
4. 连接性检测通过后即可使用

WhatsApp 配置示例

1. 在 IMSettings 中选择 WhatsApp
2. 系统生成二维码（linked-device 模式）
3. 用 WhatsApp 手机端扫码配对
4. 配对成功后自动重连

---

多模态消息支持

部分渠道支持发送和接收多模态消息：

各渠道的具体多模态能力差异请参考 渠道多模态能力矩阵。

---

对话展示

来自 IM 渠道的对话在 Claw 会话列表中显示对应平台图标（如 Telegram 图标、WeChat 图标），帮助用户区分消息来源。

---

---

详细配置指南

Telegram 配置步骤

1. 在 Telegram 中搜索 @BotFather，发送 /newbot
2. 按提示设置 Bot 名称，获得一个格式如 123456:ABCdef... 的 Bot Token
3. 打开 APP → 设置 → 渠道 → 选择 Telegram
4. 将 Bot Token 粘贴到配置框
5. 点击 保存，系统自动配置 Webhook
6. 连接性检测显示 pass 后即可使用
7. 在 Telegram 中找到你的 Bot，发送消息，Agent 会自动回复

提示：Telegram Bot 支持群组和私聊两种模式。将 Bot 添加到群组后，可以通过 @BotName 提及来触发 Agent 回复。

WhatsApp 配置步骤

1. 打开 APP → 设置 → 渠道 → 选择 WhatsApp
2. 页面显示一个二维码（linked-device 模式）
3. 打开 WhatsApp 手机端 → 设置 → 已关联设备 → 关联设备
4. 用手机扫描二维码
5. 配对成功后，系统自动维持连接（断线自动重连）

注意：WhatsApp 的 linked-device 模式需要手机端 WhatsApp 保持登录状态。如果手机端退出登录，连接会断开。

DingTalk（钉钉）配置步骤

1. 在钉钉开放平台创建企业内部应用
2. 获取应用的 AppKey 和 AppSecret
3. 配置消息接收的 Webhook URL（系统会提供）
4. 打开 APP → 设置 → 渠道 → 选择 DingTalk
5. 填写 AppKey、AppSecret 和 Webhook 配置
6. 保存并测试连接

---

渠道消息的注意事项

---

相关文档

• 渠道列表与能力矩阵 — 完整渠道清单
• Claw 对话概述 — 渠道消息在 Claw 中的展示