Claude Code Router 接入 LINE：AgentClaw 消息接力完整配置指南

Claude Code Router 接入 LINE：AgentClaw 消息接力完整配置指南

【免费下载链接】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

本文基于 claude-code-router 仓库中的 LINE 平台接入文档 编写，聚焦于如何把本机由 CCR 管理的 Agent 接入 LINE 好友、群聊或 LINE Official Account：创建 Messaging API channel、复制 Channel Secret、签发 Channel Access Token、在 CCR 中保存 Bot 并绑定 Agent 配置，以及验证“锁屏后可接力”的完整链路。读完本文，你将能独立完成 LINE Bot 的创建、凭据配置、转发/接力模式选择与故障排查，并理解 CCR 底层 Bot Gateway 是如何识别与校验这些凭据的。

这个方式适合谁

LINE 适合把 Agent 消息接入已有的 LINE 好友、群聊或 LINE Official Account。如果你和同事/家人已经习惯用 LINE 沟通，希望让正在本机跑的长任务（代码分析、Agent 会话）在离开电脑后仍能查看和继续，AgentClaw 的 LINE 通道就是一个现成入口。

在 CCR 的实现里，AgentClaw 是 CCR 的 Agent 接力能力：由 CCR 管理的本机 Agent 保留原有工作区、登录态、配置文件、模型路由和工具权限，AgentClaw 通过 IM Bot 为它暴露一个远程入口（详见 AgentClaw 总览）。LINE 正是这些受支持的 IM 平台之一。

在 CCR 中，LINE 的 Bot以 Channel Access Token 作为主要认证字段，认证方式固定叫Bot Token。

如果还没看过 AgentClaw 的总体说明，建议先阅读 AgentClaw 总览 和 使用和配置，理解 Project/Session、转发/接力/仅回复三种模式后，再回来按本页配置单个平台。

你会用到哪些字段

CCR 里 LINE 的认证方式叫Bot Token（这是 LINE 在 CCR 中固定的认证类型，源码层面 LINE 被映射为bot_token默认认证类型），但需要填写的是 LINE channel 上的两个字段：

从 CCR 的实现看，这两项会作为 Bot 的credentials保存，并在启动 Bot Gateway 时通过CCR_BOT_GATEWAY_CREDENTIALS_JSON、CCR_BOT_GATEWAY_AUTH_TYPE等环境变量注入运行环境（见 bot-gateway/env.ts）。平台标识、认证类型与 Channel 凭据一一对应，因此 LINE 后台务必复制对。

第一步：创建 Messaging API channel

1. 打开 LINE Developers Console（开发者控制台）。
2. 登录你的 LINE 账号。
3. 创建一个供应商（Provider），或选择已有的供应商。
4. 点击Create a new channel。
5. 选择Messaging API类型。
6. 按页面要求填写 Channel 名称、描述、图标、分类等信息。
7. 创建完成后进入这个 Messaging API channel。

如果你已经有 LINE Official Account，也可以在该账号的设置中启用 Messaging API，再回到控制台复制凭据，不需要另建新 channel。

第二步：复制 Channel Secret

1. 进入刚创建的 Messaging API channel。
2. 打开Basic settings。
3. 找到Channel secret，复制它，稍后填入 CCR 的Channel Secret字段。

Channel Secret 的作用是校验 LINE 发来的请求（请求签名验证），所以文档中标记为“建议填”：只填 token 可以发送消息，但填上 secret 才能可靠地辨别请求确实来自 LINE，避免伪造回调。

第三步：签发 Channel Access Token

1. 打开Messaging API标签页。
2. 找到Channel access token。
3. 点击Issue或Reissue。
4. 复制生成的 token，稍后填入 CCR 的Channel Access Token字段。

优先使用长效 token。注意：重新签发会让旧 token 立即失效，如果 CCR 里已填过旧 token，需在同一时间同步更新 CCR，否则会认证失败。

第四步：打开聊天入口

1. 如果要用于群聊，把Allow bot to join group chats（允许 Bot 加入群聊）打开。
2. 建议关掉 LINE 官方账号的自动回复（auto-reply），避免用户同时收到 LINE 默认回复和 Agent 的回复，造成重复打扰。

在 CCR 中接入

完成上面的 LINE 后台准备后，回到 CCR 把 Bot 接入：

1. 打开 CCR 的Bot 管理页面，点击添加 Bot。
2. 平台选择LINE。
3. 认证方式选择Bot Token——这就是 LINE 在 CCR 里的固定认证方式。CCR 的 Bot Gateway 会把平台字符串line的默认认证类型解析为bot_token，与 Slack、Discord、Telegram 同属 token 类认证（见 defaultBotGatewayAuthType 实现）。
4. 把 LINE 后台复制的 token 填入Channel Access Token。
5. 把 LINE 后台复制的 secret 填入Channel Secret。
6. 保存这个 Bot。
7. 打开Agent 配置，编辑你要接入 Bot 的那个 Agent 配置。
8. 打开Bot开关，选择刚才保存的 Bot。
9. 按需打开转发 Agent 消息或接力（两者的区别见下一节）。
10. 从 CCR 重新打开 Agent。

关于第 8～10 步更完整的说明：Agent 配置需要保证入口模式包含App（如App only或CLI & App）。完整 AgentClaw 接力目前支持 Claude App、Codex/ChatGPT App、OpenCode App、ZCode App 与 WorkBuddy App；CLI-only Agent 不会把 Bot 消息转发出去（详见 使用和配置）。配置完成后，必须从 CCR 重新打开 Agent App，Companion worker 才会随受管 App 启停并建立 LINE 连接。

从源码看，保存后的 Bot 会进入 CCR 配置的botConfigs列表（见 BotGatewaySavedConfig 定义），Agent profile 通过botConfigId引用它；打开 Agent 时，运行时配置会合并全局botGateway、保存的 Bot 配置与 profile 级配置，只有入口为 App 时才会真正启用 Bot Gateway（见 resolveBotGatewayConfig）。

转发还是接力

接入 Agent 后，需要决定消息以哪种方式进入 LINE：

• 转发 Agent 消息（Forward agent messages）：不管电脑是否锁屏都转发，适合需要在 LINE 里持续看到完整 Agent 输出的场景，例如团队旁观或远程留档。
• 接力（Handoff）：只在电脑锁屏后转发，配合空闲秒数（Idle seconds）和目标设备使用。适合离开电脑后，在手机上继续接收和回复 Agent。

两者可以只开其一，也可以组合：只想在锁屏后收到提醒或接管任务，别开「转发 Agent 消息」，只开「接力」，避免锁屏前的大量输出刷屏 LINE。

补充实现细节：接力判断由 CCR 的锁屏与空闲扫描逻辑驱动，Bot 配置里的handoff包含screenLock（是否启用屏幕锁定判断）、userIdle（是否启用空闲判断）与idleSeconds（空闲阈值，默认 30 秒）等字段，并会转换为CCR_BOT_HANDOFF_*系列环境变量注入运行时（见 bot-gateway/env.ts）。当前手机 Wi-Fi / 蓝牙目标属于实验配置，不参与现阶段的运行时判断；实际接力以“屏幕锁定 + 空闲时间”为准（见 使用和配置 中的模式说明）。

测试

接入并重新打开 Agent 后，按下面步骤验证链路是否打通：

1. 从 CCR 打开 Agent，触发一条消息。
2. 到 LINE 确认机器人能收到并回复。
3. 如果用在群聊里，确认机器人已经进群、有发言权限。

怎么算成功：在 LINE 里能看到 Agent 的消息；你从 LINE 回复后，Agent 也能继续执行并回应。

如果开了接力，还可以额外做锁屏验证：锁屏电脑并等待超过配置的空闲秒数，再确认 Agent 的后续消息进入 LINE conversation。更系统的验证方法（如/project current、/session list、普通消息往返等）可参考 使用和配置 的“验证”一节；通过/session doctor可以查看 Bot 连接、outbox、最近投递与脱敏错误等诊断信息。

常见问题

• 认证失败：多半是 Channel Access Token 失效或复制不完整，重新到 LINE 控制台复制 Channel Access Token，并同步更新 CCR。
• 能发不能收：确认 Channel Access Token 仍然有效、CCR 桌面 App 已启动且 Bot Gateway 在线并连上 LINE（Bot Gateway 只在受管 Agent App 存活期间在线）。
• 群聊不可用：确认 LINE 后台的Allow bot to join group chats已打开，并把 Bot 重新加进群。
• 只想锁屏后提醒：别开转发 Agent 消息，只开接力；同时确认 Agent 配置的入口模式包含 App，并保持 Agent App 在后台运行。

如果上述步骤还无法定位问题，可结合 使用和配置 中“状态和安全边界”的说明理解 AgentClaw 的队列、投递与幂等机制，并通过 Agent profile 卡片与/session doctor查看连接状态和脱敏错误信息。

【免费下载链接】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