claude-code-router AgentClaw 飞书（Feishu/Lark）接入实战：从企业自建应用到锁屏接力

claude-code-router AgentClaw 飞书Feishu/Lark接入实战从企业自建应用到锁屏接力【免费下载链接】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为本地 Agent 提供 IM 接入层的功能Claude Code、Codex、OpenCode 等 Agent 仍在本机运行、保留工作区与会话由飞书机器人担任远程入口让你在电脑锁屏、离开工位后继续查看 Agent 输出并回复。本文基于仓库文档 feishu.md完整讲解飞书企业自建应用的创建、权限与事件订阅配置以及在 CCR「Bot 管理」中的接线与验证流程读完后你可以在飞书群或应用会话中稳定运行自己的本地 Agent并按需开启「锁屏接力」。AgentClaw 飞书通道适合谁飞书通道适合希望在飞书群或应用会话里接收 Agent 消息的团队或个人。CCR 通过App Secret 认证方式连接飞书自建应用你既可以在工位上实时看到转发过来的 Agent 输出也可以在离开电脑后通过飞书继续驱动同一台机器上的会话。若你刚接触 AgentClaw建议先阅读 AgentClaw 总览 与 使用和配置再回到本页完成单个平台的接入。需要说明的边界AgentClaw 的完整 Bot 转发、接力、Projects/Sessions 等能力目前只覆盖由 CCR 管理的App 型入口如 Claude App、Codex/ChatGPT App、OpenCode App、ZCode App、WorkBuddy App纯 CLI 型 Agent如 Claude Code CLI、Codex CLI可以走 CCR 的模型路由但不会把 Bot 消息转发到 IM。你会用到的字段接入飞书时CCR 只要求 3 个字段其中前两个必填飞书后台中的名称CCR 字段是否必填说明App IDApp ID必填应用标识通常以cli_开头App SecretApp Secret必填应用密钥飞书 / Lark 域名Domain可选中国大陆飞书一般不填Lark 或特殊域环境才需要填写其中Domain对应的是飞书中国大陆与 Lark海外这两套不同域名体系的差异。仓库源码也印证了这一设计在 bot-gateway/env.ts 中平台名做归一化时会把lark统一归一化为feishu说明同一套 Bot 网关同时服务于飞书与 Lark只是底座域不同。第一步创建企业自建应用登录飞书开放平台并进入开发者后台。点击创建应用。选择企业自建应用。填写应用名称例如CCR。填写应用描述并上传图标。创建应用。创建时选择「企业自建应用」即可使用 App Secret 认证这是 CCR 飞书通道默认采用的认证类型。事实上从源码看飞书连同钉钉、企业微信的默认认证方式就是app_secret见 bot-gateway/env.ts 中defaultBotGatewayAuthType的实现。第二步复制 App ID 与 App Secret打开刚创建的应用。打开基础信息。进入凭证与基础信息。复制App ID。复制App Secret。这两个值就是 CCR 里必填的App ID与App Secret。App Secret 相当于应用的访问密钥不要提交到公开仓库或分享到群里。第三步开启机器人能力在应用后台打开应用能力。点击添加应用能力。找到机器人添加或启用它。设置机器人名称与头像。没有开启机器人能力时飞书聊天窗口可能看不到输入框也收不到用户消息。这是飞书接入最常见的第一步排查点。第四步申请消息权限打开开发配置。进入权限管理。添加「应用身份」权限。至少开通「读取用户发给机器人的单聊消息」权限。若需要在群里被 后回复开通「读取群聊中 机器人的消息」权限。若要 Agent 能回复消息开通「以应用身份发送消息」权限。保存。不同租户后台的权限显示名称可能略有差异。当你看到im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:message:send_as_bot这类标识时优先勾选这些消息相关的权限它们与机器人收发行为直接对应。这组权限决定了 Bot 网关能读到什么、能回什么im:message.p2p_msg:readonly读取用户发给机器人的单聊消息im:message.group_at_msg:readonly读取群聊中被 的消息im:message:send_as_bot以应用机器人身份发送消息。第五步配置事件订阅打开事件与回调。选择长连接WebSocket模式。添加事件im.message.receive_v1。保存。选择长连接模式意味着飞书平台会主动把新消息推送到应用的长连接上无需为 CCR 提供可被外网访问的回调地址——这与 CCR 本地 Bot 网关的定位一致事件订阅是 Agent 收到消息后真正进入执行流程的「入口事件」。第六步发布或安装应用打开版本管理与发布创建新版本。确认可见范围——测试阶段先选你自己或一个小范围成员即可。提交发布。若企业启用了审核机制需等待审核通过。在飞书客户端中找到该应用或把机器人加入目标群。发布动作决定机器人对哪些成员可用。应用未发布到当前成员的可见范围往往是「聊天窗口没有输入框」或「机器人没响应」的隐藏原因。在 CCR 中接入Bot 管理应用在飞书侧就绪后回到 CCR 界面完成接线打开 CCR 的Bot 管理页面点击添加 Bot。平台选择飞书Feishu。认证方式选择App Secret。填写App ID与App Secret。若使用 Lark 或特殊域环境填写Domain。保存该 Bot。打开Agent 配置编辑要接 Bot 的 Agent 配置。打开Bot开关并选择刚保存的 Bot。按需打开转发 Agent 消息或接力见下一节。从 CCR 重新打开 Agent。最后一步至关重要AgentClaw 是「跟随 CCR 托管的 Agent App 生命周期」工作的只有在 CCR 管理下的 Agent App 存活期间Bot 才会保持在线。这也是 setup.md 明确要求的入口模式必须包含 App如App only或CLI App的原因。从实现层面看把 Bot 挂到 Agent 配置后CCR 会在启动 Agent 时向 Bot 网关进程注入一组CCR_BOT_GATEWAY_*环境变量见 bot-gateway/env.ts其中包括CCR_BOT_GATEWAY_PLATFORM本次运行的平台如feishuCCR_BOT_GATEWAY_AUTH_TYPE认证方式如app_secretCCR_BOT_GATEWAY_CREDENTIALS_JSONApp ID、App Secret 等凭据CCR_BOT_GATEWAY_CONFIG_JSONDomain、transportwebsocket等集成配置CCR_BOT_HANDOFF_*系列接力开关、空闲秒数、屏幕锁/用户空闲判定等。值得注意的是env.ts 中resolveBotGatewayConfig会根据打开的 surface 判断只有当 surface 为app时 Bot 网关才会启用否则一律把enabled置为false。这从源码上解释了「CLI 单独启动的 Agent 不参与 Bot 转发」这一行为边界。转发还是接力两种消息模式转发 Agent 消息Forward agent messages无论锁不锁屏都持续把 Agent 的可见输出转发到飞书。适合需要完整记录、团队观察或远程调试的场景。接力Handoff只在电脑锁屏且经过设定的空闲时间后才把后续交互转入飞书。配合空闲秒数与目标设备使用。若只想在锁屏后收到提醒使用接力即可不要同时开启转发 Agent 消息否则工位上的输出也会被镜像进飞书。接力的判定逻辑在仓库中有明确体现handoff 配置包含enabled、idleSeconds、screenLock、userIdle等字段env.ts空闲秒数默认值为 30。也就是说接力按「屏幕锁 用户空闲」双重条件触发Wi-Fi/蓝牙手机目标仍属于实验性配置不会影响当前运行时判定。Agent 进入飞书会话后可以通过命令切换工作区与会话例如/project list /project use 1 /session list /session use 1然后直接发送自然语言消息即可驱动 Agent也可以一句话开启新会话/session new 修复登录问题当 Agent 请求授权或输入时飞书若支持卡片按钮可直接点击否则使用文本命令应答/session approve /session deny /session answer 使用第二个选项查看状态与诊断/session status /session doctor /session deliveries按 agentclaw.md 的约定Bot 只暴露/project与/session两个公共命令域其余/命令会返回未知命令提示普通自然语言消息会作为提示词进入 Agent。测试验证从 CCR 打开 Agent触发一条消息。到飞书确认应用能收到消息并回复。群内使用前先把应用加入目标群并确认成员可见。如何判断接入成功飞书会话里能看到 Agent 的输出你在飞书里回复后 Agent 能继续执行。更严谨的验证方式摘自 setup 文档包括在 IM 中发送/project current确认 Bot 在线且能读取当前 Project发送/session list确认会话列表发送一条普通消息确认 Agent 会跑并回复锁屏并等待超过接力空闲秒数后确认后续 Agent 消息进入飞书。常见问题与排查认证失败重新复制 App ID 与 App Secret确认没有多余空格或串行字符。聊天窗口没有输入框依次检查机器人能力是否开启、事件订阅是否配置、应用是否发布到当前成员的可见范围。群里没有响应先 机器人测试并确认事件订阅包含im.message.receive_v1同时开通了「读取群聊中 机器人的消息」权限。Lark / 特殊域确认 CCR 中 Domain 填写的是平台实际要求的域名值避免使用中国大陆飞书默认域。参考与延伸阅读本主题英文原稿docs/src/content/docs/en/agentclaw/feishu.md中文版见 docs/src/content/docs/zh/agentclaw/feishu.mdAgentClaw 总览三种模式、支持矩阵、命令域docs/src/content/docs/en/agentclaw.mdAgentClaw 使用与配置总流程docs/src/content/docs/en/agentclaw/setup.mdBot 网关运行时环境变量与平台归一化实现packages/core/src/agents/bot-gateway/env.ts接力目标设备扫描Wi-Fi/蓝牙实现packages/core/src/agents/bot-gateway/handoff-scan-service.ts【免费下载链接】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），仅供参考