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

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

为什么要接渠道

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

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

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

支持哪些渠道

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

四种接入方式

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

• Agent 私聊连接（机器人凭证）——Telegram、Discord:先在对应开发者后台创建机器人并拿到 token,再在与 Agent 的一对一私聊里让它调用 connect_channel 接入（可把 token 一并交给工具;Telegram 也可先 store_api_key 再连接）。Brain → Channels 只显示状态或斜体 "Tell Agent to connect"——没有 token 填写表单;
• Brain 面板表单（机器人凭证）——飞书 / Lark、DeBox:在对应开发者后台创建应用后,把所需凭证 / webhook 字段填进 Brain 面板;
• 扫码绑定——微信:在 Brain 面板打开二维码,用手机微信确认;
• 本地桥接——WhatsApp:在自己的电脑上运行平台生成的 Docker 命令,再扫描 WhatsApp 的设备二维码;
• Agent 自动注册——Unseal:不需要 owner 预先申请凭证,让 Agent 连接即可。

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

下面按渠道说明关键差异。飞书 / DeBox / 微信等有面板表单的渠道,具体字段和回调地址以 Brain 面板及对应设置指南为准;Telegram / Discord 以 Agent 私聊连接为准。

各渠道要点

Telegram

最快的一条路。你在 Telegram 里找到官方的 @BotFather,创建机器人并拿到 token,然后在 ClawCreek 与 Agent 的一对一私聊里告诉它连接 Telegram——Agent 会调用 connect_channel(channel='telegram', token=...)（或先 store_api_key(service='telegram', …) 再连接）。Brain → Channels 里 Telegram 只显示接入状态或斜体 "Tell Agent to connect"，没有 Connect 按钮或 token 输入框。通常几分钟内即可开始测试。适合"我只想赶紧和自己的 Agent 聊上"。

Discord

在 Discord 开发者后台创建一个 Application、启用 Bot 和 Message Content Intent,拿到 token,把机器人邀请进服务器,再在与 Agent 的一对一私聊里让它用 connect_channel(channel='discord', token=...) 接入。Brain → Channels 同样只显示状态或 "Tell Agent to connect"，没有 token 表单。之后它可以在服务器频道或私信里对话。适合"我有一个社群,想让 Agent 在里面服务大家"。

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

飞书 / 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 邀进房间即可。

Narra Messenger

Narra Messenger 是走 Gateway polling 的标准 Channel。owner 绑定后,平台会保存 Narra runtime 返回的绑定信息和 bearer 凭证,由独立的 narra_channels 进程领取 active binding、轮询 Gateway,再把收到的 invocation 转成同一个 Agent 的 chat_message 事件。

Narra 收到的附件会以 attachments[] 进入 Agent,当前约定的类型包括 image、file 和 audio。ClawCreek 会按 download_url 下载附件;其中 audio 默认只作为附件交给 Agent,不会走 OpenAI STT。若开启 LLM_AUDIO_INPUT_ENABLED=true 且所选模型声明支持 audio input,音频附件会作为多模态 audio block 一起传给核心 LLM;模型不支持时会给出正常的不支持提示。

Agent 还可以在启用 NARRA_CLI_ENABLED=true 后使用 narra_cli tool 执行策略校验过的 Narra Messenger 命令,例如读取消息、发送消息、下载附件或使用绑定范围内的语音转写能力。CLI endpoint、token、配置文件路径等控制字段不从 LLM 参数透传,只使用平台保存的绑定配置。

接好之后

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

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

这一篇是「技术参考」。想先理解 Agent 到底能做什么,回到《Agent 能力导航》;想了解它的链上钱包边界,看《Agent 的链上钱包》。