Claude Code Router AgentClaw 微信接入指南用 QR 扫码登录或 Bot Token 把 Agent 消息推到微信【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-routerAgentClaw 是 Claude Code RouterCCR的 IM 中继能力把 Claude App、Codex/ChatGPT App、OpenCode App 等受管 Agent 会话接到日常聊天窗口里。本文聚焦其中 WeChatWeixin微信平台——即 CCR 中的Weixin iLink——的完整接入流程推荐走 QR 扫码登录无需手动复制任何 token或使用第三方微信机器人服务提供的 Bot Token。读完本文你可以完成扫码/Token 两种登录、把 Bot 绑定到 Agent Config、配置消息转发或锁屏 Handoff并能看懂 CCR 源码中扫码会话、平台归一化与 Handoff 扫描的实现细节。如果你是 AgentClaw 新手建议先通读 AgentClaw 总览与配置再回到本文处理微信这一个平台。Weixin iLink 适合谁Weixin 平台面向「希望在自己的日常聊天窗口里收到 Agent 消息」的个人用户。最简单的路径是 QR Login不需要手动复制 token用手机的微信扫码确认即可。登录方式需要什么适合谁QR Login一个能扫码确认的微信账号大多数个人用户Bot Token外部微信机器人服务或 iLink 插件提供的 token已经在运行第三方微信机器人服务的用户安全提醒微信会话与账号安全强绑定——请使用专用的机器人账号不要用承担支付、客服或重要联系人角色的主账号登录。源码视角平台别名归一化在 UI 里你选择的是Weixin iLink落到运行时的平台标识是weixin-ilink。从源码结构看CCR 对平台名做了宽松的别名归一化wechat、weixin、wx、weixin-ilink、weixin_ilink、ilink这些写法最终都会被标准化为weixin-ilink见 env.ts 与 config.ts。而该平台的默认认证方式就是qr_login——这解释了文档中「Choose QR Login (the default)」的说法// packages/core/src/config/config.ts function defaultBotGatewayAuthType(platform: string): string { if (platform weixin-ilink) { return qr_login; } ... }参见 config.ts#L193-L207方式一QR Login推荐操作步骤打开 CCR 的Bot Management页面点击Add Bot。平台选择Weixin iLink。认证方式选择QR Login默认项。CCR 弹出一个二维码窗口。用手机微信扫码。在手机上确认登录。等待 CCR 显示登录成功。保存该 Bot。二维码会过期。如果扫码页面提示已过期关闭登录窗口重新发起即可。扫码流程的源码级拆解扫码窗口与扫码会话由两个模块协作完成1桌面端二维码窗口。Electron 主进程中的 bot-gateway-qr-window-service.ts 会创建一个 460×760 的独立BrowserWindow标题默认为 Weixin Login窗口以sandbox: true、nodeIntegration: false的沙箱模式运行且只允许加载 http/https 的扫码 URL窗口内跳转一律交给系统浏览器。这与文档里「CCR opens a QR code window」「close the login window and start over」的操作一一对应。2扫码会话生命周期。核心逻辑在 qr-login-service.tsstartBotGatewayQrLogin首先强制校验「微信扫码登录只支持微信平台的扫码认证方式」L54-L56即platform必须是weixin-ilink且authType为qr_login否则直接抛错随后通过 bot-gateway SDK 的 stdio 子进程客户端调用auth.qr.start拿到sessionId和qrCodeUrl并把会话注册进内存中的qrSessions再次发起扫码时旧会话的客户端会被自动关闭避免悬挂进程UI 侧通过waitBotGatewayQrLogin轮询auth.qr.wait状态为confirmed即登录成功状态落入终止态already_bound、confirmed、expired、failed见 L534-L536后会话会被清理、客户端被关闭——这就是「二维码过期后必须重新生成」的机制来源若没有现成的 integration服务会按integrations.list在同租户默认ccr下查找已有weixin-ilinkintegration 复用否则生成weixin-ilink-tenant形式的 integrationIdL325-L360。3登录成功后的凭据落点。扫码产生的会话凭据保存在本地状态目录。从源码看若未显式配置stateDir默认路径为 CCR 配置目录下的bot-gateway/profile-slugenv.ts#L275-L282这也是排查「扫完码掉线」问题时值得检查的位置。方式二Bot Token只有当你已经从外部微信机器人服务、iLink 服务或本地插件拿到了 token 时才使用此方式从服务商控制台或本地插件输出中复制Bot Token。如果服务商还给了Account ID一并复制。如果给了User ID也复制下来。打开 CCR 的Bot Management点击Add Bot。平台选Weixin iLink认证方式选Bot Token。填入Bot Token如有则填Account ID/User ID。保存 Bot。表单字段的源码印证UI 中 Weixin iLink 的认证字段定义见 profiles.ts#L199-L215{ value: weixin-ilink, label: Weixin iLink, auth: [ { value: qr_login, label: QR Login, fields: [] }, { value: bot_token, label: Bot Token, fields: [ { key: botToken, label: Bot Token, required: true, type: password }, { key: accountId, label: Account ID }, { key: userId, label: User ID } ] } ] }可以确认Bot Token是唯一必填项Account ID与User ID均为可选项且与 QR Login 一致微信平台的accountId/userId/botAgent/routeTag字段会在配置合并时被特殊处理profiles.ts#L846。配置如何进入运行时CCR 会把凭据打包进环境变量CCR_BOT_GATEWAY_CREDENTIALS_JSON、认证类型写入CCR_BOT_GATEWAY_AUTH_TYPE、平台写入CCR_BOT_GATEWAY_PLATFORMenv.ts#L25-L76。此外源码会主动过滤掉 webhook 相关的键值sanitizeBotGatewayRecord因为 Weixin iLink 走的是长连接integration 配置被强制写入transport: websocketenv.ts#L234-L247。在 CCR 中完成绑定无论用哪种登录方式都需要把 Bot 绑定到一个 Agent Config打开Agent Config编辑要挂接该 Bot 的配置项。打开Bot开关并选择刚保存的 Bot。按需开启Forward agent messages或Handoff见下节。从 CCR 重新打开对应的 Agent App。配置合并的优先级在源码中是明确的三级覆盖全局botGateway→ 当前 Bot 保存的botGateway按botConfigId从botConfigs中取出→ Agent Config 自身的botGateway后者优先env.ts#L85-L101。也就是说同一个 Agent 上配置覆盖 Bot 级、Bot 级覆盖全局配置credentials、handoff、integrationConfig三个对象字段做浅合并而非整体替换。前提提醒来自 AgentClaw setup该 Agent 的Entry mode必须包含 App且当前受支持的受管 App 为 Claude App、Codex/ChatGPT App、OpenCode App、ZCode App 和 WorkBuddy App纯 CLI 型 Agent 不转发 Bot 消息。AgentClaw 只在受管 App 存活期间在线。Forward 还是 Handoff两种消息模式模式开关组合适用场景全量转发开启Forward agent messages让微信里始终有完整的 Agent 输出锁屏接力开启Handoff、关闭 Forward离开电脑、锁屏之后才接收并回复 AgentIM 主动发起两个都关只允许从微信发起对话轮次不镜像桌面输出Forward agent messages无论屏幕是否锁定把每条新的 Agent 消息都转发到微信。适合希望每一行输出都进微信的场景。Handoff只在屏幕锁定后转发。配合Idle seconds空闲秒数与 Wi-Fi/蓝牙目标手机设备使用。若只想在锁屏时收到提醒用 Handoff 而不开 Forward。Handoff 的源码细节Handoff 参数同样通过环境变量下发默认值可以直接从 env.ts#L16-L23 读到const handoff bot.handoff ?? { enabled: false, idleSeconds: 30, // 空闲阈值默认 30 秒 phoneBluetoothTargets: [], phoneWifiTargets: [], screenLock: true, // 默认依赖锁屏事件 userIdle: true // 默认依赖用户空闲判定 };对应运行时变量为CCR_BOT_HANDOFF_ENABLED、CCR_BOT_HANDOFF_IDLE_SECONDS、CCR_BOT_HANDOFF_SCREEN_LOCK等env.ts#L55-L60。关于 Wi-Fi/蓝牙目标设备handoff-scan-service.ts 负责扫描候选设备——Wi-Fi 目标通过arp -a解析局域网 ARP 表L8-L14蓝牙目标在 macOS 上依次尝试blueutil、system_profiler、ioreg在 Windows 上通过 PowerShell 的Get-PnpDevice -Class Bluetooth采集。按 AgentClaw setup 文档的说明这些 Wi-Fi/蓝牙目标目前是实验性设置尚不影响运行期 Handoff 判定实际 Handoff 以锁屏与空闲时间为准。验证是否工作从 CCR 打开该 Agent触发一条消息。检查微信确认 Bot 收到了消息并正常回复。锁定屏幕等待超过你设置的空闲阈值确认新的 Agent 消息进入了微信。判断标准微信里出现了 Agent 的消息并且你在微信中回复后 Agent 继续运行即接入成功。更完整的验证手段来自 AgentClaw setup在 IM 中发送/project current确认 Bot 在线、/session list列出会话发送一条普通消息确认 Agent 执行并在同一会话中回复关闭 Agent App 后 Bot 应转为离线。/session doctor与 Profile 卡片展示同类运行时诊断连接状态、最近事件与投递、待发队列数量、脱敏错误。常见问题排查症状处理QR code expired二维码过期关闭登录窗口重新扫码。对应源码中expired终止态会话已被清理必须重新auth.qr.start扫码成功但消息不转发确认 Agent Config 修改后 Agent 已从 CCR 重新打开且 Bot 开关仍为开启状态配置有三级合并检查是否被覆盖扫码成功后很快掉线检查手机与电脑网络是否稳定确认微信没有在别处登录导致会话被挤下线源码中already_bound即表示该账号已在其他 integration 绑定Token 模式连不上重新复制 Bot Token——避免使用过期值或带有多余空格的值第三方服务要求 Account ID / User ID确保 token 与这些 ID 来自同一账号不要混用不同账号的凭据关键文件索引平台文档Weixin iLink 设置、AgentClaw 总览与配置运行时环境装配平台/认证归一化、Handoff 默认值、环境变量env.ts扫码登录会话管理start/wait/cancel、终止态qr-login-service.ts桌面端扫码窗口Electron 沙箱 BrowserWindowbot-gateway-qr-window-service.tsWi-Fi/蓝牙 Handoff 目标扫描handoff-scan-service.tsBot 表单字段定义botToken/accountId/userIdprofiles.ts平台与认证归一化配置层config.ts环境变量装配测试bot-gateway-env.test.mjs适用前提与限制以上流程基于 CCR DesktopElectron 应用AgentClaw 仅在受管 Agent App 由 CCR 打开并存活期间在线Weixin iLink 的 QR Login 是默认且推荐方式Bot Token 仅适用于已持有第三方服务 token 的用户Wi-Fi/蓝牙 Handoff 目标为实验性配置。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Code Router AgentClaw 微信接入指南：用 QR 扫码登录或 Bot Token 把 Agent 消息推到微信
Claude Code Router AgentClaw 微信接入指南用 QR 扫码登录或 Bot Token 把 Agent 消息推到微信【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-routerAgentClaw 是 Claude Code RouterCCR的 IM 中继能力把 Claude App、Codex/ChatGPT App、OpenCode App 等受管 Agent 会话接到日常聊天窗口里。本文聚焦其中 WeChatWeixin微信平台——即 CCR 中的Weixin iLink——的完整接入流程推荐走 QR 扫码登录无需手动复制任何 token或使用第三方微信机器人服务提供的 Bot Token。读完本文你可以完成扫码/Token 两种登录、把 Bot 绑定到 Agent Config、配置消息转发或锁屏 Handoff并能看懂 CCR 源码中扫码会话、平台归一化与 Handoff 扫描的实现细节。如果你是 AgentClaw 新手建议先通读 AgentClaw 总览与配置再回到本文处理微信这一个平台。Weixin iLink 适合谁Weixin 平台面向「希望在自己的日常聊天窗口里收到 Agent 消息」的个人用户。最简单的路径是 QR Login不需要手动复制 token用手机的微信扫码确认即可。登录方式需要什么适合谁QR Login一个能扫码确认的微信账号大多数个人用户Bot Token外部微信机器人服务或 iLink 插件提供的 token已经在运行第三方微信机器人服务的用户安全提醒微信会话与账号安全强绑定——请使用专用的机器人账号不要用承担支付、客服或重要联系人角色的主账号登录。源码视角平台别名归一化在 UI 里你选择的是Weixin iLink落到运行时的平台标识是weixin-ilink。从源码结构看CCR 对平台名做了宽松的别名归一化wechat、weixin、wx、weixin-ilink、weixin_ilink、ilink这些写法最终都会被标准化为weixin-ilink见 env.ts 与 config.ts。而该平台的默认认证方式就是qr_login——这解释了文档中「Choose QR Login (the default)」的说法// packages/core/src/config/config.ts function defaultBotGatewayAuthType(platform: string): string { if (platform weixin-ilink) { return qr_login; } ... }参见 config.ts#L193-L207方式一QR Login推荐操作步骤打开 CCR 的Bot Management页面点击Add Bot。平台选择Weixin iLink。认证方式选择QR Login默认项。CCR 弹出一个二维码窗口。用手机微信扫码。在手机上确认登录。等待 CCR 显示登录成功。保存该 Bot。二维码会过期。如果扫码页面提示已过期关闭登录窗口重新发起即可。扫码流程的源码级拆解扫码窗口与扫码会话由两个模块协作完成1桌面端二维码窗口。Electron 主进程中的 bot-gateway-qr-window-service.ts 会创建一个 460×760 的独立BrowserWindow标题默认为 Weixin Login窗口以sandbox: true、nodeIntegration: false的沙箱模式运行且只允许加载 http/https 的扫码 URL窗口内跳转一律交给系统浏览器。这与文档里「CCR opens a QR code window」「close the login window and start over」的操作一一对应。2扫码会话生命周期。核心逻辑在 qr-login-service.tsstartBotGatewayQrLogin首先强制校验「微信扫码登录只支持微信平台的扫码认证方式」L54-L56即platform必须是weixin-ilink且authType为qr_login否则直接抛错随后通过 bot-gateway SDK 的 stdio 子进程客户端调用auth.qr.start拿到sessionId和qrCodeUrl并把会话注册进内存中的qrSessions再次发起扫码时旧会话的客户端会被自动关闭避免悬挂进程UI 侧通过waitBotGatewayQrLogin轮询auth.qr.wait状态为confirmed即登录成功状态落入终止态already_bound、confirmed、expired、failed见 L534-L536后会话会被清理、客户端被关闭——这就是「二维码过期后必须重新生成」的机制来源若没有现成的 integration服务会按integrations.list在同租户默认ccr下查找已有weixin-ilinkintegration 复用否则生成weixin-ilink-tenant形式的 integrationIdL325-L360。3登录成功后的凭据落点。扫码产生的会话凭据保存在本地状态目录。从源码看若未显式配置stateDir默认路径为 CCR 配置目录下的bot-gateway/profile-slugenv.ts#L275-L282这也是排查「扫完码掉线」问题时值得检查的位置。方式二Bot Token只有当你已经从外部微信机器人服务、iLink 服务或本地插件拿到了 token 时才使用此方式从服务商控制台或本地插件输出中复制Bot Token。如果服务商还给了Account ID一并复制。如果给了User ID也复制下来。打开 CCR 的Bot Management点击Add Bot。平台选Weixin iLink认证方式选Bot Token。填入Bot Token如有则填Account ID/User ID。保存 Bot。表单字段的源码印证UI 中 Weixin iLink 的认证字段定义见 profiles.ts#L199-L215{ value: weixin-ilink, label: Weixin iLink, auth: [ { value: qr_login, label: QR Login, fields: [] }, { value: bot_token, label: Bot Token, fields: [ { key: botToken, label: Bot Token, required: true, type: password }, { key: accountId, label: Account ID }, { key: userId, label: User ID } ] } ] }可以确认Bot Token是唯一必填项Account ID与User ID均为可选项且与 QR Login 一致微信平台的accountId/userId/botAgent/routeTag字段会在配置合并时被特殊处理profiles.ts#L846。配置如何进入运行时CCR 会把凭据打包进环境变量CCR_BOT_GATEWAY_CREDENTIALS_JSON、认证类型写入CCR_BOT_GATEWAY_AUTH_TYPE、平台写入CCR_BOT_GATEWAY_PLATFORMenv.ts#L25-L76。此外源码会主动过滤掉 webhook 相关的键值sanitizeBotGatewayRecord因为 Weixin iLink 走的是长连接integration 配置被强制写入transport: websocketenv.ts#L234-L247。在 CCR 中完成绑定无论用哪种登录方式都需要把 Bot 绑定到一个 Agent Config打开Agent Config编辑要挂接该 Bot 的配置项。打开Bot开关并选择刚保存的 Bot。按需开启Forward agent messages或Handoff见下节。从 CCR 重新打开对应的 Agent App。配置合并的优先级在源码中是明确的三级覆盖全局botGateway→ 当前 Bot 保存的botGateway按botConfigId从botConfigs中取出→ Agent Config 自身的botGateway后者优先env.ts#L85-L101。也就是说同一个 Agent 上配置覆盖 Bot 级、Bot 级覆盖全局配置credentials、handoff、integrationConfig三个对象字段做浅合并而非整体替换。前提提醒来自 AgentClaw setup该 Agent 的Entry mode必须包含 App且当前受支持的受管 App 为 Claude App、Codex/ChatGPT App、OpenCode App、ZCode App 和 WorkBuddy App纯 CLI 型 Agent 不转发 Bot 消息。AgentClaw 只在受管 App 存活期间在线。Forward 还是 Handoff两种消息模式模式开关组合适用场景全量转发开启Forward agent messages让微信里始终有完整的 Agent 输出锁屏接力开启Handoff、关闭 Forward离开电脑、锁屏之后才接收并回复 AgentIM 主动发起两个都关只允许从微信发起对话轮次不镜像桌面输出Forward agent messages无论屏幕是否锁定把每条新的 Agent 消息都转发到微信。适合希望每一行输出都进微信的场景。Handoff只在屏幕锁定后转发。配合Idle seconds空闲秒数与 Wi-Fi/蓝牙目标手机设备使用。若只想在锁屏时收到提醒用 Handoff 而不开 Forward。Handoff 的源码细节Handoff 参数同样通过环境变量下发默认值可以直接从 env.ts#L16-L23 读到const handoff bot.handoff ?? { enabled: false, idleSeconds: 30, // 空闲阈值默认 30 秒 phoneBluetoothTargets: [], phoneWifiTargets: [], screenLock: true, // 默认依赖锁屏事件 userIdle: true // 默认依赖用户空闲判定 };对应运行时变量为CCR_BOT_HANDOFF_ENABLED、CCR_BOT_HANDOFF_IDLE_SECONDS、CCR_BOT_HANDOFF_SCREEN_LOCK等env.ts#L55-L60。关于 Wi-Fi/蓝牙目标设备handoff-scan-service.ts 负责扫描候选设备——Wi-Fi 目标通过arp -a解析局域网 ARP 表L8-L14蓝牙目标在 macOS 上依次尝试blueutil、system_profiler、ioreg在 Windows 上通过 PowerShell 的Get-PnpDevice -Class Bluetooth采集。按 AgentClaw setup 文档的说明这些 Wi-Fi/蓝牙目标目前是实验性设置尚不影响运行期 Handoff 判定实际 Handoff 以锁屏与空闲时间为准。验证是否工作从 CCR 打开该 Agent触发一条消息。检查微信确认 Bot 收到了消息并正常回复。锁定屏幕等待超过你设置的空闲阈值确认新的 Agent 消息进入了微信。判断标准微信里出现了 Agent 的消息并且你在微信中回复后 Agent 继续运行即接入成功。更完整的验证手段来自 AgentClaw setup在 IM 中发送/project current确认 Bot 在线、/session list列出会话发送一条普通消息确认 Agent 执行并在同一会话中回复关闭 Agent App 后 Bot 应转为离线。/session doctor与 Profile 卡片展示同类运行时诊断连接状态、最近事件与投递、待发队列数量、脱敏错误。常见问题排查症状处理QR code expired二维码过期关闭登录窗口重新扫码。对应源码中expired终止态会话已被清理必须重新auth.qr.start扫码成功但消息不转发确认 Agent Config 修改后 Agent 已从 CCR 重新打开且 Bot 开关仍为开启状态配置有三级合并检查是否被覆盖扫码成功后很快掉线检查手机与电脑网络是否稳定确认微信没有在别处登录导致会话被挤下线源码中already_bound即表示该账号已在其他 integration 绑定Token 模式连不上重新复制 Bot Token——避免使用过期值或带有多余空格的值第三方服务要求 Account ID / User ID确保 token 与这些 ID 来自同一账号不要混用不同账号的凭据关键文件索引平台文档Weixin iLink 设置、AgentClaw 总览与配置运行时环境装配平台/认证归一化、Handoff 默认值、环境变量env.ts扫码登录会话管理start/wait/cancel、终止态qr-login-service.ts桌面端扫码窗口Electron 沙箱 BrowserWindowbot-gateway-qr-window-service.tsWi-Fi/蓝牙 Handoff 目标扫描handoff-scan-service.tsBot 表单字段定义botToken/accountId/userIdprofiles.ts平台与认证归一化配置层config.ts环境变量装配测试bot-gateway-env.test.mjs适用前提与限制以上流程基于 CCR DesktopElectron 应用AgentClaw 仅在受管 Agent App 由 CCR 打开并存活期间在线Weixin iLink 的 QR Login 是默认且推荐方式Bot Token 仅适用于已持有第三方服务 token 的用户Wi-Fi/蓝牙 Handoff 目标为实验性配置。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考