Skip to content

Remote Agent Gateway v0.2.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@zshs000 zshs000 released this 08 Aug 14:33
· 7 commits to main since this release
v0.2.1
f26868b

首个公开技术预览

Remote Agent Gateway 让 Claude、WorkBuddy、OpenClaw 等 MCP Client 通过一个自行部署的网关，发现并调用远程电脑、服务器和 CI 上的标准能力。远端 Agent 主动建立 WebSocket 连接，不需要公网 IP、入站端口、SSH 或单独运行 MCP Server。

已完成闭环

  • 用户注册登录、所有权隔离和独立 MCP Access Key
  • 一次性 Enrollment Token、长期设备凭据和安全重连
  • Agent 工作台按固定 Profile 组装 Python Agent ZIP
  • WebSocket v2 心跳、离线检测、取消、超时和每 Agent 5 并发保护
  • Web 管理端、SQLite 持久化和版本状态展示
  • Docker Compose 与 Caddy 反向代理示例

标准能力

  • shell.v1/exec -> remote_exec
  • workspace.v1/read -> remote_read_file
  • workspace.v1/write -> remote_write_file
  • workspace.v1/edit -> remote_edit_file

MCP 工具保持固定，AI 通过 list_agents 和 get_agent_capabilities 按需发现设备、Profile 契约与对应工具。

安全与兼容性

  • workspace.v1/write 默认安全失败：null 只允许新建，SHA-256 只允许覆盖完全匹配的已读取版本，不提供无条件强制覆盖。
  • workspace.v1 最低要求 Agent 0.2.1，更早草案会在注册或重连前被拒绝。
  • v0.2.1 是首个公开 Profile 契约基线；后续不会让已经发布的同名 Profile 静默改变语义。
  • 完整 Shell 拥有 Agent 系统账号权限，真正隔离仍需独立 OS 用户、容器、虚拟机或平台沙箱。

发布产物

  • GitHub 自动生成的源码归档
  • remote_agent_gateway-0.2.1-py3-none-any.whl
  • SHA256SUMS.txt

这是 Technical Preview，适合自行部署和体验，尚未承诺生产级稳定性。运行方法、MCP 配置、部署边界和未来方向见仓库 README。

Assets 4
Loading