OOMOL
社区 登录
文档 价格 关于我们
动态 更新日志 博客
社区 登录
文档 概述App 与工具oo-cli命令参考Skill社区

oo-cli

oo-cli 通过 oo 这个命令，把官方安装、OOMOL 账号、已发布 package、 connector action、cloud task、文件、日志和受管 skill 统一接到终端里。

如果你正在 Codex、Claude Code 或普通 shell 环境里工作，应该先从这里开始， 而不是一上来就接更底层的 API 或 MCP。oo 是终端优先的使用路径，既适合快速 试用已发布能力，也适合处理认证、文件传输、skill 管理，以及通过统一安装文档 和受管更新保持 CLI 版本常新。

oo-cli 适合做什么

  • 通过统一安装文档安装受管 CLI，并用 oo update 持续更新。
  • 登录、退出并切换 OOMOL 账号。
  • 用一条自由文本查询同时搜索 package 和 connector action。
  • 在执行前查看 package 元数据和 connector schema。
  • 直接在终端里调用需要认证的 connector action，并支持 dry-run 与 JSON 输出。
  • 创建、列出、跟踪并获取 Cloud Task 结果。
  • 把内置或已发布的 skill 安装到 Codex 和 Claude Code。
  • 上传、下载、列出和清理工作流相关文件。
  • 查看持久化日志、管理 CLI 配置，并生成 shell 补全脚本。

安装

当前平台的安装命令和验证步骤，以这份统一安装文档为准：

如果你更希望 Agent 代你完成安装，先复制这一段提示词：

请帮我安装并检查 oo-cli：

1. 阅读安装文档 https://cli.oomol.com/install-guide.md

2. 按文档先检查本机是否已经可以使用 `oo`。如果缺失，再使用文档里适合当前平台的安装命令。

3. 运行 `oo --version` 验证安装结果。

4. 运行 `oo login`。

5. 告诉我下一条最适合在 oo-cli 里执行的命令。

平台安装命令以安装文档为准。本页重点说明 oo 可用之后该怎么开始使用。

完成受管安装后，可用 oo update 更新到最新发布版本，oo upgrade 是它的 别名；如果你只想检查是否有新版本，可使用 oo check-update。

快速开始

  1. 登录：
oo login
  1. 先搜索一个已发布能力：
oo search "generate a QR code"
  1. 在 Codex 里直接使用内置的 oo skill：
$oo 帮我生成 OOMOL 字符串的二维码

oo login 和 oo logout 分别是 oo auth login 与 oo auth logout 的别名。

面向 AI 宿主的内置 Skill

第一次启动 oo 时，只要本机已存在受支持的宿主目录，CLI 就会自动安装内置 skill。

  • Codex：${CODEX_HOME:-~/.codex}/skills/oo 和 ${CODEX_HOME:-~/.codex}/skills 下的其他内置 skill 目录
  • Claude Code：~/.claude/skills/oo 和 ~/.claude/skills 下的其他内置 skill 目录

当前内置 skill 分工不同：

  • oo：优先通过已有的 oo package 或 connector action 来完成任务， 而不是临时拼一个本地实现
  • oo-find-skills：搜索已发布的 OOMOL / oo skill 目录，并安装选中的 skill
  • oo-create-skill：帮助把 OOMOL package、connector action、block 或一套已选 工作流变成本地可复用 skill
  • oo-publish-skill：帮助校验、发布和分享已经完成的本地 skill

官方安装脚本和成功执行 oo update 后，这些 bundled skills 会自动刷新。 如果你想手动刷新，可使用 oo skills add。oo skills update 只用于已发布的 oo-managed skills，不会更新 bundled skills。

如果你想手动安装，也可以直接执行：

oo skills install
oo skills install oo-find-skills

使用 oo skills list 可以查看当前机器上已安装到受支持 Agent 宿主里的 bundled、 registry 和 local skills。oo skills preflight --agent <agent> 可以检查某个宿主 是否能创作本地 skill。当前 CLI 在宿主目录存在时支持 Codex、Claude Code、 Hermes、WorkBuddy、Trae、OpenClaw、QoderWork 等宿主。

主要工作流

安装或刷新受管 CLI

如果你希望使用官方二进制发布和更清晰的升级路径，就使用受管安装流程。

oo check-update
oo update

首次安装时使用上面的官方安装脚本。oo update 会把这份受管安装更新到最新版本， 并在成功后刷新 bundled skills。

oo install [version] 也可用于更偏维护的受管运行时场景，例如安装或重装某个指定 CLI 版本。对大多数用户来说，它不是推荐的首次安装路径。

同时搜索 package 和 connector

当你的目标更像“我要完成什么”，而不是“我已经知道该走哪种执行路径”时， 优先使用 oo search。

oo search "generate a QR code" --json

这个命令会返回混合结果集。package 结果代表已发布的 OOMOL 能力， connector 结果代表可以直接调用的外部服务 action，并带有 authenticated、schemaPath 等字段。

在执行前先看 package 或 connector

如果你想先确认 schema、元数据或版本信息，再决定怎么调用，就先做查看。

oo packages info foo/bar@latest
oo connector search "send an email" --json
oo connector schema <serviceName> -a <action>

oo packages info 可以用 @latest 查看信息。oo connector search 会把 connector schema 缓存在本地，并在文本与 JSON 输出中报告缓存路径。当你已经知道 目标 service 和 action 时，用 oo connector schema 在传入参数前查看准确的 JSON schema 合约。

直接运行 connector action

如果你已经明确知道自己要调用外部服务 action，就直接进入 connector 命名空间。

oo connector search "send an email"
oo connector run <serviceName> -a <action> --dry-run --data @input.json
oo connector run <serviceName> -a <action> --data @input.json --json

oo connector run 支持 --dry-run 做 payload 校验，也支持通过 --json 输出结构化结果。

查看 package 并把它跑成 cloud task

如果你要直接面向某个已发布 package 发起远端任务，就使用 packages 和 cloud-task 这两组命令。

oo packages search "generate a QR code"
oo packages info foo/bar@latest
oo cloud-task run foo/bar@1.2.3 -b main --data @input.json
oo cloud-task list --status running --json
oo cloud-task wait <taskId>
oo cloud-task log <taskId>
oo cloud-task result <taskId>

其中，oo cloud-task run 要求传入 PACKAGE_NAME@SEMVER，而 oo packages info 可以用 @latest 做信息查看。

在工作流和本地之间传文件

当任务需要输入文件，或你需要把远端产物拉回本地时，使用 file 命名空间。

oo file upload ./input.pdf --json
oo file list --status active --json
oo cloud-task run foo/bar@1.2.3 -b main --data @input.json
oo cloud-task wait <taskId>
oo cloud-task result <taskId>
oo file download <url>
oo file cleanup --json

上传文件在服务端保留一天。下载默认写入已配置的 file.download.out_dir，如果未配置，则回落到 ~/Downloads。下载会在 可能时自动续传，也不会覆盖已存在的目标文件。

创作、校验并分享 Skill

当一套重复 API 工作流应该在 Agent 宿主里复用，而不是停留在一次性提示词里时， 使用 skills 命名空间。

oo skills init my-workflow --description "Reusable workflow for my team"
oo skills validate ~/.codex/skills/my-workflow
oo skills publish my-workflow --visibility private
oo skills share my-workflow

oo skills init 会在受支持的 Agent 宿主里创建本地 skill。validate 用于发布前 校验 skill 目录。publish 会把 skill 转成 OOMOL package，share 帮助另一个 Agent 或团队成员安装它。

可以把 Skill 理解成可复用执行契约，而不只是提示词片段。一个好的 Skill 会保存 已选工具或 connector action、必要输入、调用顺序、检查方式、文件处理、结果格式 和失败路径，让后续 Agent 不需要重新发现能力或猜测流程。

不同来源的 Skill 维护方式不同：

  • Bundled skills 随 oo 提供，会在安装或更新流程中刷新。
  • Registry skills 来自已发布的 skill package，可以用 oo skills 搜索、安装、 更新和卸载。
  • Local skills 在受支持的 Agent 宿主里创作，本地校验后可以发布并分享成 OOMOL package。

常见生命周期：

oo skills search "generate images" --json
oo skills install "@alwaysmavs/gpt-image-2" -s "gpt-image-2"
oo skills preflight --agent codex
oo skills init my-workflow --agent codex --description "Reusable workflow for my team"
oo skills validate ~/.codex/skills/my-workflow
oo skills publish ~/.codex/skills/my-workflow --visibility private
oo skills share my-workflow
oo skills update my-workflow

命令分组速览

分组关键命令作用
安装与更新官方安装脚本、oo update、oo upgrade、oo check-update、oo install [version]安装受管版本并保持最新
认证oo auth ...、oo login、oo logout管理账号并校验当前 API Key
配置oo config ...持久化 CLI 配置，例如语言和下载目录
搜索oo search、oo packages search、oo connector search搜索 package、connector 或两者混合结果
查看oo packages info、oo connector search、oo connector schema在执行前查看元数据、版本和 schema
执行oo connector run、oo cloud-task ...调用 connector action，或创建并跟踪 cloud task
Skillsoo skills ...列出、搜索、安装、创作、发布、更新、卸载 oo 管理的 skill
文件oo file ...上传、下载、列出并清理本地文件传输记录
LLMoo llm config、oo llm json读取账号 LLM 配置，并生成 schema 校验后的 JSON
日志oo log ...、--debug查看持久化 debug 日志和当前日志目录
Telemetryoo telemetry ...查看或更新受隐私约束的 CLI telemetry 设置
Shelloo completion <shell>生成 shell 补全脚本

什么时候用 CLI，什么时候用 MCP

如果你是直接在终端或 AI 编程宿主里操作，并且想尽快拿到结果，就用 CLI。

如果你要把 OOMOL 能力暴露成可供外部 Agent 框架或 MCP 运行时调用的工具， 就应该使用 MCP。

参考链接