Feishu Bridge 是一款专为飞书机器人与 Clawdbot Gateway 之间建立本地 WebSocket 长连接而设计的轻量级桥接工具。它允许用户在无需公网服务器、域名或依赖 ngrok 等反向代理的情况下，将飞书消息无缝接入 AI 智能体服务。该工具通过飞书开放平台创建的自建应用机器人作为入口，利用飞书 SDK 的出站连接能力，实现从飞书云端到本地运行桥接服务的稳定通信链路。桥接成功后，每条飞书会话会映射为独立的 Clawdbot 对话会话（格式为 `feishu:`），从而实现跨平台的智能交互体验。整个部署过程仅需配置 App ID 和 App Secret，即可快速启动并管理桥接服务，极大降低了飞书机器人集成到私有化 AI 系统的技术门槛。
核心功能特点
- 基于 WebSocket 长连接实现飞书与 Clawdbot 的本地直连，无需公网 IP 或反向代理
- 支持自动身份认证，使用网关令牌安全对接 Clawdbot Gateway
- 每条飞书聊天独立映射为 Clawdbot 会话，支持多用户并发交互
- 提供 macOS launchd 服务配置脚本，支持开机自启与自动重启
- 内置日志输出与状态检查命令，便于排查连接问题与服务管理
- 可自定义群聊响应规则，如 @提及、问号结尾、特定动词触发等
适用场景
Feishu Bridge 特别适合企业内部部署私有 AI 助手并与飞书办公生态深度集成的场景。例如，企业可在不暴露内部系统到公网的前提下，将飞书群聊或私聊中的消息实时转发至本地运行的 AI 模型，实现智能问答、数据分析、会议纪要生成等功能。对于开发者而言，该工具是构建飞书机器人与本地 AI 服务桥梁的理想选择，尤其适合那些拥有自建 AI 基础设施但缺乏公网访问能力的团队。此外，由于其轻量化和自动化特性，也适用于需要长期稳定运行且具备自动恢复机制的客服机器人、知识库查询系统等生产环境应用。通过桥接服务，企业既能保障数据安全，又能充分利用飞书的即时通讯优势，提升协作效率。