Open Interpreter 如何用 --remote 把 TUI 客户端连接到远程 app-server WebSocket 端点？

Open Interpreter 如何用 --remote 把 TUI 客户端连接到远程 app-server WebSocket 端点【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreterOpen Interpreter 的公共启动器默认会为 TUI 启动一个本地 app-server 运行时——直接运行interpreter即可终端 UI 和运行时在同一路径的前台进程中退出 UI 就结束会话普通使用不需要任何额外配置。但当你想让 TUI 客户端连到一个独立的 app-server 进程本机另一个端口或另一台机器上的端点时就需要用--remote标志把 TUI 指向一个 WebSocket 端点。本文基于项目文档 docs/remote.md、docs/app-server.md 和 docs/daemon.md说明这条连接路径的完整命令、带令牌的安全远程接入方式以及可选的共享 daemon 变体。什么时候需要 --remote文档把 remote 模式定义为高级集成接口advanced integration surface大多数用户应正常运行interpreterTUI 会启动嵌入式本地运行时不要求守护进程。只有在需要 TUI 与 app-server 分离部署、或有多个客户端共享同一运行时例如编辑器集成和终端连到同一台机器时才使用--remote。docs/cli-reference.md 中对这两个相关全局标志的定义Flag用途--remote ws-urlConnect the TUI to a remote app-server endpoint.--remote-auth-token-env varRead the remote bearer token from an environment variable.主路径本机启动 WebSocket 服务并连接 TUIdocs/app-server.md 给出了最小可用组合。app-server 有两种监听方式stdio://用于 SDK 式的子进程集成当需要另一个独立客户端连接时才用 WebSocket 传输。因此 WebSocket 场景的启动命令是interpreter app-server --listen ws://127.0.0.1:9000然后在客户端机器上本机同一终端窗口之外的另一个会话或另一台机器连接 TUIinterpreter --remote ws://127.0.0.1:9000docs/remote.md 使用的就是这组127.0.0.1:9000示例可直接照抄作为本机验证。--remote后面的值就是服务端的监听地址客户端连上后会话状态、模型选择等能力由对端 app-server 提供而不是客户端进程自带的本地运行时。安全远程接入TLS bearer token当服务端不严格位于本机时docs/app-server.md 的要求是在前面终结 TLS并强制 bearer token。客户端侧的完整命令export INTERPRETER_REMOTE_TOKEN... interpreter --remote wss://agent.example.com \ --remote-auth-token-env INTERPRETER_REMOTE_TOKEN要点把令牌存放在--remote-auth-token-env指定的环境变量中上例为INTERPRETER_REMOTE_TOKEN不要直接写进命令行参数。...处替换为你实际的令牌值。文档明确要求不要把无认证的 app-server 监听器暴露在公共网络上。令牌是面向安全传输wss://设计的。对于明文ws://文档建议只使用 localhost 或其他明确受信任的本地端点不要配合令牌走明文网络传输。这里agent.example.com是文档示例域名实际使用时替换为你自己的 TLS 终结端点。可选变体用共享 daemon 替代手工启动的 app-server如果你的目标是多个客户端共享同一运行时而不是把服务放到远端机器文档提供的替代路径是共享 daemon。它监听本地 Unix socket而不是 WebSocket 端口interpreter app-server daemon start interpreter app-server daemon restart interpreter app-server daemon stop interpreter app-server daemon versionstart会启动一个监听本地 unix socket 的 daemon并在健康检查通过后返回对已经健康的 daemon 重复执行start会直接复用不会启动第二个实例。客户端连接方式同样是--remote只是端点换成 daemon 的 Unix socket 地址interpreter --remote ws-url-or-unix-socket这里ws-url-or-unix-socket需要替换为 daemon 实际的 socket 路径文档未给出固定路径值。另外如果你显式启动了这个可选 daemon且启动设置兼容TUI 可以复用它的 Unix socket——见 docs/daemon.md。daemon 的运行时文件位于 Open Interpreter home 目录下默认~/.openinterpreter可用环境变量INTERPRETER_HOME覆盖。连接与启动问题的排查文档只给出 daemon 相关的两条已知现象与处理方式与当前场景直接相关start报告 app server 已在运行但不由 daemon 管理——说明另一个进程已经占用了 daemon socket。处理方式是停掉那个进程或使用不同的 home 目录。更新或崩溃后 daemon 状态卡住——执行interpreter app-server daemon stop后重新start。stop会终止 daemon 进程执行前确认没有其他客户端还依赖该运行时。启动问题的第一排查位置是 daemon 日志在~/.openinterpreter下。对于--remote本身文档没有给出额外的错误码或健康检查命令可判断的信号就是服务端进程在监听ws://127.0.0.1:9000或你的 TLS 端点可达客户端以--remote url启动后 TUI 进入的是对端 app-server 提供的会话。限制与边界ws://明文传输仅限 localhost 或明确受信任的本地端点远程部署走wss://并强制 bearer token。remote 模式是高级集成接口不要把它当作日常使用的默认方式默认路径依然是直接运行interpreter。完整协议形态来自 Codex app-server 协议Open Interpreter 保持其兼容面协议细节参考 Open Interpreter 的 App Server 文档指向的上游协议说明。完成本机验证ws://127.0.0.1:9000之后若要接入真实远程端点按上文 TLS token 一节配置即可若只是多客户端共享改走 daemon 路径。【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考