远程连接

装了 Vonvon Bot 的每台电脑或服务器都是一台“设备”。Bot 可以跑在办公室的 Mac、家里的 Windows 或一台 Linux 服务器上，你在手边这台电脑的桌面端里把它加进来，切过去，就用同样的界面管那台的 Bot、群和设置。

适合这些情况：Bot 要 24 小时在线；代码在另一台机器上，Bot 得在那里干活；你有几台电脑，想在一处管。

哪台跑什么#

• Bot 和它的数据都在被连的那台上。Codex 或 Claude 也装在那台、在那台登录。
• 切过去以后，看到的 Bot、群、设置都是那台的；选文件夹，选的也是那台上的文件夹。
• 退出你这台电脑上的 Vonvon Bot，不影响那台上的 Bot。
• 管别的设备要用 Mac 或 Windows 桌面端，浏览器里的网页端只能管本机。

推荐做法：Tailscale + 桌面端#

两台都装上 Tailscale、登录同一个账号，就能用 100.x 开头的地址直接连，不用开端口，也不经过公网。两台在同一个局域网里时，也可以直接用局域网地址；ZeroTier 这类组网工具分的地址也行。两台都要是 0.9.0 或以后的版本，建议都升到最新。

1. 在被连的那台装好#

Mac、Windows：到下载页下载桌面端，装好打开，它自带服务端。

Linux：SSH 登录服务器，运行下面这条，只装服务端：

sh -c "$(curl -fsSL https://dl.vonvon.cc/bot/server/install.sh)"

看到“装好了”就装上了。退出 SSH 后它还在不在跑、开机会不会自己起来，看最后几行，对照下面的Linux一节。支持 x64 和 arm64、glibc 2.28 以上的发行版，例如 Ubuntu 20.04、Debian 10、RHEL 或 Rocky 8 及以后，不支持 Alpine 这类 musl 系统。卸载用下面这条，数据目录 ~/.vonvon-bot 留着：

sh -c "$(curl -fsSL https://dl.vonvon.cc/bot/server/uninstall.sh)"

2. 在那台开启并生成连接链接#

1. 打开 Vonvon Bot → 设置 → 设备，在设备列表下面找到「允许别的设备连接本机」（0.9.0 版在 设置 → 应用与启动 页）。
2. 在「别的设备用哪个地址连过来」里选一个地址，有 Tailscale 时它标着“推荐”。点「开启」，等状态变成“监听中”。
3. 在「连接链接」里点「生成连接链接」，再点「复制」。

Linux 服务器没有桌面端，在终端里做这一步，见只用命令行。

3. 在你的电脑上添加#

1. 打开 Vonvon Bot → 设置 → 设备，点「添加设备」，把链接粘进去。
2. 起个名字，点「连接并添加」。
3. 看到“已添加”就配好了。点「切换到」过去，它在设备列表里显示“在线”。

使用远程设备#

一次看一台。点左上角的设备名切换，切过去整个界面都换成那台的；第一行永远是“这台电脑”。这里也能「添加设备…」和「管理设备…」。

• 改名：你这台电脑上给它起的名字，在设置 → 设备的列表里点「⋯」→「改名」。那台自己的名字（别的设备配对时看到的），在它的「允许别的设备连接」→「设备名字」里改。
• 先在那台把 Codex 或 Claude 装好、登录，再照平常添加 Bot。
• 升级那台的服务端：切过去，打开设置 → 应用与启动，在“「设备名」的服务端”里检查更新。会重启服务端，正在进行的对话会中断。Mac 上桌面端自带的服务端，要那台的 Vonvon Bot 开着才能远程更新；Windows 上的，这一版要在那台电脑上打开 Vonvon Bot 更新。
• 两边版本不同时，界面顶部会提示“版本不一致”。两边不能一起工作时，只能先升级旧的那边。

访问和安全#

• 配对后每台电脑有自己的密钥，连接全程加密。授权不会过期，不再用的电脑要撤销：在被连的那台的「已配对的设备」里点「⋯」→「撤销」，Linux 上用 vonvon clients ls 和 vonvon clients revoke。撤销后那台电脑马上断开。
• 有新电脑配对时，被连的那台桌面端会弹出提示。不是你操作的，马上撤销。
• 暂时不想让别的电脑连：点「关闭远程连接」，或运行 vonvon remote disable。配对都留着，在同一个地址重新开启后会自己连上。
• 公网地址和运营商地址（不在 Tailscale 或组网工具上的 100.x）开启后，互联网上或同一运营商的人都能尝试连这台设备，所以要先勾「我了解风险」。建议用 Tailscale 或局域网地址。
• 连上的电脑都按你本人对待，什么都能改。

各平台当被连的那台#

Mac#

• 可以关窗口，别退出 Vonvon Bot：退出后服务端和 Bot 都会停。
• 电脑睡着了连不上，别让它自动睡眠。锁屏没关系。
• 重启后登录时自动跑起来：在设置 → 应用与启动里打开「登录电脑时启动」。重启后要有人登录这台 Mac（或者开了自动登录），Bot 才会上线。
• 开着防火墙时，第一次会问要不要让 Vonvon Bot 接受传入的网络连接，点允许。
• Mac 的桌面端带 vonvon 命令：打开过一次 Vonvon Bot 后，新开一个终端就能用，下面只用命令行的命令在 Mac 上也能用。

Windows#

• 可以关窗口，别退出 Vonvon Bot；电脑睡着了连不上，别让它自动睡眠。
• 这一版没有登录时自动启动，重启后要登录、打开 Vonvon Bot。
• 第一次开启时，Windows 会问是否允许 Vonvon Bot 访问网络，把专用网络、公用网络都勾上，点「允许」。点过「取消」的话别的设备连不上：到 Windows 安全中心 → 防火墙和网络保护 → 高级设置 → 入站规则，删掉名为 Vonvon Bot 的「阻止」规则（要管理员权限），再关掉、重新开启。
• 端口固定是 7767，改不了；被别的程序占着时，关掉那个程序后会自己开始。Windows 桌面端这一版不带 vonvon 命令。

Linux#

安装命令的最后几行说明 Bot 能不能开机自动启动：

没看到 vonvon 命令时，重开一个终端，或运行 . ~/.bashrc（zsh 用 . ~/.zshrc）。

只用命令行#

Linux 服务器上，或者在 Mac 的终端里（Windows 这一版没有命令行），在被连的那台开启：

vonvon remote enable

它会列出这台设备的地址，标好 Tailscale、组网、局域网等类型，回车选默认的那个。在脚本里、或者让终端里的 Codex、Claude Code 替你运行时，直接写地址，比如 Linux 上的 Tailscale 地址：

vonvon remote enable "$(tailscale ip -4)"

再生成连接链接，粘到你电脑上的「添加设备」里（第 3 步）：

vonvon pair

飞书里的 Bot 不能替你开启或生成链接，这几步要你自己或终端里的 AI 来做。

排错#

没有能选的地址#

这台设备上没有别的设备能连过来的地址。两台都装上 Tailscale、登录同一个账号，或者连到同一个局域网，再点右上角的刷新。

一直是“等地址出现”#

这台设备现在没有这个地址，比如开机时 Tailscale 还没连上，出现后会自动开始。一直不出现，换一个列出来的地址。写着端口被占用的，Mac、Linux 用 vonvon remote port 换一个端口；Windows 关掉占着 7767 的程序。

链接过期或已经用过#

链接 10 分钟内有效，只能用一次，在那台再生成一条。提示这条链接已经被用掉了、又不是你用的：马上到那台撤销不认识的电脑，再生成新的。

添加时连不上#

• Tailscale：两台登录的是同一个账号吗？在你的电脑上运行 tailscale ping 加那台的地址试一下；Mac 上没有 tailscale 命令时，在 Tailscale 的设备列表里看那台在不在线。
• 局域网：两台在同一个局域网里吗？
• 通了还连不上，看那台的防火墙：Windows 见上面，Linux 看 ufw、firewalld 有没有放行这个端口。

你的 Mac 上用局域网或组网地址连不上#

macOS 15 起，你这台 Mac 可能拦住了 Vonvon Bot 访问本地网络，局域网地址和 ZeroTier 这类组网地址都会连不上。弹出询问就点「允许」再试；没有弹出，打开 系统设置 → 隐私与安全性 → 本地网络，把 Vonvon Bot 打开。Tailscale 地址不受这个限制。

提示身份和配对时不一样了#

那台可能重装过、换了数据目录，也可能是别的机器占了它原来的地址。为安全起见已断开。确认是你自己的设备后，在设备列表里点「重新配对」，粘一条那台新生成的链接。

那台换了地址或端口#

在那台生成一条新链接，粘到「添加设备」里。提示“已按新链接更新了它的地址”就好，不用重新配对。

下一步#

• 切到那台，把 Codex 或 Claude 配好，再添加 Bot。
• 还没装桌面端的电脑，到下载页下载。
• 遇到这里没写的问题，到交流群里问。