claude-code-router AgentClaw 企业微信WeCom接入实战自建应用创建、凭据配置与锁屏接力【免费下载链接】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企业微信接入是本机 Agent 无缝进入企业内部消息环境的一条成熟路径AgentClaw 把由 claude-code-routerCCR管理、运行在你电脑上的 Agent 暴露为企业微信里的一个应用 Bot团队成员可以直接在企业微信中查看 Agent 输出、发起对话并在电脑锁屏后接力处理任务。读完本文你将掌握企业微信自建应用的创建与凭据获取流程、在 CCRBot 管理中完成 WeCom Bot 配置、把 Bot 绑定到 Agent 配置并正确选择“转发”或“接力”模式以及一整套可用于验收的测试与排障方法。AgentClaw 与企业微信的关系AgentClaw 是 CCR 的 Agent 接力handoff能力。被 CCR 管理的本机 Agent 仍然保留原有的工作区、登录态、配置文件、模型路由和工具权限AgentClaw 只是通过 IM Bot 为它打开一个远程入口——你可以在企业微信、Slack、Discord、Telegram、LINE、微信、飞书或钉钉中查看 Agent 输出、继续对话、处理权限请求或在电脑锁屏后接管当前任务参见 AgentClaw 总览。值得注意的一个边界是AgentClaw 跟随从 CCR 打开的 Agent App 而存活。App 退出时 Bot 连接即停止CLI-only Agent 可以通过 CCR 继续路由模型请求但不会把消息转发到 IM。因此企业微信场景下的接入主体一般是 Claude App、Codex / ChatGPT App、OpenCode App、ZCode App 或 WorkBuddy App 这类由 CCR 以 App 入口打开的受管 Agent。在动手之前建议先读完 AgentClaw 使用和配置 再回来配置单个平台本页只聚焦企业微信WeCom这一条链路。这个方式适合谁企业微信适合把 Agent 接入企业内部消息环境让团队成员在企业微信里接收 Agent 消息并回复。与微信个人号方向Weixin iLink走二维码登录不同WeCom 走的是企业级自建应用 App Secret 的认证模型天然带组织边界你可以用“自建应用的可见范围”控制谁能看到、谁能使用这个 Bot更适合团队协作场景。你会用到哪些字段接入前先认清企业微信后台与 CCR 之间的字段对应关系。下方第一列是企业微信管理后台里的名字第二列是 CCR 中要填的字段企业微信后台里的名字CCR 字段是否必填说明企业ID / CorpIDCorp ID必填企业级标识在「我的企业」里AgentIdAgent ID必填自建应用的应用 IDSecretSecret必填自建应用密钥通常要管理员在手机端确认查看从 CCR 前端源码看这三个字段正是 WeCom 平台规格里声明的凭据键corpIdCorp ID、agentIdAgent ID与secretSecret密码类型且均标记为必填见 profiles.ts。其中认证方式为app_secretApp Secret这也是 CCR 为 feishu / dingtalk / wecom 等平台选择的默认认证方式见 env.ts。另一个关键事实是CCR 会用 Corp ID 和应用 Secret 去换企业微信接口的 access_token你不用自己手动获取。你只需把凭据交给 CCRBot 运行时负责与企业微信 API 完成认证与后续消息收发。第一步获取 Corp ID打开企业微信管理后台用管理员账号登录。顶部打开我的企业。进入企业信息。找到企业ID复制待会儿填到 CCR 的 Corp ID。Corp ID 是整个企业唯一的标识同一企业下所有自建应用共用同一个 Corp ID因此它只与企业相关与应用无关。第二步创建自建应用在管理后台打开应用管理。找到自建区域。点创建应用。填应用名比如CCR。上传应用 Logo。选可见范围。测试时先选你自己或一个小测试部门。点创建。“可见范围”值得重点说明它直接决定了企业里谁能看到并进入这个应用。若后续出现“部分成员看不到应用”的问题都要回到这里检查。测试阶段建议先圈定你自己或一个小测试部门验证链路通了之后再逐步扩大范围。第三步复制 Agent ID 和 Secret进入刚创建的自建应用详情。复制AgentId待会儿填到 CCR 的 Agent ID。找到Secret点查看。按企业微信提示在手机企业微信里确认。复制显示出的Secret。这里有一个常见坑Secret是敏感凭据企业微信通常要求管理员在手机端确认后才能查看如果你不是管理员或管理员未在手机端点确认页面上不会直接显示明文 Secret。如果企业微信要求配企业可信 IP需要把运行 CCR Bot Gateway 的出口公网 IP或你用的中继服务出口 IP加进去。该限制由企业微信侧的安全策略决定未加入可信 IP 的应用在调用接口发送消息时会直接失败。在 CCR 中接入拿到三项凭据后回到 CCR 界面完成 Bot 与 Agent 的绑定打开 CCR 的Bot 管理页面点添加 Bot。平台选企业微信WeCom。认证方式是App Secret。填Corp ID、Agent ID、Secret。保存这个 Bot。打开Agent 配置编辑你要接 Bot 的 Agent 配置。打开Bot开关选刚保存的 Bot。按需打开转发 Agent 消息或接力见下一节。从 CCR 重新打开 Agent。其中第 67 步背后的数据流值得展开。Agent 配置并不直接持有 Bot 的全部细节而是通过botConfigId引用你在Bot 管理中保存的 Bot运行时解析配置时按“全局 botGateway 配置 ← 已保存 Bot 的 botGateway ← Profile 级 botGateway”三层合并凭据、handoff 与 integrationConfig 为对象级深合并见 env.ts。也就是说一个 Bot 可以被多个 Agent 配置复用而单个 Agent 又可以在 Profile 上覆盖转发、接力等行为。第 9 步不是仪式性的AgentClaw 跟随从 CCR 打开的 Agent App 启停修改 Bot 配置后必须从 CCR 重新打开目标 Agent新的 Bot 连接才会生效。保存凭据后运行时会把凭据、开关与各项参数序列化进环境变量如CCR_BOT_GATEWAY_CREDENTIALS_JSON、CCR_BOT_GATEWAY_FORWARD_ALL_AGENT_MESSAGES、CCR_BOT_HANDOFF_*交给 Bot Gateway 进程使用见 env.ts。转发还是接力“转发 Agent 消息”与“接力”是两种不同的消息语义决定 Agent 的输出何时进入企业微信模式行为典型用途转发 Agent 消息不管锁不锁屏都转发只在要完整记录或排查问题时用接力只在电脑锁屏后转发离开电脑后继续接收和回复 Agent配合空闲秒数和目标设备结合 AgentClaw 总览 中的说明AgentClaw 共有三种模式全量转发开启转发 Agent 消息、锁屏接力开启接力、关闭转发 Agent 消息、仅 IM 主动调用两者都关闭。企业微信场景的建议是只想锁屏后提醒别开转发 Agent 消息否则 Agent 的每一次可见输出都会被同步到会话里消息量显著增加。在底层这两个开关分别对应运行时配置中的forwardAllAgentMessages与handoff.enabledhandoff子对象还包含idleSeconds空闲秒数、screenLock屏幕锁定判断、userIdle用户空闲判断以及phoneBluetoothTargets/phoneWifiTargets两个目标设备列表见 app.ts 与 default-config.ts。其中idleSeconds的默认值是 30 秒。需要说明的是当前接力判断使用的是屏幕锁定 空闲时间手机 Wi-Fi / 蓝牙目标仍属于实验性配置尚未参与当前运行时判断见 AgentClaw 使用和配置。如果你确实需要按“手机是否在身边”这类条件触发接力可以关注仓库中的目标扫描能力——handoff-scan-service.ts 实现了通过arp -a扫描 Wi-Fi / LAN 目标、在 macOS 上经blueutil/system_profiler、在 Windows 上经 PowerShell 查询蓝牙设备的能力。测试配置完成后按下面的顺序验收整条链路从 CCR 打开 Agent触发一条消息。到企业微信确认应用能收到并回复。锁屏电脑等过你设的空闲时间确认接力触发后新消息会进企业微信。怎么算成功企业微信里能看到 Agent 消息你回复后 Agent 也能继续。这意味着双向链路都通Agent → 企业微信出站发送与企业微信 → Agent入站回复均已生效。更完整的验证还可以借助 AgentClaw 的管理命令在会话内确认状态/project current 确认 Bot 在线且能读取当前 Project /session list 确认能列出当前 Project 下的 Session /session status 查看当前 turn / 队列状态验证过程中可以再测两个边界锁屏等待超过接力空闲秒数后新消息进入企业微信以及关闭 Agent App 后 Bot 状态变为离线——后者用于确认 AgentClaw “随 App 启停”的边界符合预期。常见问题认证失败重新复制 Corp ID、Agent ID 和 Secret。逐字符核对尤其是 Secret 查看时容易复制到不完整字符串确保复制自“查看”后显示出的值而非应用列表页的占位内容。能启动但收不到消息检查企业微信应用是否允许接收消息、当前成员有没有使用权限。App 侧需要在后台把“接收消息”相关配置打开且发起会话的成员必须在自建应用的可见范围内。发送失败提示 IP 不可信回企业微信后台配企业可信 IP。填入运行 CCR Bot Gateway 的出口公网 IP或中继服务出口 IP若出口 IP 是动态变化的需要保证企业微信后台中的可信 IP 始终与实际出口一致。部分成员看不到应用检查自建应用的可见范围。扩大范围后让成员重新进入企业微信查看也请确认成员使用的是企业微信而非个人微信。接力不触发确认电脑已锁屏检查接力开关、空闲时间和目标设备。逐项核对接力是否打开、转发是否误开、配置的“空闲秒数”是否已超过、当前会话是否真的处于锁屏 空闲状态。CCR 侧的实现要点从实现层面理解这条链路有助于更准确地排障平台归一化CCR 在配置解析时会把人可读的平台写法归一化wecom/wework/wechat-work/work-weixin/enterprise-wechat均归一到wecom认证方式appsecret归一为app_secret见 env.ts。因此你无论在 UI、配置文件还是环境变量里见到哪种写法最终都会落到同一个平台分支。连接方式WeCom 走websocket传输运行时通过 Bot Gateway 进程接入平台见 env.tsBot 的存活状态因此与运行 CCR 的进程、以及 Agent App 是否打开强相关。状态目录每个 Bot 的运行时状态默认落在 CCR 配置目录下按 Profile 归类的bot-gateway/profile子目录中也可通过stateDir显式覆盖见 env.ts。状态目录里会保存有界的去重记录、待处理 turn、outbox 与最近投递结果事件幂等保证每个 Agent turn 只执行一次。常用运行参数默认值Bot Gateway 对未显式配置的项提供默认值例如消息分片messageChunkChars默认 3500 字符、附件上限maxAttachmentBytes默认 20 MB、最长 turn 时间maxTurnTimeMs默认 10 分钟、轮询间隔pollIntervalMs默认 2000 ms、请求超时requestTimeoutMs默认 600000 ms见 default-config.ts。企业微信消息长度受限时可以通过“消息分片字符数”把长输出切成多段发送若 Agent 单轮任务可能超过 10 分钟应调大“最长 turn 时间”避免超时中断。继续深入想理解 AgentClaw 的整体工作方式、支持范围与/project、/session命令域读 AgentClaw 总览。想调整 Bot 语言、超时、附件、Shell 权限等更多选项读 AgentClaw 使用和配置。企业微信之外还有 飞书、钉钉、Slack、Discord、Telegram、LINE 与微信 iLink 等平台页面接入逻辑与本文一致仅后台凭据与平台差异不同。【免费下载链接】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），仅供参考