oo-cli 命令参考
这一页汇总了
oo-cli
仓库里当前的 oo 命令体系。
这里应该作为网站里的权威命令参考。像 oo package info 这类旧例子已经过时， 当前应以 oo packages ... 和 oo cloud-task ... 这些命名空间为准。
全局选项
| 选项 | 作用 |
|---|---|
--debug | CLI 退出时把当前日志文件路径打印到 stderr |
--lang <lang> | 只对当前命令临时覆盖显示语言。支持 en、zh |
-h、--help | 显示当前命令帮助 |
-V、--version | 显示 CLI 版本、构建时间和 commit hash |
Debug 日志
oo 会把结构化日志持久化到按平台区分的目录：
- macOS：
~/Library/Logs/oo - Linux：
${XDG_STATE_HOME:-~/.local/state}/oo/logs - Windows：
%LOCALAPPDATA%\\oo\\Logs
这些日志覆盖远端 API 请求生命周期、浏览器登录回调、显式更新检查、settings /
auth 状态变化以及 sqlite cache 活动。CLI 最多保留最近 20 个日志文件。
认证
| 命令 | 作用 |
|---|---|
oo auth login | 启动浏览器登录流程，并保存当前账号 |
oo auth logout | 从持久化认证数据里移除当前账号 |
oo auth status | 显示当前账号，并校验 API Key 状态 |
oo auth switch | 切换到下一个已保存账号 |
oo login | oo auth login 的别名 |
oo logout | oo auth logout 的别名 |
配置
| 命令 | 作用 |
|---|---|
oo config list | 列出当前已持久化的配置 |
oo config get <key> | 读取某个配置值 |
oo config path | 输出配置文件路径 |
oo config set <key> <value> | 写入某个配置值 |
oo config unset <key> | 删除某个配置值 |
当前支持的配置键：
langfile.download.out_dir
值得注意的行为：
- 持久化 settings 文件里出现未知 key 时，CLI 会忽略它，并在日志中记录 warning。
file.download.out_dir接受任意非空路径字符串。- 相对下载路径会在执行
oo file download时相对于当前工作目录解析。
更新
| 命令 | 作用 |
|---|---|
oo install [version] | 把某个 oo 管理的 CLI 版本安装到本地受管运行时 |
oo update | 把受管 CLI 安装更新到最新发布版本 |
oo upgrade | oo update 的别名 |
oo check-update | 检查是否有新的 CLI 版本可用 |
如果存在新版本，oo 会输出当前包管理器对应的升级命令。
首次安装时，优先使用 oo-cli 指南里的官方安装脚本。
oo install [version] 更适合在需要安装或重装某个指定 CLI 版本时使用。
搜索与检索
混合搜索
| 命令 | 作用 |
|---|---|
oo search <text> | 用一条自由文本查询同时搜索 package 和 connector action |
值得注意的行为：
- JSON 输出会混合
package和connector两类结果，并用kind区分。 - connector 结果会带上
authenticated和schemaPath。
Connector 检索
| 命令 | 作用 |
|---|---|
oo connector search <text> | 用自由文本搜索 connector action |
oo connector schema <serviceName> | 查看某个 connector action 的 JSON schema 合约 |
oo connector schema refresh | 清理本地 connector schema 缓存 |
oo connector run <serviceName> | 校验输入并运行一个 connector action |
oo connector schema 的常用选项：
-a、--action <action>：指定目标 action 名--refresh：绕过缓存，重新拉取 schema--json：为兼容保留；schema 输出始终是 JSON
oo connector run 的常用选项：
-a、--action <action>：必填，要运行的 action 名-d、--data <data>：直接传 JSON，或用@path读取 JSON 文件--dry-run：只校验 payload，不真正执行--json：输出结构化结果
Package 检索
| 命令 | 作用 |
|---|---|
oo packages search <text> | 用自由文本按意图搜索已发布 package |
oo packages info <packageSpecifier> | 查看单个 package 的元数据 |
<packageSpecifier> 支持 foo/bar、foo/bar@latest 和 foo/bar@1.2.3
这几种形式。
Cloud Task
| 命令 | 作用 |
|---|---|
oo cloud-task run <packageSpecifier> | 校验输入值，并为某个 package block 创建 Cloud Task |
oo cloud-task list | 按需过滤并列出 Cloud Task |
oo cloud-task log <taskId> | 查看单个任务的分页日志 |
oo cloud-task result <taskId> | 查看单个任务的当前结果 |
oo cloud-task wait <taskId> | 轮询等待任务进入终态 |
关键说明：
oo cloud-task run要求使用PACKAGE_NAME@SEMVER。- 使用
-b、--block-id <block-id>指定目标 block。 - 使用
-d、--data <data>传入 JSON 或@path/to/file.json。 --dry-run只校验请求，不创建任务。oo cloud-task wait每3秒轮询一次，并支持--timeout。
Skills
| 命令 | 作用 |
|---|---|
oo skills list | 列出已安装到受支持 Agent 宿主里的 bundled、registry 和 local skills |
oo skills search <text> | 搜索已发布 skill |
oo skills sync | 同步 registry skill |
oo skills preflight --agent <agent> | 检查某个受支持宿主的本地 skill 编辑前置条件 |
oo skills init <name> | 在受支持的 Agent 宿主目录里初始化本地 skill |
oo skills validate <path> | 校验一个 skill 目录 |
oo skills publish <skill> | 把一个 skill 转成 OOMOL package 并发布 |
oo skills share [skill] | 为已发布 skill 生成分享提示词或分享链接 |
oo skills install [packageName] | 安装内置 skill 或已发布 skill |
oo skills update [skills...] | 更新已安装的 oo 管理型已发布 skill |
oo skills uninstall [skill] | 卸载内置 skill，或卸载某个 oo 管理型已发布 skill |
关键说明：
oo skills find <text>是oo skills search <text>的别名。oo skills add [packageName]是oo skills install [packageName]的别名。oo skills remove [skill]是oo skills uninstall [skill]的别名。- 直接执行
oo skills install且不带包名时，会安装内置 skill。 oo、oo-find-skills、oo-create-skill、oo-publish-skill这类内置 skill 会发布到已经存在的受支持本地宿主目录。- 受支持宿主包括 Codex、Claude Code、Hermes、WorkBuddy、Trae、OpenClaw 和
QoderWork。运行
oo skills preflight --help可以查看当前安装版本暴露的宿主列表。 - 已发布 skill 会安装到对应宿主的本地 skills 目录，例如 Codex 下的
${CODEX_HOME:-~/.codex}/skills/<skill-id>。 oo skills list --source bundled|registry|local可以按来源过滤列表。Bundled skills 随oo提供，registry skills 来自已发布的 skill package，local skills 是当前机器上创作的 skill。- 内置 skill 会在需要时自动同步，所以
oo skills update只负责已发布的 oo 管理型 skill。 - 当你不是只安装 skill，而是要创作可复用 skill 时，使用
oo skills init、oo skills validate、oo skills publish和oo skills share。
文件
| 命令 | 作用 |
|---|---|
oo file download <url> [outDir] | 从 http 或 https 地址下载文件到本地 |
oo file upload <filePath> | 把本地文件上传到临时文件缓存 |
oo file list | 查看本地 sqlite 里记录的上传文件 |
oo file cleanup | 删除本地 sqlite 中已过期的上传记录 |
关键说明：
oo file download默认写入已配置的file.download.out_dir，未配置时 回落到~/Downloads。- 如果服务端支持安全的 HTTP Range，下载会自动尝试续传。
- 目标文件已存在时，CLI 不会覆盖，而是自动追加
_1、_2等后缀。 - 上传文件的有效期为一天。
- 大于
512 MiB的文件会被oo file upload拒绝。 - 常见 Agent 工作流是：先上传输入文件，把上传后的文件 URL 传给 connector action 或 Cloud Task，等待任务完成，再下载结果文件。
LLM
| 命令 | 作用 |
|---|---|
oo llm config | 以 JSON 输出当前账号的 LLM client 配置 |
oo llm json | 调用已配置 LLM，要求输出 JSON，用 schema 校验，并在输出格式错误时重试 |
oo llm json 的常用选项：
--schema <schema>：直接传 JSON Schema，或用@path读取 JSON 文件--system <system>：直接传 system prompt，或用@path读取文本文件--input <input>：直接传输入 JSON，或用@path读取 JSON 文件--max-retries <count>：最大重试次数--model <model>：为本次调用覆盖模型名
日志
| 命令 | 作用 |
|---|---|
oo log path | 输出当前 debug 日志目录路径 |
oo log print [index] | 输出某一份更早的持久化日志文件 |
oo log print 1 表示上一份日志。CLI 会跳过当前这次运行的日志文件，只读取更早
的文件。
Telemetry
| 命令 | 作用 |
|---|---|
oo telemetry status | 查看 CLI telemetry 状态 |
oo telemetry enable | 启用受隐私约束的 CLI telemetry |
oo telemetry disable | 关闭 CLI telemetry |
Shell 补全
| 命令 | 作用 |
|---|---|
oo completion <shell> | 生成 shell 补全脚本 |
支持的 shell：
bashzshfish