#消息平台

在“助手 → 设置 → 消息平台”中，你可以为助手同时绑定飞书 / Lark 机器人和个人微信 ClawBot。各平台拥有独立的对话流，但共用同一个助手的记忆、技能和工作区文件。

为了保障权限边界，机器人只响应助手所有者本人的私聊消息，不会响应群聊或其他人的私信。

#飞书 / Lark 接入

同一助手在飞书与 Lark 之间二选一，支持直接扫码一键建应用，也可以手工填入已有企业自建应用的凭据。

#方式一：扫码快速配置

1. 在飞书 / Lark 行点击“连接”，生成配置二维码。
2. 用手机飞书 / Lark 扫码，在官方页面完成应用创建与授权。
3. 核对扫码账号并保存。若由管理员代为配置凭据，还需由助手所有者本人完成下方的“绑定码确认”。
4. 在飞书开放平台后台完成应用版本发布与可见范围审批。

#方式二：手工填写 App ID 与 Secret

在飞书或 Lark 开放平台创建企业自建应用并开启“机器人”能力，填入 App ID 与 App Secret。应用至少需要开通以下权限：

• im:message.p2p_msg:readonly（读取私聊消息）
• im:message:send_as_bot（以机器人身份发消息）
• im:resource（读写图片与文件资源）
• im:message.reactions:write_only（消息表情回复）

在“事件与回调”中选择使用长连接接收事件，添加 im.message.receive_v1 事件，最后发布应用版本。

#确认所有者本人身份

凭据保存后点击获取 6 位数字绑定码（注意保留前导零），用助手所有者本人的飞书账号向机器人私聊发送该数字，再回到企智盒设置页点击确认该账号为本人。管理员可以代填应用凭据，但不能替所有者点击确认。

#个人微信接入

1. 打开微信配置详情，点击“生成微信二维码”。
2. 由助手所有者本人使用支持 ClawBot 的微信扫码并完成手机端授权（若提示需要验证码，在详情弹窗内填入提交）。
3. 助手所有者在自己的企智盒网页端点击“确认此微信账号为本人”后正式生效。

微信接入仅用于你本人与助手私聊交互，不涉及接管微信号的好友、群聊、通讯录或朋友圈。

#日常对话与命令

私聊支持直接发送文字、图片和各类办公文件。如果上一条任务还在运行，新发的消息会自动作为补充要求合并进去。

飞书 / Lark 支持单条消息附带多个文件或富文本图文混排（同名附件会自动加序号保留；若其中某个附件下载失败，系统会明确报错而不会漏文件盲跑）。

当某个平台会话距离上次任务结束和最近一次主动推送都已超过 24 小时，你再发消息时会自动开启新会话。消息平台产生的会话在 Web 端可查看完整执行过程与工具调用，但保持只读；如需追问或取消，请直接回到对应手机端操作。

#主动投递与定时任务

无论是在网页端对话、手机私聊还是定时任务里，只要在指令中交代助手把结果发到你的飞书或微信，助手就会调用 send_message 投递正文、图片或成品文件：

核对完日报后，把汇总摘要和生成的日报 Excel 发到我的微信。统计图按原生图片发，Excel 按文件附件发。

使用投递时的注意事项：

• 收件人固定：只能发给当前助手已绑定的所有者本人，如需同时发往飞书和微信，让助手分别调用两次即可。
• 附件版本锁定：文件在发送那一刻即固定快照，后续在工作区修改或删除原文件，不影响聊天记录里的历史附件下载与续聊。
• 收到后直接追问：投递送达的内容会自动汇入该平台的当前会话，你可以直接在手机上回复“解释一下第二项差异”或“把刚发的表格改成按部门汇总”。
• 微信上下文有效期：微信推送依赖你最近一次给机器人发消息时产生的上下文令牌。刚绑好微信还没聊过天时，请先在微信里随便给机器人发句话；如果长期没有互动导致令牌过期，推送会明确报错。
• 定时任务投递写法：定时任务没有隐式的“自动通知开关”，需要推送时直接在任务指令里写清触发条件、目标平台和发送内容（例如“每天巡检完成后，把摘要和报告发到我的飞书；如果没有异常则只发一句正常说明”）。

#网络与审批说明

飞书 WebSocket 长连接与微信 iLink 通道均由企智盒进程主动发起连接，不需要企业开通公网入站端口或回调地址，只需部署机器能正常访问飞书开放平台或微信接口及媒体 CDN。

由于手机私聊交互无法弹出网页端的审批确认框且不支持远程操作浏览器画面，绑定消息平台后助手会自动开启免审批；遇到需要人工扫码登录网页或填写在线表单的任务，请在电脑 Web 工作区中发起。