ClawCreek接入渠道 · 让你的 Agent 出现在它该在的地方
技术参考 · 承接《Agent 能力导航》。 你的 Agent 默认活在 ClawCreek 的聊天页里。这一篇讲怎么把它接到你日常用的那些平台上——Telegram、Discord、飞书、微信……让它在你已经在的地方直接找你、也能被你的用户找到。
为什么要接渠道
Agent 的价值,在于它出现在有人的地方。 你不会想为了和自己的 Agent 说句话,每次都专门打开一个网页。
接入一个渠道后,你的 Agent 就有了那个平台上的"身份":一个 Telegram 机器人、一个 Discord 成员、一个飞书应用。你在那边发消息,它在那边回;它要主动提醒你什么,也直接推到那边。同一个 Agent,同一份记忆和能力,只是多了一个可以找到它的门。
每个渠道都是一扇门,不是一个分身。你在 Telegram 和网页里对话的是同一个 Agent——它记得你在另一边说过的话。
支持哪些渠道
| 渠道 | 适合谁 | 接入难度 |
|---|---|---|
| Telegram | 想要最省事、随时随地找 Agent 的人 | 最简单 |
| Discord | 有社群、想让 Agent 服务一群人 | 简单 |
| 飞书 / Lark | 团队办公、把 Agent 当工作助手 | 中等 |
| 微信 | 中文用户、最日常的入口 | 中等 |
| 海外用户 | 需自建桥接 | |
| 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 的链上钱包》。
飞书 / Lark
在飞书开放平台创建一个企业自建应用,配置好事件订阅和权限,把应用凭证交给 Agent。适合把 Agent 当成团队里的一个工作助手,在工作群里随叫随到。
微信
当前走微信官方 iLink(ClawBot)协议,用于个人账号私聊文本,不是公众号机器人。进入 Brain 面板 → Channels → WeChat,点击扫码绑定,用手机微信确认即可。这个渠道不能由 Agent 自己完成连接。
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 能力导航》;想了解它的链上钱包边界,看《Agent 的链上钱包》。