BOTBUS / 博客

在手机上用 OpenCode:看会话、续聊、新开任务

OpenCode 官方没有手机 app。这篇对比 opencode web、社区手机客户端和 BotBus 几种在手机上用 OpenCode 的办法,讲清各自适合谁和限制。

先说结论

截至 2026-10-06 核对,OpenCode 官方提供的是终端程序、桌面 app、几款编辑器插件和 opencode web 网页界面,没有官方手机 app。想离开电脑也能看 OpenCode 的会话、接着聊或者新开一个任务,可以把 opencode web 开到局域网或隧道上用手机浏览器打开,装社区做的手机客户端,或者用 BotBus:它在电脑上读 OpenCode 的会话,经端到端加密的中转同步到手机和 Apple Watch,你在手机上续聊、新建、中断,不用把 OpenCode 的端口开出去。

下面先说清楚 OpenCode 自己的远程办法各适合谁,再讲 BotBus 具体能做什么、做不到什么。

OpenCode 官方现在有哪些端

以下是 2026-10-06 在 opencode.ai 的下载页和文档里核对到的情况:

所以“在手机上用 OpenCode”,本质是让手机碰到电脑上的 OpenCode 服务,或者换一条路把会话同步出去。

几种免费办法,各适合谁

局域网直连 opencode web。 在电脑上用 --hostname 0.0.0.0 和一个固定端口启动,设好 OPENCODE_SERVER_PASSWORD,手机连同一个 Wi-Fi 打开电脑的地址就行。这是最省事的办法,界面和电脑上的网页版一样完整。限制也很明显:出了这个 Wi-Fi 就连不上;网页界面不是为小屏设计的;手机浏览器切到后台以后,OpenCode 停下来等你时手机不会响。

Tailscale、Cloudflare Tunnel 或反向代理。 想在外面也能打开,就给这个服务加一层组网或隧道。社区手机客户端的文档推荐的也是这条路:opencode serve 加认证,再经 HTTPS 隧道或代理暴露出去。适合本来就在用 Tailscale 或会配 Caddy、Nginx 的人。代价是你要自己维护一个对外的入口,密码、证书、访问范围都要自己管,服务一开到公网上,安全就由你负责。

社区手机客户端。 搜 “opencode mobile” 能找到几款:有的是 Android 原生客户端,有的同时有 iOS 测试版,有的把网页界面包成手机 app。它们直接说 OpenCode 的 HTTP 接口,功能贴 OpenCode 很近,不经过第三方中转。选的时候看清楚它要你怎么暴露服务、怎么鉴权,iOS 版是否已经正式发布。

如果你只用 OpenCode、会折腾网络、想要和电脑上一样完整的界面,上面几条都能用。BotBus 适合的是另一种情况:你同时在用 OpenCode 和 Codex、Claude Code 这些别的 agent,想在一个列表里看所有任务、跑完时手机响一下,又不想开端口、不想改 OpenCode 的配置,也不想记得每次先手动起一个 opencode web。

BotBus 怎么接 OpenCode

前提先说清楚:OpenCode 的命令行程序装在跑 BotBus 的那台电脑上,并且已经在 OpenCode 里配好了能用的模型;电脑要开着、联网。电脑端有 Mac 版(菜单栏应用,需要 macOS 26 或更新)和 Linux 版(x86_64 / aarch64 的命令行程序,见安装说明),装最新版即可。

OpenCode 在 BotBus 里是内置支持的 agent,走的是 ACP(Agent Client Protocol),不用写任何配置文件。BotBus 会在 PATH 和官方安装目录 ~/.opencode/bin 里找 opencode 命令。只装了桌面 app 没装命令行程序的话,需要先把命令行装上,因为手机上的续聊和新建都要靠它。

它看见会话的方式很简单:OpenCode 的桌面 app 和终端程序共用一个本机数据库,BotBus 每 5 秒只读地查一次,列出最近 7 天的会话,不分项目,跳过已归档的会话和子代理会话。查看历史只读这个数据库,不会为了看一眼就把会话载入、占住。手机上显示的是对话本身,模型的思考过程不显示。

BotBus 手机上的电脑任务列表

在手机上能做什么

看会话和对话记录。 你在桌面 app 或终端里开的 OpenCode 会话,和别的 agent 的任务一起按电脑、项目排好,点进去能读完整对话。

收推送。 任务跑完或者失败时手机会收到通知(前提是手机开了通知权限)。电脑上那些会话的状态来自每 5 秒一次的数据库扫描,所以会有几秒的延迟。

续聊。 一轮结束后想补一句“顺便把测试跑一遍”,在手机上打开会话直接发。BotBus 在电脑上用 opencode acp 载入原来那个会话,把你的话发进去,结果写回同一个会话记录,回到电脑在 OpenCode 里接着看就行。续聊的通用做法见手机续聊 agent 会话。

新建任务。 在手机上选项目、写需求,BotBus 在电脑上起 OpenCode 跑这一轮。手机发起的这些轮次里,agent 可以用 BotBus 提供的工具把文件、网页预览和链接发回手机,比如让它改完页面后把预览发过来。

BotBus 手机上新建任务

审批。 OpenCode 默认大部分工具直接放行,只有重复调用同一个工具、访问项目目录以外的路径这类情况会问你;你也可以在 opencode.json 里把某些操作改成要确认。手机发起的轮次里,OpenCode 发出的确认请求会以审批卡片出现在手机上,可以允许或拒绝。通用的审批说明见在手机上审批 agent 请求。

中断。 手机发起的一轮跑偏了,在手机上点停止,BotBus 给 OpenCode 发取消。各 agent 中断的差异见远程停止 AI agent。

回到电脑接着做(Mac 版)。 菜单栏里 OpenCode 那一行会列出从手机发起的会话,点“继续聊”会打开“终端”,用 opencode --session <id> 在原来的目录里接上。

限制与边界

常见问题

OpenCode 有官方手机 app 吗?

截至 2026-10-06 核对没有。官方提供终端程序、桌面 app、编辑器插件和 opencode web 网页界面;能找到的手机客户端都是社区项目,需要你自己把 OpenCode 服务暴露给手机。

用 BotBus 需要开着 opencode web 吗?

不需要。BotBus 直接读 OpenCode 的本机数据库来列会话,续聊和新建时自己起 opencode acp,不依赖 opencode web,也不用往局域网或公网开端口。

只装了 OpenCode 桌面 app 可以吗?

能列出会话的前提是 BotBus 找得到 opencode 命令行程序。只有桌面 app 时,先按官方说明把命令行程序装上(装到 PATH 或 ~/.opencode/bin 都行)。

手机上发的消息,回到电脑能看到吗?

能。手机上的续聊写进原来的同一个会话;手机新开的会话在 OpenCode 的会话记录里也有,Mac 版还可以从菜单栏“继续聊”直接在终端里接上。

怎么开始?

在电脑上装最新版 BotBus,用手机扫电脑上的配对二维码,OpenCode 会自动出现在本机 agent 列表里。下载见官网首页。

← 全部文章