proxycast/docs/aiprompts/remote-runtime.md

Remote runtime 主链

这份文档回答什么

本文件定义 Lime 当前 Remote / SDK / Server Mode 的唯一 remote runtime 事实源，主要回答：

• 哪些远程入口才算当前产品主链
• 消息渠道、浏览器连接器 / ChromeBridge、OpenClaw、DevBridge、telegram_remote 分别属于哪一层
• 哪些路径负责真实 ingress / control plane，哪些只是安装壳、调试桥或兼容入口
• 后续新增 remote 能力应该往哪里收敛，而不是继续长平级旁路

它是 远程入口与控制面的 current 文档，不是 OpenClaw 页面说明，也不是单条渠道命令的局部注释。

什么时候先读

遇到以下任一情况时，先读本文件：

• 调整 gateway_channel_*、gateway_tunnel_*、渠道 probe 或多账号渠道运行时
• 调整浏览器连接器、ChromeBridge、远程调试入口或 browser backend policy
• 调整 DevBridge HTTP 桥、浏览器 dev shell 的后端接通逻辑
• 调整 OpenClaw Gateway、Dashboard、安装与运行态管理
• 调整单通道 Telegram 远程触发入口，或评估是否应该继续保留它

如果一个需求同时碰到“远程触发 + 浏览器接入”“渠道入口 + 本地 Gateway”“调试桥 + 产品运行时”中的两项以上，默认属于本主链。

固定 remote 主链

后续 Lime 的 remote runtime 只允许向下面这条主链收敛：

外部入口（消息渠道 / 浏览器连接器） -> 当前本地 control plane -> agent/browser runtime -> 现有 session/task/evidence 事实源

这条主链的固定判断是：

1. 消息渠道 runtime 是当前 IM 远程入口主链
2. 浏览器连接器 / ChromeBridge 是当前浏览器侧远程 transport 主链
3. OpenClaw 只作为本地 Gateway / 安装 / Dashboard 兼容壳，不再定义新的 remote 真相
4. DevBridge 只作为 debug-only 开发桥，不再冒充产品 remote runtime
5. telegram_remote_cmd 是旧单通道入口，不再继续扩成长期主链

固定规则只有一句：

后续新增 remote 能力时，只允许接到 消息渠道 runtime 或 浏览器连接器 / ChromeBridge 这两条 current ingress；不允许再造第三条并列 remote runtime。

代码入口地图

1. 消息渠道 runtime

• src/lib/api/channelsRuntime.ts
• src-tauri/src/commands/gateway_channel_cmd.rs
• lime_gateway::{telegram, feishu, discord, wechat}

当前这里负责：

1. 多渠道 start / stop / status
2. 渠道账号 probe、登录、运行时模型绑定
3. tunnel / webhook 暴露与同步
4. 远程入站请求到本地 agent runtime 的 current 渠道入口

固定规则：

• 渠道远程入口统一走 gateway_channel_* 与 gateway_tunnel_*
• 前端当前主入口是 channelsRuntime.ts
• 不再把单独某个平台 bot runtime 重新拉回产品级总入口

2. 浏览器连接器 / ChromeBridge

• src/lib/webview-api.ts
• src-tauri/src/commands/browser_connector_cmd.rs
• src-tauri/src/services/browser_connector_service.rs
• src-tauri/src/commands/webview_cmd.rs
• src-tauri/src/commands/browser_runtime_cmd.rs

当前这里负责：

1. 浏览器连接器安装、启停与权限配置
2. ChromeBridge 端点、连接状态与 connector session 断开
3. 外部 Chrome profile / CDP / managed browser backend 状态
4. Browser Assist 与远程浏览器接入的 current transport 事实

固定规则：

• 浏览器侧 remote transport 统一收口到 webview-api.ts
• browser_connector_cmd.rs 只负责设置与安装入口
• 真正的 session / backend / remote debugging 状态继续由 webview_cmd.rs、browser_runtime_cmd.rs 暴露

3. OpenClaw 本地 Gateway 壳

• src/lib/api/openclaw.ts
• src-tauri/src/commands/openclaw_cmd.rs
• src-tauri/src/services/openclaw_service/*
• src/components/openclaw/*

当前这里负责：

1. 本地安装、升级、环境检查
2. 本地 Gateway 进程拉起、停止、重启
3. Dashboard URL、健康检查、运行环境选择
4. 兼容页面与过渡操作壳

固定规则：

• OpenClaw 当前不是 remote runtime 的唯一事实源
• 它管理的是“本地 Gateway 壳与安装体验”，不是远程 session/control plane 真相
• 后续如果保留，只允许继续做 compat 支撑，不再扩成第二套产品 remote coordinator

这一步里“OpenClaw 属于 compat”是基于现有仓库实现和产品规划推断：

• 代码上它主要暴露安装、环境、Gateway、Dashboard 与 runtime candidate 管理
• 产品规划里它已被明确定位为“过渡安装入口”，不是长期一级产品导航

4. DevBridge

• src-tauri/src/dev_bridge.rs
• src-tauri/src/dev_bridge/*
• src/lib/dev-bridge/*

当前这里负责：

1. 仅在 debug_assertions 下提供 3030 HTTP 桥
2. 让浏览器 dev server 调用现有 Tauri 命令
3. 为浏览器开发模式提供事件流和本地后端接通能力

固定规则：

• DevBridge 是 debug-only 开发桥，不是产品 remote runtime
• 它可以桥接 current 命令，但不能反向定义 current remote taxonomy
• 后续只允许继续做开发态适配与调试支撑

5. telegram_remote_cmd

• src-tauri/src/commands/telegram_remote_cmd.rs

当前这里负责：

1. Telegram 单通道轮询
2. 将命令映射到 agent.run / agent.wait / agent.stop / cron.* / sessions.*

固定规则：

• 它当前没有前端主入口
• 多渠道 current 主链已经迁到 gateway_channel_cmd.rs
• 后续只允许迁移、收口或下线，不再继续扩功能

current / compat / deprecated / dead

current

• src/lib/api/channelsRuntime.ts
• src-tauri/src/commands/gateway_channel_cmd.rs
• gateway_tunnel_*
• lime_gateway::{telegram, feishu, discord, wechat}
• src/lib/webview-api.ts
• src-tauri/src/commands/browser_connector_cmd.rs
• src-tauri/src/services/browser_connector_service.rs
• src-tauri/src/commands/webview_cmd.rs
• src-tauri/src/commands/browser_runtime_cmd.rs
• docs/aiprompts/remote-runtime.md

这些路径共同构成当前 remote 主链：

• IM 远程入口看 gateway_channel_*
• 远程浏览器 transport 看 browser connector / ChromeBridge
• 真实会话、任务与执行结果继续回到既有 agent/browser runtime 真相

compat

• src-tauri/src/dev_bridge.rs
• src-tauri/src/dev_bridge/*
• src/lib/dev-bridge/*
• src/lib/api/openclaw.ts
• src-tauri/src/commands/openclaw_cmd.rs
• src-tauri/src/services/openclaw_service/*
• src/components/openclaw/*

保留原因：

• DevBridge 仍是浏览器开发模式的必要桥接层
• OpenClaw 仍承接本地 Gateway、安装、升级与 Dashboard 过渡体验

退出条件：

• DevBridge 继续只做开发态桥接，不再承担产品 remote 叙事
• OpenClaw 若继续保留，也只能作为本地壳与兼容入口，不再扩成第二套 remote control plane

deprecated

• src-tauri/src/commands/telegram_remote_cmd.rs
• 任何继续把单渠道 bot runtime 直接定义为 remote 总入口的新实现
• 任何继续把 OpenClaw 页面或 DevBridge HTTP 桥当成产品 remote runtime 真相的新实现

dead

• 当前 M3 不新增远程面的强制删除项；本轮先完成 current 事实源收口，不做额外硬删

最低验证要求

如果本轮改动涉及本主链，至少按边界选择最贴近的验证：

• 纯文档 / 分类回写：npm run harness:doc-freshness
• 改渠道命令 / tunnel / webhook：npm run test:contracts 与相关渠道定向测试
• 改浏览器连接器 / ChromeBridge：浏览器相关定向测试或 verify:gui-smoke
• 改 DevBridge：至少补桥接定向测试
• 改 OpenClaw：至少补相关页面或命令定向测试

这一步如何服务主线

M3 的目标不是一次性重写所有 remote 功能，而是先把 remote 真相收成一条 current 主链。

从现在开始：

• 解释 IM 远程入口时，回到 gateway_channel_*
• 解释远程浏览器 transport 时，回到 browser connector / ChromeBridge
• 解释开发态浏览器接通时，回到 DevBridge compat
• 解释本地 Gateway / Dashboard 壳时，回到 OpenClaw compat
• 解释旧 Telegram 单通道触发时，视为 deprecated

这样后续 M4 Memory / Compaction 和 M5 State / History / Telemetry 就不必继续被 remote 入口语言打断。