---
title: 微信 Bot 配置
pageTitle: 微信 Bot
eyebrow: Bot 与 IM 接力 Agent
lead: 把 Agent 的消息接入微信，并在电脑锁屏后把新消息接力过去。微信最简单的接法是二维码登录，不用手动复制任何 token，扫一下就行。
---

## 这个方式适合谁

微信适合个人把 Agent 消息接入常用聊天窗口。最简单的方式是二维码登录，不需要手动复制 token。

> 还没看过 Bot 总览？先回到主文档的「把 Agent 消息转发到 IM（Bot）」那一节，了解整体流程和转发 Agent 消息、接力的区别，再回来配单个平台。

## 两种登录方式

| 方式 | 需要准备 | 适合谁 |
| --- | --- | --- |
| QR Login（二维码登录） | 能扫码确认的微信账号 | 大多数个人用户 |
| Bot Token | 外部微信 Bot 服务或 iLink 插件给的 token | 已经有第三方微信 Bot 服务的用户 |

> **建议优先用二维码登录。** 微信登录态和账号安全强相关，建议用专门的 Bot 账号，别用绑定支付、客服或重要联系人的主账号。

## 方式一：二维码登录（推荐）

1. 打开 CCR 的 **Bot 管理** 页面，点 **添加 Bot**。
2. 平台选 **微信（Weixin iLink）**。
3. 认证方式选 **QR Login**（这是默认项）。
4. CCR 会弹出一个二维码窗口。
5. 用手机微信扫这个码。
6. 在手机上确认登录。
7. 等 CCR 显示登录成功。
8. 保存这个 Bot。

> 二维码会过期。如果扫码页提示过期，关掉登录窗口重新开始扫。

## 方式二：Bot Token

只有当你已经有外部微信 Bot 服务、iLink 服务或插件提供的 token 时才用这个方式。

1. 在提供方后台或本地插件输出里复制 `Bot Token`。
2. 提供方同时给了 `Account ID` 的话一起复制。
3. 给了 `User ID` 的话也一起复制。
4. 打开 CCR 的 **Bot 管理** 页面，点 **添加 Bot**。
5. 平台选 **微信**，认证方式选 **Bot Token**。
6. 填 **Bot Token**，按需填 **Account ID** 和 **User ID**。
7. 保存这个 Bot。

## 在 CCR 中绑定到 Agent

不管用哪种登录方式，都要再把 Bot 绑到 Agent配置上：

1. 打开 **Agent配置**，编辑你要接 Bot 的 Agent配置。
2. 打开 **Bot** 开关，选刚保存的 Bot。
3. 按需打开 **转发 Agent 消息** 或 **接力**（见下一节）。
4. 从 CCR 重新打开 Agent。

## 消息接力：转发还是接力

- **转发 Agent 消息**：不管锁不锁屏都转发，适合要在微信里看每条 Agent 输出。
- **接力**：只在电脑锁屏后转发。配合 **空闲秒数**（锁屏后空闲多久才接力）和 Wi-Fi / 蓝牙目标设备。

> 只想锁屏后收到提醒？打开 **接力** 就行，别开 **转发 Agent 消息**。

## 测试

1. 从 CCR 打开 Agent，触发一条消息。
2. 到微信确认 Bot 能收到并回复。
3. 锁屏电脑，等过你设的空闲时间，确认 Agent 新消息会自动进微信。

> **怎么算成功：** 微信里能看到 Agent 消息，你回复后 Agent 也能继续。

## 常见问题

- **二维码过期**：关掉登录窗口重新扫码。
- **扫码成功但消息没转发**：确认 Agent配置重启过、Bot 开关还开着。
- **扫码后很快掉线**：确认手机和电脑网络稳定；检查微信是不是在别的设备上重新登录导致登录态失效。
- **Token 方式连不上**：重新复制 Bot Token，避免复制到过期值或多余空格。
- **第三方服务要 Account ID / User ID**：确认这些字段来自同一个账号，别混用不同账号的 token 和 ID。
