连接企业微信

ClawPi 使用企业微信智能机器人的长连接能力，支持私聊与群内 @机器人。你需要有权创建智能机器人的企业微信账号，以及保持在线的 ClawPi 客户端。

创建智能机器人

1. 在企业微信中打开智能机器人入口，选择创建机器人并手动配置。找不到入口时，检查客户端版本并请企业管理员确认创建权限。
2. 选择“API 模式创建”，把连接方式设为“使用长连接”。
3. 设置机器人名称与可见范围，取得 Bot ID 和 Secret，保存配置。

入口位置随企业微信版本可能不同，可对照腾讯官方长连接配置说明。ClawPi 使用官方企业微信智能机器人 SDK连接，不需要填写公网回调 URL。

填入 ClawPi

打开“消息渠道 → 企业微信 → 添加账号”，填写以下两个字段并提交：

ClawPi 字段	来源	注意
botId	智能机器人 API 配置中的 Bot ID	使用机器人 ID，不是企业 ID
secret	同一个机器人的 Secret	密钥只写入，不会在账号卡回显

等待账号卡显示“已连接”。Secret 只输入本机配置窗口，不要发送给机器人或放进任务提示词。普通群机器人的 Webhook 地址不能替代这组凭据。

验证私聊与群聊

1. 用可见范围内的成员账号打开机器人，发一条文字消息。
2. 在 ClawPi 的“待配对”中选择工作区并批准，核对结果回到原会话。
3. 需要群聊时，把机器人加入允许的群并 @机器人 发消息；其他成员需要各自完成配对。

详细的配对、工作区变更和删除行为见连接与配对。

常见问题

现象	处理
凭据校验失败	检查 Bot ID 与 Secret 来自同一机器人，去除首尾空格
一直连接中	检查平台是否启用长连接及电脑网络是否允许出站连接
成员找不到机器人	检查机器人可见范围与企业管理员授权
群里没有回复	确认机器人在群内、已被 @，且发送者已配对

密钥变更后需要更新对应连接；不要同时删除其他正常账号。仍有问题时查看排障指南。