跳到主要内容
本页内容

IM 渠道(飞书 / Slack)

Kaya 可以把 IM 消息接到本机,由本机 LLM 处理并流式回复。当前开放飞书与 Slack;企业微信入口置灰「即将支持」,存量配置保留。

IM 渠道需要保持登录。使用自备 API Key、Ollama 或适用的自有 OAuth 时,无需有效订阅,订阅到期或取消不会停止渠道;登出仍会停止渠道。使用内置云模型的 IM 路线仍需有效订阅或试用,渠道白名单与授权边界不变。

开启路径#

  • 打开 ⚙ 设置 → IM 渠道(也可从系统菜单直达),选择平台。

  • 飞书:推荐点「飞书扫码接入」,手机扫码确认后自动创建应用并回填 App ID 与创建者 open_id;App Secret 直接进系统钥匙串。也可在飞书开放平台手动创建应用。

  • Slack:仅手动配置。到 api.slack.com/apps 创建 app,开启 Socket Mode 并生成 xapp- App-Level Token(connections:write),添加 chat:write,订阅 message.channels / message.groups / message.im / message.mpim,安装到 workspace 后取得 xoxb- Bot Token,把双 token 填入设置。

  • 配置 allowlist:每行一个用户 ID。飞书填 ou_ 开头 open_id,Slack 填 U 开头 Member ID;名单为空无法启动,名单外消息直接丢弃。

  • 点 启动渠道。飞书需开通 im:message 权限并发布版本;Slack 需核对 scope 与事件订阅。

飞书、Slack 都使用官方长连接,不需要公网 IP 或回调服务器。

工具与记忆边界#

  • IM 与桌面 chat 走同一套五道隐私 pipeline;terminal_write 仍受 coding 模式总闸和授权卡约束。

  • IM 工具与桌面基本对齐,可读终端、任务清单与已生效记忆。

  • 不开放定时任务管理、跨 Agent 任务队列和 AI 创建任务。

  • 可以在 IM 里说「记住:……」,按意图与证据自动裁决,合格内容直接生效;归档时明确说明未生效,拒收时不会假装已保存。记忆检索输出同样经过脱敏。

  • 会话映射与对话上下文保存在 ~/.kaya/;IM 收发行暂未接入审计 JSONL。

**IM 的文件读取有额外边界:**即使文件在 ~/.kaya/ 中,也不能通过 IM 的命令读取记忆、审计、会话、网关隐私明细、凭据配置等敏感内部存储;记忆内容只能经记忆工具脱敏后返回。云端上传状态及其临时文件不可读,用量事件文件仍可按原边界读取。这是 IM 渠道回合的专门限制,不能把它套到浏览器远程或跨机对话:浏览器远程复用桌面上下文,跨机对话本就不开放 shell 读取工具。

镜像与授权卡#

  • 桌面 → IM 镜像默认关闭。开启后桌面消息流推送到指定 IM 聊天,IM 回复也同步回桌面;新会话自动迁移镜像。

  • terminal_write 或 Agent 配置修改需要授权时,飞书 / Slack 会显示批准 / 拒绝卡片,与桌面共享授权状态,操作者必须在 allowlist 内。

  • 批准后会自动补一个回合重试刚才暂停的操作,无需手动唤醒。

  • 镜像开启时,Agent 等输入、跑完、上线、退出会主动通知;自动回合只回显摘要,同一事件不重复推送。

企业微信的镜像回显和主动通知依赖活跃回调,纯桌面场景可能丢失。本轮仅飞书完成真机验证,Slack 尚未经真机 workspace 验证。

下一步#