在飞书与微信中使用 Hive
有什么用
跳转到“有什么用”IM 连接让你离开 Hive 网页时仍能给房间发消息、收任务结果。它是 Hive Server 与 IM 平台之间的消息通道,不是把 Agent 安装到手机上:任务仍由接入 Hive 的 Agent 运行。
推荐先用 快速上手 确认网页任务能够正常回复,再连接 IM,方便区分 Hive 接入问题和 IM 通道问题。
先选择通道
跳转到“先选择通道”| 能力或边界 | 飞书 | 个人微信 |
|---|---|---|
| 接入方式 | 官方开放平台应用,按扫码流程配置 | 腾讯 iLink 通道,需确认风险 |
| 任务通知 | 卡片、状态标签、可用操作按钮 | 文字通知 |
| 提问作答 | 支持卡片选项等交互 | 通过文字,必要时转到网页 |
| 图片和文件 | 支持双向收发 | 当前只支持文字 |
| 适用范围 | 按连接配置使用私聊和支持的群场景 | 只支持本人私聊文字 |
| 默认状态 | 需要主动连接 | 默认不启用,连接前必须确认风险 |
个人微信没有面向第三方的公开开放平台,此通道可能违反平台规则,有被限制或封号的风险;消息内容会经过微信服务器。不要把它当成官方企业微信集成,也不要用于无法承受账号风险的场景。
第一步:从网页连接
跳转到“第一步:从网页连接”
隔离演示界面截图(裁切),仅展示入口,不是 IM 扫码授权或送达实测。
- 用房主身份打开网页,在左侧快捷操作点击「连接 IM」。它不在成员面板底部的邀请按钮中。
- 选择飞书,使用飞书扫码,按页面提示新建或选择应用并确认权限。
- 如果选择个人微信,先阅读风险提示并勾选确认,再扫码并在手机上确认登录。若管理员禁用了该通道,界面不会提供入口。
- 等网页显示连接结果,在对应私聊中发送
/help。微信需要你先发一条消息,之后才能接收推送。 - 从
/room或连接设置核对当前房间,避免向错误的项目派任务。
飞书扫码的人作为房主身份发消息。房主登录和绑定账号应由本人操作,不要把二维码发给普通访客代扫,也不要把它当成多人邀请入口。
第二步:选房间、选 Agent,再发消息
跳转到“第二步:选房间、选 Agent,再发消息”| 命令 | 用途 |
|---|---|
/help |
查看当前通道支持的操作 |
/room |
查看或切换当前发消息的房间 |
/who |
查看成员和谁在忙 |
/to |
选择当前房间的默认对话 Agent |
/level |
设置推送档位 |
/scope current / /scope all |
只收当前房间 / 接收本人所在的所有房间 |
/lang |
调整 IM 提示语言 |
/web |
在私聊获取网页入口 |
在飞书中,这些操作也会提供卡片或菜单。为当前房间用 /to 选好对象后,不带 @ 的普通消息可发给它;直接回复某个 Agent 的卡片也能确定接收者。唯一匹配的 @ 简写可以补全,但第一次使用仍建议核对完整名称。
没有默认对象或明确目标时,房间的主 Agent 规则可能接管。不要在普通句子中随便提一个近似名字来试探路由,先用 /to 或明确 @。
第三步:配置推送,处理任务通知
跳转到“第三步:配置推送,处理任务通知”推送档位包括「与我相关」「IM 任务」「全部 Agent」「全部消息」。接收范围默认覆盖本人所在的所有房间,可用 /scope current 收窄。收通知的范围与发送消息的当前房间是两件事。
- 飞书卡片会标出房间与发送者,并区分进度、结果、失败、结果未知和待批准等状态。
- 本人任务的中途进度也可能推送;进度说明不是最终完成证明。
- 支持的卡片可以直接回答选项、批准、重试或继续;操作仍经过 Hive 权限和任务状态校验。
- 回复跨房间的卡片会发到卡片所属房间,不能仅凭自己当前的
/room判断回复位置。 - 微信用文字表达这些信息;不能操作的交互转到网页完成。
为了避免重复提醒,连接 IM 后可把网页「设置 → 通知 → 任务提醒」设为「只在页面内」。这个设置不会关闭 IM 推送。
图示:消息通道不改变执行位置
跳转到“图示:消息通道不改变执行位置”这是原创消息通道示意,不是飞书或微信截图。IM 连接和房主设备登录都不意味着手机拥有 Server 电脑的终端权限;管理电脑还需要相应授权。任务最终在 Agent 所在电脑执行。
网页登录票和附件边界
跳转到“网页登录票和附件边界”飞书私聊中的「在网页查看」或 /web 入口可以带一次性房主登录票,24 小时内有效。需要在另一设备登录时重新获取,不能复用已经消费的票,也不要转发给别人。群卡片不带房主登录票;群里的 /web 不提供私聊登录入口。
飞书支持图片和文件双向收发,具体仍受附件格式、大小、平台接口及 Runtime 读取能力约束。微信当前只有文字;要上传或下载文件,请到 网页附件功能。
注意事项与排查
跳转到“注意事项与排查”- Server 和 Agent 必须保持可达。扫码成功不代表电脑睡眠后仍能接单;「设置 → 这台电脑」的保持在线功能在支持系统和满足电源策略时阻止空闲睡眠,不保证合盖仍在线。
- 收不到通知时先看网页 IM 状态、推送档位和接收范围;微信先检查是否发过一条私聊消息,连接失效时按网页提示重新登录。
- 用
HIVE_IM_WECHAT=0启动 Server 可整体关闭微信通道;这不是在 IM 里发送的命令。 - IM 消息和附件会经过对应平台,不要发送凭据或不允许外传的资料。绑定撤销、房主设备授权等安全边界见 权限指南 和 安全参考。
- 本页按当前源码描述能力,未扫描真实二维码、操作真实应用授权或验证平台送达;实际问题见 排障指南。