摘要： Linco Bridge 是一个开放的 AI Agent 桥接层，用来将运行在个人电脑上的 Codex CLI、Claude Code、Hermes 和 OpenClaw，连接到 App、Web、H5、小程序或自定义客户端。本文介绍它解决的问题、四层架构、快速体验流程和安全边界。

关键词： AI Agent、Codex CLI、Claude Code、OpenClaw、Hermes、WebSocket、跨设备会话、开源

1. 问题不是“能不能远程登录”，而是 Agent 交互能否续上

Codex CLI、Claude Code 这类工具已经不只是回答代码问题。它们会读取项目、修改文件、调用工具、运行命令和测试，一个任务可能持续数分钟甚至更久。

真正的槽点是：人不可能一直守在终端前。

Agent 执行到一半，可能需要补充要求、确认权限，或者查看生成的文件。如果此时人已经离开电脑，任务很容易停在等待状态。

当然，开发者可以使用 SSH、远程桌面或终端复用工具。但在手机上，这些方式往往仍然要求用户操作终端界面，会话、权限请求、附件和生成文件也没有针对 Agent 交互进行结构化呈现。

另一种方式是把文字消息转发到普通聊天工具。这能解决“看到回复”，但不一定能解决“继续操作 Agent”。

Linco Bridge 瞄准的正是这个中间层：

Agent 继续在用户自己的电脑上执行，手机等远端客户端负责查看会话、发送消息、呈现流式输出和处理权限请求。

2. 实际效果

下图使用的是 Linco Bridge 项目实际界面。同一个项目会话可以在桌面端和移动端继续查看与交互。

这里需要特别区分两件事：

• Agent 执行位置没有变。 提示词、工具和文件操作仍由电脑上的 Agent 执行。
• 跨设备同步不等于上传全部历史。 具体可见性和保留策略取决于连接器、后端部署方式和客户端链路。

3. Linco Bridge 的四层架构

3.1 本地 Agent CLI

这一层是真正执行任务的地方。Agent 读取项目、调用工具、修改文件并运行命令。

3.2 linco-connect

linco-connect 运行在用户电脑上，负责：

• 适配不同 Agent CLI；
• 维护 channel、account 和 Agent 连接；
• 转换会话与结构化事件；
• 处理权限确认、附件和生成文件。

3.3 Channel / Server

连接器通过已鉴权的 WebSocket 连接到通道或后端。项目目前包含：

通道	用途
linco	官方 Linco 产品通道
linco-demo	开源参考平台，用于部署、验证和二次开发
自定义 channel	接入自有 H5、小程序、App、Web 或 IM

3.4 客户端

客户端负责展示会话、发送消息、呈现流式输出和权限请求。它可以是 Linco App、Reference Web，也可以是开发者自己的客户端。

4. 为什么普通消息转发不够？

AI Agent 的一次完整交互，至少可能包含以下状态：

1. 流式输出： 任务在执行中，用户需要持续看到进度。
2. 工具调用： 客户端需要区分普通回复和工具执行。
3. 权限请求： 危险操作或超出默认边界的操作，需要用户确认。
4. 项目与长会话： 会话不是孤立的消息，还与项目和历史上下文相关。
5. 附件与生成文件： 文件需要明确的访问和下发边界。

如果中间层只保留一个 text 字段，这些信息就会被压扁成普通聊天记录。Linco Bridge 的作用，是把它们作为 Agent 事件继续传递给远端客户端。

5. 当前支持范围

以下为 2026-07-27 仓库文档中记录的已验证版本。兼容性应理解为“按版本验证”，而不是永久不变。

Agent	已验证版本	接入说明
Codex CLI	codex-cli 0.142.5	默认使用 app-server 模式
Claude Code	2.1.198 (Claude Code)	使用 stream-json 与 stdio 权限确认
Hermes	Hermes Agent v0.13.0 (2026.5.7)	支持 Profile 列表与绑定
OpenClaw	OpenClaw 2026.5.18 (50a2481)	支持 Agent 列表与绑定

运行环境方面，当前支持 Node.js 20 或 22–26，推荐 Node.js 22 LTS。连接器依赖原生模块 better-sqlite3，因此当前不支持 Node.js 21。

6. 快速体验：三种路径

6.1 官方 Linco App

这条路径适合直接体验官方产品链路。在 App 的桥接页面选择 Agent 导入方式，然后在运行 Agent CLI 的电脑上执行页面生成的命令。

命令形态通常如下：

npm install -g linco-connect
linco-connect init --token "<app-id>:<app-secret>" --agent codex
linco-connect start --daemon

返回 App，确认连接器在线后，就可以进入会话。

6.2 官方在线 Demo

如果不想先部署平台，可以使用：

• H5：https://bridge-demo.lincotalk.com
• 微信小程序：搜索 agent桥接器

也可以使用微信扫描下方体验码：

打开“桥接 → 从 Codex 导入”，复制页面生成的
setupCommands，在电脑上执行，再回到页面刷新连接状态。

6.3 本地部署开源参考平台

适合本地验证、私有化评估和二次开发。

启动后端：

cd linco-bridge-platform/server
npm install
npm run start:dev

在另一个终端启动 H5：

cd linco-bridge-platform/web
npm install
npm run dev:h5

打开命令输出的 H5 地址，在“桥接 → 从 Codex 导入”中获取 setupCommands。一组典型命令如下：

npm install -g linco-connect

linco-connect init \
  --token "<app-id>:<app-secret>" \
  --agent codex \
  --channel linco-demo \
  --account "<account-id>" \
  --allow-insecure-ws

linco-connect start --daemon

--allow-insecure-ws 仅用于可信的本地开发环境，不应用在公网生产部署中。

停止连接器：

linco-connect stop

7. 部署和安全边界

这一部分不建议跳过。

7.1 在线 Demo 只用于体验

在线 Demo 使用签名匿名访客 Session，不提供正式账号、持久跨设备恢复或生产级多租户保证。请勿输入敏感数据和正式业务数据。

7.2 ws:// 仅用于可信本地环境

linco-demo 本地模式默认连接 ws://127.0.0.1:3300，用于本机开发和联调。如果部署到公网，应使用 HTTPS/WSS，并实现适合自己系统的鉴权、存储、审计、删除和日志脱敏策略。

7.3 TLS/WSS 不等于端到端加密

传输加密能保护网络链路，但不代表系统已实现端到端加密、零知识存储或完全本地处理。安全承诺必须与具体部署和审查结果一致。

7.4 文件和凭证也是安全面

文件下发应限制在允许的目录内，并继续拦截 .env、.git/config、.ssh/* 等敏感或隐藏路径。Token、App Secret、私钥和带鉴权信息的 URL 也不应进入代码仓库或完整日志。

8. 仓库里有什么？

linco-bridge/
├── linco-bridge-connect/    # 本地 Agent CLI 连接器
├── linco-bridge-platform/   # NestJS + UniApp 开源参考平台
│   ├── server/             # 鉴权、连接状态与消息转发
│   └── web/                # H5 / 小程序参考前端
└── docs/                   # 安装、架构、协议、安全与扩展文档

仓库不包含完整 Linco App，也不包含官方托管云服务实现。第三方接入应通过新增自定义 channel adapter 完成，不建议直接修改官方 linco 通道。

9. 这套方案适合谁？

适合：

• 长时间运行 Codex、Claude Code 等本地 Agent，需要移动端查看和干预的开发者；
• 想将现有 Agent CLI 接入自有 Web、App、小程序或 IM 的团队；
• 正在评估 Agent 跨设备交互、私有化部署和 channel adapter 架构的开发者。

暂不适合：

• 希望开源仓库直接提供完整生产 SaaS 平台的团队；
• 未评估实际数据链路，就准备直接处理敏感或正式业务数据的场景；
• 需要立即获得稳定 API 保证的生产项目，因为当前仍处于 Open Source Alpha 阶段。

10. 小结

Linco Bridge 解决的不是“手机上再放一个 AI 聊天页”，而是如何把本地 Agent 的会话、状态和交互能力续接到远端客户端。

它目前已支持 Codex CLI、Claude Code、Hermes 和 OpenClaw，同时提供开源连接器、NestJS + UniApp 参考平台和自定义 channel adapter 扩展点。

项目目前还在 Alpha 阶段。如果你正在使用这些 Agent，欢迎试一试，也欢迎把实际遇到的交互问题提到 Issue 中。

项目入口

• GitHub：https://github.com/lincotalk/linco-bridge
• 在线 Demo：https://bridge-demo.lincotalk.com
• 微信小程序：搜索 agent桥接器（体验码见第 6.2 节）
• 快速开始：https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/quick-start.md

---