# 命令行参考

> 在运行 Bot 的设备终端里管理服务、Bot、群、任务和记忆。

来源：https://vonvon.cc/docs/cli/
更新时间：2026-11-04

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

## 在哪台设备能用

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

命令作用于**当前终端所在的设备**，不是桌面端此刻选中的远程设备。例如在自己的 Mac 终端运行 `vonvon daemon status`，查的是这台 Mac；要查 Linux 服务器，请在服务器自己的终端或 SSH 会话里运行。远程设备如何连接与切换，见[远程连接](https://vonvon.cc/docs/remote/#where)。

## 先用只读命令定位问题

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

```
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 检测排错](https://vonvon.cc/docs/providers/#not-detected)理解。想看机器可读结果，可在支持的子命令后加 `--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 schedule list --all` | 查看一个 Bot 在各群的定时任务；有多个 Bot 时加 `--bot`。创建、编辑、暂停和记录见[定时任务](https://vonvon.cc/docs/tasks/#manage)。 |
| `vonvon session list --group 研发群` | 查看这个群的会话；多会话群操作特定会话时再指定会话。 |
| `vonvon memory list --project 研发` | 查看“研发”项目的记忆；具体范围选项以 `vonvon memory list --help` 为准，修改前先读[角色与记忆](https://vonvon.cc/docs/memory/#three-kinds)。 |
| `vonvon remote status` | 查看这台设备的远程连接状态，配置方法见[远程连接命令行步骤](https://vonvon.cc/docs/remote/#cli)。 |
| `vonvon update --check` | 只检查服务端是否有新版本；实际更新及中断影响见[更新服务端](https://vonvon.cc/docs/updates/#server)。 |
| `vonvon import detect` | 在 Mac 上只检测旧 Bridge；迁移前请读[导入步骤](https://vonvon.cc/docs/bridge-import/#before)。 |

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

## 命令报错后怎么查

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