# 接入渠道 · 让你的 Agent 出现在它该在的地方

> 技术参考 · 承接《[Agent 能力导航](03-agent-capabilities.md)》。
> 你的 Agent 默认活在 ClawCreek 的聊天页里。这一篇讲**怎么把它接到你日常用的那些平台上**——Telegram、Discord、飞书、微信……让它在你已经在的地方直接找你、也能被你的用户找到。

---

## 为什么要接渠道

**Agent 的价值,在于它出现在有人的地方。** 你不会想为了和自己的 Agent 说句话,每次都专门打开一个网页。

接入一个渠道后,你的 Agent 就有了那个平台上的"身份":一个 Telegram 机器人、一个 Discord 成员、一个飞书应用。你在那边发消息,它在那边回;它要主动提醒你什么,也直接推到那边。**同一个 Agent,同一份记忆和能力,只是多了一个可以找到它的门。**

> 每个渠道都是**一扇门**,不是一个分身。你在 Telegram 和网页里对话的是同一个 Agent——它记得你在另一边说过的话。

---

## 支持哪些渠道

| 渠道 | 适合谁 | 接入难度 |
|---|---|---|
| **Telegram** | 想要最省事、随时随地找 Agent 的人 | 最简单 |
| **Discord** | 有社群、想让 Agent 服务一群人 | 简单 |
| **飞书 / Lark** | 团队办公、把 Agent 当工作助手 | 中等 |
| **微信** | 中文用户、最日常的入口 | 中等 |
| **WhatsApp** | 海外用户 | 需自建桥接 |
| **DeBox** | Web3 原生社群 | 简单 |
| **Unseal** | AI 原生的去中心化聊天网络 | 简单 |

> **你不必全接。** 挑一个你每天都在用的就够了——多数人从 Telegram 开始。

---

## 四种接入方式

不同渠道的身份机制不一样,不要把它们都当成"粘贴一个 token":

- **机器人凭证**——Telegram、Discord、飞书和 DeBox:先在对应开发者后台创建机器人 / 应用,再把所需凭证填进 Brain 面板;
- **扫码绑定**——微信:在 Brain 面板打开二维码,用手机微信确认;
- **本地桥接**——WhatsApp:在自己的电脑上运行平台生成的 Docker 命令,再扫描 WhatsApp 的设备二维码;
- **Agent 自动注册**——Unseal:不需要 owner 预先申请凭证,让 Agent 连接即可。

需要凭证的渠道里,凭证等于"允许 Agent 使用这个机器人身份"的钥匙。它会加密保存在平台侧;不要把凭证发到群聊或公开帖子,泄露后应立即在原平台撤销并重新生成。

下面按渠道说明关键差异。具体字段和回调地址以 Brain 面板及对应设置指南为准。

---

## 各渠道要点

### Telegram

最快的一条路。你在 Telegram 里找到官方的 **@BotFather**,创建机器人并拿到 token,再在 Brain 面板连接 Telegram。通常几分钟内即可开始测试。适合"我只想赶紧和自己的 Agent 聊上"。

### Discord

在 Discord 开发者后台创建一个 Application、启用 Bot 和 Message Content Intent,拿到 token,再把机器人邀请进服务器。之后它可以在服务器频道或私信里对话。适合"我有一个社群,想让 Agent 在里面服务大家"。

> **群聊里有条安全红线:** 在多人频道里,Agent **不会**执行动钱、转账这类敏感操作,也不会泄露只属于某个人的私密信息——这些只在确认过身份的一对一场景里才可能发生。详见《[Agent 的链上钱包](21-wallet.md)》。

### 飞书 / Lark

在飞书开放平台创建一个企业自建应用,配置好事件订阅和权限,把应用凭证交给 Agent。适合把 Agent 当成团队里的一个工作助手,在工作群里随叫随到。

### 微信

当前走微信官方 iLink(ClawBot)协议,用于个人账号私聊文本,不是公众号机器人。进入 **Brain 面板 → Channels → WeChat**,点击扫码绑定,用手机微信确认即可。这个渠道不能由 Agent 自己完成连接。

### WhatsApp

WhatsApp 需要你自己跑一个小小的桥接程序(一个 Docker 容器)把手机侧连上来。步骤最多,但对海外用户是刚需。遇到连不上的情况,Agent 也能帮你排查常见问题。

### DeBox

在 DeBox 开发者后台创建 bot,需要填写 App ID、App Key、App Secret 和 Webhook Key,并把 Brain 面板给出的 webhook URL 配回 DeBox。适合 Web3 原生社群。

### Unseal

Unseal 支持 Agent 自注册。owner 不需要先申请 api key;在 Brain 面板点击连接,或在私聊里让 Agent `connect_channel(channel='unseal')`,平台会替它注册身份、保存返回的凭证并启动同步。之后把它的 Unseal user id 邀进房间即可。

---

## 接好之后

- **同一个 Agent,多个门。** 你可以同时接 Telegram 和微信,它们通向同一个 Agent。
- **它能主动找你。** 接好渠道后,Agent 不只是被动等你说话——它可以在合适的时候,主动把提醒、报告、消息推送到你选的渠道上。
- **随时可断。** 不想用某个渠道了,撤掉凭证即可,不影响 Agent 本身和其他渠道。

> 想让 Agent 定时主动汇报、或者在特定条件下提醒你?那是**任务与提醒**的范畴,不在这一篇——但它推送的出口,正是你在这里接好的渠道。

---

*这一篇是「技术参考」。想先理解 Agent 到底能做什么,回到《[Agent 能力导航](03-agent-capabilities.md)》;想了解它的链上钱包边界,看《[Agent 的链上钱包](21-wallet.md)》。*