消息渠道配置指南

把个人微信、企业微信或中国区飞书连接到 ClawPi，从外部聊天向这台电脑发送任务。每个平台可以添加多个账号。先完成账号连接，再批准发送者配对；需要操作电脑时另外授权。

开始前准备

安装并登录客户端，创建一个可用工作区，保持电脑运行和联网。准备好对应平台的账号或应用管理权限；不要把密钥发给聊天机器人。

添加账号

在客户端打开“消息渠道”，找到目标平台卡片并点击“添加账号”。按下方指南完成配置，直到账号卡显示“已连接”。凭据字段只写，提交后不会回显。

平台	需要准备	详细步骤
个人微信	手机微信扫码并确认	个人微信
企业微信	智能机器人 Bot ID 和 Secret	企业微信
飞书	企业自建应用 App ID 和 App Secret	飞书

企业微信和飞书通过出站长连接接收事件，不需要公网回调 URL。每个独立飞书连接账号使用独立应用，避免多个连接分摊消息。

配对发送者并使用渠道

1. 从目标平台向机器人发一条简单文字任务。未知发送者会收到短配对码。
2. 回到电脑端“消息渠道 → 待配对”，核对来源身份与配对码。配对请求 15 分钟内有效。
3. 选择允许这个会话访问的工作区，点击“批准”；不认识的发送者选择“拒绝”。
4. 确认“已配对会话”中出现对应记录，通过“打开本机会话”查看任务和结果。

批准后会直接处理第一条消息，不用再发一次。拒绝或过期的请求不会把内容交给模型。没有待配对请求时，先检查账号连接、平台事件配置与发送者身份。

私聊配对会话与发送者。支持的群消息必须 @机器人，每位群成员分别配对；同一群内已批准成员共享群会话，不应把仅限单人的资料混入其中。同一会话消息按顺序处理，不同会话可并发。

接收生成的文件

从已配对会话明确要求生成并返回文件，完成后在平台聊天中核对真实附件。支持格式、版本要求与发送状态见文件与附件。文字里出现本地路径不代表已经发送；“平台已接收”不等于对方已读。

授权远程 Windows 控制

远程控制默认关闭。在对应“已配对会话”中开启“允许远程电脑操作”，阅读截图会发送给当前模型服务的提示后再确认。完整的授权、取消与限制见远程电脑操作。

普通对话、账号已连接和发送者已配对均不自动授予电脑权限。渠道会话不能通过外部消息升级为完全访问。

重连、移动或删除

操作	影响
停用 / 启动 / 重新连接账号	只作用于该账号，不影响其他账号
修改会话工作区	后续任务使用新会话环境，原会话保留为本地历史
删除配对	移除成员批准与远程权限，保留历史；下次消息重新申请配对
删除账号	停止连接，删除本机凭据、待处理消息状态与绑定；此前会话保留为本地历史

隐私与送达

账号页面不展示 Secret、回复令牌或完整外部身份标识。配对与工作区绑定决定外部会话能交给这台电脑的任务范围；授权前先核对联系人。

任务执行与平台送达是不同阶段。先看本机会话，再检查消息或附件状态。异常处理见常见问题与排障。