CLI 参考

该 clore CLI 允许您直接从终端管理 Clore.ai GPU 市场——搜索 GPU、部署实例、SSH 登录并管理订单，无需编写任何代码。

安装

pip install clore-ai

这会同时安装 Python SDK 和 clore CLI 命令。

要求： Python 3.9+

配置

设置您的 API 密钥

从以下位置获取您的密钥 Clore.ai 仪表板 → API 部分，然后配置：

clore config set api_key YOUR_API_KEY

这会将密钥保存到 ~/.clore/config.json.

或使用环境变量

export CLORE_API_KEY=your_api_key_here

查看当前配置

# 显示所有配置
clore config show

# 获取特定值
clore config get api_key

命令

说明

clore search

搜索 GPU 市场

clore deploy <server_id>

创建新订单（租用服务器）

clore orders

列出您的订单

clore cancel <order_id>

取消订单

clore ssh <order_id>

SSH 登录到活动订单

clore wallets

显示钱包余额

clore servers

列出您托管的服务器

clore server-config <name>

获取服务器配置

clore spot <server_id>

查看服务器的现货市场

clore spot-price <order_id> <price>

设置现货价格

clore config set <key> <value>

设置配置值

clore config get <key>

获取配置值

clore config show

显示所有配置

clore --version

显示版本

详细用法

`clore search`

使用过滤器和排序搜索 GPU 市场。

# 列出所有可用服务器（按价格排序，前 20）
clore search

# 按 GPU 型号过滤
clore search --gpu "RTX 4090"

# 按 GPU 和最高价格过滤
clore search --gpu "RTX 4090" --max-price 5.0

# 多 GPU 机架
clore search --min-gpu 4

# 按 GPU 数量排序，显示前 10
clore search --sort gpu --limit 10

# 组合过滤器
clore search --gpu "A100" --min-ram 128 --max-price 10.0 --sort price --limit 5

选项：

选项

类型

说明

--gpu

文本

按 GPU 型号过滤（例如 "RTX 4090")

--min-gpu

整数

最小 GPU 数量

--min-ram

浮点数

最小内存（GB）

--max-price

浮点数

最高价格（美元/小时）

--sort

选项

排序方式： price （默认）， gpu, ram

--limit

整数

显示的最大结果数（默认：20）

示例输出：

🔍 GPU 市场
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ID  ┃ GPU                             ┃ 数量  ┃ 内存 (GB) ┃ CPU                          ┃ 价格/小时 (USD) ┃ 地点     ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 123 │ 1x NVIDIA GeForce RTX 4090      │     1 │    64.0  │ AMD Ryzen 9 5900X            │       $0.3200 │ 美国     │
│ 456 │ 2x NVIDIA GeForce RTX 4090      │     2 │   128.0  │ Intel Core i9-13900K         │       $0.5800 │ 德国     │
└─────┴─────────────────────────────────┴───────┴──────────┴──────────────────────────────┴───────────────┴──────────┘
显示 2 台服务器

`clore deploy <server_id>`

创建新订单以租用 GPU 服务器。

# 按需订单并启用 SSH
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MySecurePass123 \
  --port 22:tcp \
  --port 8888:http

# 现货订单
clore deploy 123 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --port 22:tcp

# 使用环境变量
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MyPass123 \
  --port 22:tcp \
  --env WANDB_API_KEY=your_key \
  --env HF_TOKEN=your_token

参数：

参数

说明

server_id

要租用的服务器 ID（从 clore search)

选项：

选项

类型

必填

说明

--image

文本

是

Docker 镜像（例如 cloreai/ubuntu22.04-cuda12)

--type

选项

是

on-demand 或 spot

--currency

文本

是

支付货币（例如 bitcoin)

--ssh-password

文本

否

SSH 密码（字母数字，最多 32 个字符）

--ssh-key

文本

否

SSH 公钥

--port

文本

否

端口映射（可重复），格式： PORT:PROTOCOL

--env

文本

否

环境变量（可重复），格式： KEY=VALUE

--spot-price

浮点数

否

现货订单的每日现货价格（现货订单必填）

`clore orders`

列出您正在进行的活跃订单。

# 活跃订单
clore orders

# 包括已完成/已过期的订单
clore orders --completed

选项：

选项

说明

--completed

包括已完成/已过期的订单

示例输出：

📦 我的订单
┏━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ 服务器 ID ┃ 类型      ┃ 状态   ┃ 镜像                             ┃ IP                      ┃
┡━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 38 │ 6         │ on-demand │ 活跃   │ cloreai/ubuntu22.04-cuda12        │ n1.c1.clorecloud.net    │
└────┴───────────┴───────────┴────────┴───────────────────────────────────┴─────────────────────────┘
总计：1 个订单

`clore cancel <order_id>`

取消一个活动订单。

# 取消订单
clore cancel 38

# 带问题报告的取消
clore cancel 38 --issue "GPU was overheating"

参数：

参数

说明

order_id

要取消的订单 ID

选项：

选项

说明

--issue

取消原因 / 问题报告

`clore ssh <order_id>`

自动通过 SSH 连接到运行中的订单。CLI 会从您的订单详情解析主机名和端口。

# 以 root 身份连接（默认）
clore ssh 38

# 以其他用户连接
clore ssh 38 --user ubuntu

参数：

参数

说明

order_id

要连接的订单 ID

选项：

选项

默认

说明

--user

root

SSH 用户名

`clore wallets`

显示您的钱包余额和充值地址。

clore wallets

示例输出：

💰 钱包余额
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 货币             ┃ 余额         ┃ 充值地址                                 ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ bitcoin          │ 0.00153176   │ tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr │
│ CLORE-Blockchain │ 150.00000000 │ cLr1q8x...                                │
└──────────────────┴──────────────┴───────────────────────────────────────────┘

`clore servers`

列出您在市场上托管的服务器。

clore servers

`clore server-config <name>`

获取您托管的特定服务器的配置。

clore server-config "MyGPU"

示例输出：

服务器：MyGPU
ID：42
已连接：True
在线：True
可见性：public
最短租期：72
GPU：NVIDIA GeForce RTX 4090
按需价格（USD）：$0.35
现货价格（USD）：$0.18
CPU：AMD Ryzen 9 5900X 12 核处理器
内存：64.0 GB
GPU：1x NVIDIA GeForce RTX 4090

`clore spot <server_id>`

查看服务器当前的现货市场报价。

clore spot 6

示例输出：

📊 现货市场 - 服务器 6
┏━━━━━━━━━━┳━━━━━━━━━━━┓
┃ 订单 ID ┃ 价格      ┃
┡━━━━━━━━━━╇━━━━━━━━━━━┩
│ 39       │ 4.2e-06   │
└──────────┴───────────┘

`clore spot-price <order_id> <price>`

更新您现货市场报价的价格。

clore spot-price 39 0.000003

注意： 您只能每 600 秒降低一次现货价格，并且每次降低受限于步长大小。

`clore config`

管理 CLI 配置。

# 设置 API 密钥
clore config set api_key YOUR_API_KEY

# 获取一个值
clore config get api_key

# 显示所有配置
clore config show

配置存储在 ~/.clore/config.json.

工作流程

搜索 → 租用 → SSH → 取消

典型的端到端工作流程：

# 1. 找到每小时低于 $5 的 RTX 4090
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 5

# 2. 在最便宜的服务器上部署（例如 ID 123）
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MyPass123 \
  --port 22:tcp \
  --port 8888:http

# 3. 检查您的订单状态
clore orders

# 4. SSH 登录到实例（例如订单 ID 456）
clore ssh 456

# 5. 完成后，取消订单
clore cancel 456

在租用前监控余额

# 检查您是否有足够的资金
clore wallets

# 搜索并租用
clore search --gpu "A100" --sort price --limit 3
clore deploy 789 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password SecurePass \
  --port 22:tcp

现货市场工作流程

# 1. 检查某台服务器的现货报价
clore spot 6

# 2. 创建现货订单
clore deploy 6 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --ssh-password MyPass123 \
  --port 22:tcp

# 3. 调整您的现货价格
clore spot-price 39 0.000003

服务器托管管理

# 查看您的服务器
clore servers

# 检查某台服务器的配置
clore server-config "MyGPU"

下一步

Python SDK — 使用 Python 自动化工作流程
REST API — 原始 API 文档
按需 vs 现货 — 了解定价模型

上一页Python SDK（clore-ai）下一页CLI 与 SDK 指南

最后更新于4小时前

这有帮助吗？

hashtag安装

hashtag配置

hashtag设置您的 API 密钥

hashtag或使用环境变量

hashtag查看当前配置

hashtag命令

hashtag详细用法

hashtagclore search

hashtagclore deploy <server_id>

hashtagclore orders

hashtagclore cancel <order_id>

hashtagclore ssh <order_id>

hashtagclore wallets

hashtagclore servers

hashtagclore server-config <name>

hashtagclore spot <server_id>

hashtagclore spot-price <order_id> <price>

hashtagclore config

hashtag工作流程

hashtag搜索 → 租用 → SSH → 取消

hashtag在租用前监控余额

hashtag现货市场工作流程

hashtag服务器托管管理

hashtag下一步

安装

配置

设置您的 API 密钥

或使用环境变量

查看当前配置

命令

详细用法

`clore search`

`clore deploy <server_id>`

`clore orders`

`clore cancel <order_id>`

`clore ssh <order_id>`

`clore wallets`

`clore servers`

`clore server-config <name>`

`clore spot <server_id>`

`clore spot-price <order_id> <price>`

`clore config`

工作流程

搜索 → 租用 → SSH → 取消

在租用前监控余额

现货市场工作流程

服务器托管管理

下一步