命令行参考

vonvon 是 Vonvon Bot 的设备端命令行。它适合在运行 Bot 的 Mac 或 Linux 终端检查状态、查看日志，以及管理 Bot、群和任务。下面先给只读取、不改变配置的命令；会重启服务或修改数据的命令，请在看过对应页面后再用。

在哪台设备能用#

Mac 桌面版打开过一次后，会注册 vonvon 命令；新开一个终端再试。Linux 独立服务端安装后也提供命令。如果终端仍提示找不到命令，先检查安装步骤的最后提示和终端路径。Windows 桌面版目前 不提供 vonvon 命令，请用桌面界面操作。

命令作用于当前终端所在的设备，不是桌面端此刻选中的远程设备。例如在自己的 Mac 终端运行 vonvon daemon status，查的是这台 Mac；要查 Linux 服务器，请在服务器自己的终端或 SSH 会话里运行。远程设备如何连接与切换，见远程连接。

先用只读命令定位问题#

先看整体命令清单和版本：

vonvon --help

vonvon --version

确认后台是否运行，再看最近日志：

vonvon daemon status

vonvon daemon logs

列出 Bot、群和当前 Provider 环境：

vonvon bot list

vonvon group list

vonvon env scan

bot list 和 group list 需要后台可连接；环境检测结果要结合Provider 检测排错理解。想看机器可读结果，可在支持的子命令后加 --json，例如：

vonvon snapshot --json

Bot、群与设备的作用范围#

有多个 Bot 时，许多 Bot 相关命令需加 --bot 指定目标；群目标写法随子命令不同：settings、session 和按群操作的 schedule 使用 --group；group show/set/unbind 把群名或 ID 直接写在子命令后，例如 vonvon group show 研发群；group bind 则直接接飞书群 ID。具体以各子命令的 --help 为准。先用 vonvon bot list、vonvon group list 看清目标，再执行修改命令。vonvon settings get --host 读的是整台设备的设置，不是某个群：

vonvon settings get --host

在 Bot 自己启动的会话中使用 CLI 时，Vonvon 会限制它能访问的 Bot 和群。更新、配对、远程连接设置、服务安装等设备管理命令不允许由群里的 Bot 会话执行；请在设备终端或桌面端亲自操作。也不要把带凭据的连接链接、密钥或完整日志直接贴到群里。

常用的其他命令#

命令的选项和格式以本机当前版本的 vonvon <子命令> --help 为准。比如 vonvon schedule --help 会列出新增、编辑、暂停、恢复、立即运行、查看记录和删除。不要从旧 Bridge 或其他版本复制命令后直接执行。

命令报错后怎么查#

• “找不到命令”：Mac 先打开一次 Vonvon 再新开终端；Linux 对照安装完成提示；Windows 改用桌面端。
• “连接不到后台”：先运行 vonvon daemon status；后台没运行时到桌面端「应用与启动」或 Linux 服务状态处理，再重试原命令。
• “找不到 Bot 或群”：列出当前设备上的 Bot 和群；确认是否在正确设备上，以及是否需要 --bot、--group。
• “权限不足”或“不能在 Bot 会话中运行”：确认命令的作用范围，设备管理操作改在自己的终端或桌面端执行。