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 验证。