微信渠道接入使用教程
一、微信渠道简介
微信渠道可以理解为用户和 3ChatClaw 中的 Agent 在微信里对话。
接入微信个人渠道后，用户可以通过个人微信向 Agent 发消息，Agent 也会在微信里回复。配置完成后，微信好友或微信群中的消息可以转发给 3ChatClaw 中的 Agent 处理，并由 Agent 自动回复。
微信渠道本身负责连接微信和 3ChatClaw。真正理解消息、调用技能、生成回复的是 3ChatClaw 中的 Agent。
注意：接入微信渠道后，需要保持 3ChatClaw 和对应 Agent 一直打开并在线。
如果 3ChatClaw 退出、电脑休眠、网络断开，或 Agent 没有处于可响应状态，微信里的消息可能无法被及时处理。
二、前置条件
接入微信渠道前，请先确认以下事项：
-
3ChatClaw 已正常打开
微信渠道需要依赖 3ChatClaw 接收和处理消息。 -
Agent 已处于在线状态
微信发来的消息会交给 Agent 处理，请确认 Agent 可以正常对话。 -
已准备可扫码授权的个人微信账号
微信个人渠道需要使用手机微信扫描二维码并确认授权。 -
电脑和网络保持稳定
如果电脑休眠、断网或 3ChatClaw 关闭，微信渠道可能无法继续收发消息。
三、扫码登录微信渠道
推荐通过 3ChatClaw 控制台完成微信渠道扫码登录。
操作步骤
- 打开 3ChatClaw Web。
- 在左侧列表中点击
频道。 - 选择
微信。 - 打开
已启用。 - 点击
获取登录二维码。 - 等待二维码显示。
- 使用手机微信扫描二维码。
- 在手机上确认授权。
- 授权成功后，
Bot Token会自动填入表单。 - 点击
保存。
保存完成后，微信个人渠道即配置成功。只要 3ChatClaw 和 Agent 保持在线，用户就可以通过微信向 Agent 发送消息并获得回复。
建议关闭
显示思考过程和显示工具消息，只保留最终回复内容
四、微信渠道常用配置说明
| 配置项 | 说明 |
|---|---|
| 已启用 | 开启后，微信渠道才会开始接收和处理消息。 |
| Bot Prefix | 触发 Bot 的前缀。填写后，只有带指定前缀的消息才会交给 Agent 处理。 |
| 显示工具消息 | 开启后，可在对话中看到 Agent 调用工具的过程消息。 |
| 显示思考过程 | 开启后，可在对话中看到 Agent 的思考过程。 |
| 获取登录二维码 | 首次登录或 Token 失效时，点击后生成微信扫码登录二维码。 |
| Bot Token | 微信 iLink 授权成功后生成的 Token。通过控制台扫码时会自动填入。 |
| Token 文件路径 | Bot Token 本地保存路径，默认是 ~/.qwenpaw/wechat_bot_token。 |
| 媒体文件目录 | 图片、语音、文件等媒体内容的本地保存目录。 |
| 消息合并 | 开启后，短时间内连续收到的多条消息会合并后再交给 Agent 处理。 |
| 私聊策略 | 控制私聊消息是否直接交给 Agent 处理。 |
| 群聊策略 | 控制群聊消息是否直接交给 Agent 处理。 |
| 需要 @提及 | 开启后，群聊里只有 @Bot 的消息才会被处理。 |
五、使用建议
1. 保持 Agent 在线
微信渠道只是把微信消息接入 3ChatClaw，真正回复消息的是 Agent。请保持 3ChatClaw 运行，并确认对应 Agent 可以正常响应。
2. 首次建议先用私聊测试
微信渠道保存后，可以先用另一个微信号给当前账号发一条简单消息，确认 Agent 是否能正常收到并回复。
3. 群聊建议开启 @提及
如果接入微信群，建议开启 需要 @提及，避免群内普通聊天被频繁交给 Agent 处理。
4. 谨慎开启显示思考过程
为了防止回复内容过长，建议关闭 显示思考过程，只保留最终回复内容。
5. Token 失效后重新扫码
如果微信渠道突然无法接收或发送消息，可以回到 频道 -> 微信，重新点击 获取登录二维码 并扫码授权。