渠道接入
通过渠道(channel),你可以从外部聊天应用操作 NomiFun 的伙伴,而不必坐在桌面前。启用一个连接器、粘入凭证、用一次性配对码授权一个聊天用户,从此发给机器人的消息就会分发到伙伴,伙伴的回复也回到同一会话。
默认开启的主 Agent 模式让远程消息由伙伴本尊接待:会话继承伙伴人格与记忆,并接上 Desktop Gateway 工具——你在手机上对话的不是孤立的聊天 bot,而是掌管你整个桌面的 agent。一条「把日报 cron 改到早上 9 点,再说说现在桌面上有什么在跑」的飞书消息即可。
在哪里找
打开 Nomi 页(侧边栏「超级伙伴」,路由 /nomi),选一只伙伴,进入它的 远程连接(Remote) Tab。这里列出该伙伴可用的连接器,每个连接器带一个状态药丸(stopped / connected)、连接成功后的 bot 用户名、当前已授权用户数,以及该渠道的 默认伙伴 / 默认模型 选择器。

已落地的 11+ 个渠道
Telegram、飞书 Lark、钉钉、微信、Slack、Discord、Matrix、Mattermost、Twitch、Nostr、QQ Bot——共 11 个已落地渠道。企业微信 WeCom 在途,将随后续版本上线。
操作步骤
-
找到入口。在 Nomi → 远程连接 中选好要接入的连接器。每个连接器都是一行独立配置,互不影响。
-
填入凭证并启用。按平台填写:
- Telegram:找 @BotFather 创建 bot、保存 token(形如
123456:ABC-DEF…),粘入表单,点 Test 验证(后端会调getMe并回显 bot 用户名),再点 Enable。 - 飞书 Lark / 钉钉:在各自开发者后台创建自建应用,填入 App ID / App Secret(钉钉为 Client ID / Secret,需开启 Stream 模式),点 Enable。
- 微信:直接点 Enable,用微信 app 扫码登录,插件转为
connected。
- Telegram:找 @BotFather 创建 bot、保存 token(形如
-
配对授权用户。配对有两种入口:
- 平台用户首次给 bot 发消息,bot 自动回一个 6 位配对码(10 分钟有效);
- 你在桌面 远程连接 → 待处理配对(Pending pairings) 中粘入或核对该码,点 批准(Approve)。
- 已批准的用户出现在 已授权用户 列表并显示
last active,可随时撤销;撤销会同时清掉该用户的活跃会话,下一条消息从头重新配对。
-
选接待伙伴与默认模型。在连接器面板里为该渠道选定伙伴与默认模型——上图的配置面板即是入口。每个 IM 平台可各绑一只伙伴;切换绑定会重置该渠道的活跃会话,下一条消息由新伙伴接待。未绑定伙伴的渠道行回退到默认伙伴。
从 IM 端能做什么
- 纯文本 双向;流式编辑回复——伙伴的增量更新会被编辑进正在飞行的 bot 消息(微信除外,微信回退为追加发送新消息)。
- 动作按钮——确认 prompt、重试等,渲染为各平台原生的 inline 键盘(Telegram)/ 互动卡片(飞书)或对应等价物。
- 群聊 @ 限定——群里可配置为只在 bot 被
@时才回应。
从 IM 端暂时还做不到:创建 team(请用桌面 / WebUI)、超出平台插件原生能力的文件上传、per-user 工作区选择。
要点与边界
- 每平台一只伙伴。机器人按渠道行绑定伙伴,结构上保证同一个机器人永远不会被绑到第二只伙伴;同一平台可接入多个机器人(比如飞书上为每只伙伴各开一个自建应用)。
- 未绑回退默认伙伴。没有显式绑定的渠道行,按平台级偏好回退,最终回退到默认伙伴;被绑定的伙伴若之后被删除,自动回退默认伙伴并重置会话。
- 记忆全家共享。不管多少机器人、多少渠道,会话数据都汇入同一条共享记忆中枢,换伙伴不丢记忆。技能则按伙伴隔离,各有专属技能库。(按伙伴细分的私有记忆敬请期待。)
- 配对码安全。6 位随机码,TTL 10 分钟,配对服务周期清扫过期码。
常见问题
没绑伙伴的渠道会用哪只伙伴接待? 回退到默认伙伴,仍带人格、记忆与网关工具。
能从 IM 把对话直接登记成一条需求 / issue 吗? 暂不支持入站转需求,这是路线图项目(敬请期待)。完成类通知则走出站 webhook(飞书签名卡 / Slack / HTTP)。
微信为什么不能就地编辑回复? 微信 API 不支持消息编辑,回复以新消息形式投递到同一聊天。
相关
- 伙伴——多伙伴管理、共享记忆中枢与每伙伴技能库。
- 需求平台与 AutoWork——出站完成通知 webhook 与需求登记。
完整文档 → GitHub