跳转到主要内容
通过 PPClaw CLI 在 PPIO Agent Sandbox 上一键部署 OpenClaw 云端 AI 助手。

​
1. 获取 PPIO API 密钥

​
2. 安装 PPClaw CLI

pip install ppclaw-cli
验证安装： 
ppclaw-cli --version
若提示 command not found，需将 Python bin 目录加入 PATH：
echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

​
3. 配置 API Key

支持以下方式（优先级从高到低）：
方式示例适用场景
命令行参数ppclaw-cli launch --api-key sk_xxx临时使用
环境变量export PPIO_API_KEY=sk_xxx当前会话
配置文件~/.ppclaw-cli/config.yaml长期使用
配置文件格式： 
ppio:
  api_key: sk_your_api_key

​
4. 快速开始

# 创建沙箱（约 50 秒）
ppclaw-cli launch --api-key sk_your_api_key

# 浏览器打开输出的 Web UI 链接即可使用

# 用完后停止
ppclaw-cli stop <SANDBOX_ID> --api-key sk_your_api_key
创建成功后输出： 
╭──────────────────── PPClaw Sandbox Ready ────────────────────╮
│ Sandbox ID:         abc123def456-fb47b43e                    │
│ Keep Alive:         604800s                                  │
│                                                              │
│ Web UI:             https://18789-xxx.sandbox.ppio.cn?token= │
│ Gateway WebSocket:  wss://18789-xxx.sandbox.ppio.cn          │
│ Gateway Token:      xYz1234abcd                              │
╰──────────────────────────────────────────────────────────────╯

​
5. 命令参考

​
launch

创建沙箱环境。 
ppclaw-cli launch [--api-key KEY] [--gateway-token TOKEN] [--timeout 60]
参数说明
--api-keyPPIO API Key
--gateway-token自定义网关令牌（可选）
--timeout创建超时时间，单位秒（默认 60）

​
list

列出所有沙箱。 
ppclaw-cli list [--api-key KEY]
输出示例： 
┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓
┃ Sandbox ID               ┃ State   ┃ CPU ┃ Memory (MB) ┃ Started At          ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩
│ abc123def456-fb47b43e    │ running │   4 │        8192 │ 2026-02-28 11:38:46 │
└──────────────────────────┴─────────┴─────┴─────────────┴─────────────────────┘

​
status

查看沙箱状态。 
ppclaw-cli status <SANDBOX_ID> [--api-key KEY]

​
stop

停止沙箱。 
ppclaw-cli stop <SANDBOX_ID> [--api-key KEY]

​
tui

通过终端连接沙箱。 
ppclaw-cli tui <SANDBOX_ID> --token <GATEWAY_TOKEN> [--api-key KEY]
需先安装 openclaw CLI：npm install -g openclaw

​
6. JSON 输出

所有命令支持 --json 参数，适合脚本集成： 
ppclaw-cli --json launch --api-key sk_xxx

{
  "status": "ok",
  "sandbox_id": "abc123def456-fb47b43e",
  "webui": "https://18789-xxx.sandbox.ppio.cn?token=xYz1234",
  "gateway_ws": "wss://18789-xxx.sandbox.ppio.cn",
  "gateway_token": "xYz1234"
}

​
7. 模型配置

​
默认模型

沙箱预装以下模型（按量付费）：
模型 ID名称用途
moonshotai/kimi-k2.5Kimi K2.5主模型
minimax/minimax-m2.5Minimax M2.5备用模型

​
切换模型

支持切换至 PPIO 平台所有 LLM 模型。 操作步骤：
  1. 打开 Web UI → Settings → Config
  2. 切换到 Raw JSON 视图
  3. 修改以下两处配置：
第一步：注册模型 在 models.providers.ppio.models 数组中添加： 
"models": [
  {
    "id": "model-id",
    "name": "display name",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 8192
  }
]
第二步：设置主/备用模型 更新 agents.defaults.model： 
"agents": {
  "defaults": {
    "model": {
      "primary": "ppio/model-id",
      "fallbacks": [
        "ppio/fallback-model-id"
      ]
    }
  }
}
  1. 点击 Update 保存
也支持第三方模型提供商，自带 LLM 只需支付沙箱运行时费用。

​
8. 常见问题

按照「配置 API Key」章节设置即可。
Gateway 首次启动需要 30-60 秒初始化。超时后可用 ppclaw-cli status 检查状态，或重新创建。
npm install -g openclaw
默认 7×24 小时。