Skip to main content

​
安装

从 PyPI 安装 Osmosis CLI：
需要 Python 3.12 或更高版本。该 package 注册了三个等价 CLI alias：osmosis、osmosis-ai 和 osmosis_ai。
验证安装：
同一个 package 也提供 Python SDK。有关 rollout dependencies、可选 extras 和 SDK 验证，请参见 SDK 安装。

​
升级

CLI 可以就地自升级。它会自动检测您的安装方式（pip、pipx 或 uv tool），并运行相应升级命令：
您也可以使用自己选择的 package manager 手动升级：

​
版本兼容性

CLI 会在每次请求时将自身版本发送给平台，平台会据此提示何时建议或必须升级：
  • 弃用警告。 如果您安装的版本即将停止支持，CLI 会向 stderr 打印一次性的黄色 ⚠ 警告。命令仍可正常运行——您可以在方便时安排升级。
  • 必须升级。 如果您的版本低于最低支持版本，平台请求会以 Upgrade required 错误失败并退出命令。请运行 osmosis upgrade（或对应安装方式的等效命令）以继续。

​
认证

​
登录

打开基于浏览器的 OAuth flow 来认证 CLI session。凭证会存储在本地，并在后续命令中复用。
对于 CI/CD pipelines，请设置 OSMOSIS_TOKEN 环境变量，而不是运行 osmosis auth login。设置该变量后，CLI 会自动使用它，且 login 命令会被禁用。

​
退出登录

撤销当前 session 并清除本地凭证。

​
查看当前身份

显示当前已认证用户和 token 过期日期。

​
Workspace 上下文

大多数平台命令会通过您当前所在的 workspace repository 确定 scope。如果您是首次设置 Osmosis，请先完成 Onboarding，再运行 workspace-scoped 命令。 如需了解 CLI 如何读取 GitHub origin，并将本地命令映射到平台 workspace，请参见 Workspace Repository。

​
下一步

入门引导

设置 workspace repository 和本地 CLI context。

命令参考

每个 CLI 命令及其选项的完整参考。
最后修改于 2026年8月10日