0G 计算网络

接入 0G 计算网络 —— 一个基于可信执行环境（TEE）验证模型完整性的去中心化 AI 推理市场。

前置条件

• 已安装 0g-compute-cli：npm i -g @0glabs/0g-serving-broker
  • 注意：npm 包名为 @0glabs/0g-serving-broker（旧包名 @0glabs/0g-compute-cli 已失效），但可执行命令仍为 0g-compute-cli。
• 钱包中已充值 0G 代币
• 已完成登录：应尽量避免在命令行中直接传入私钥（可能在 Shell 历史记录或进程列表中暴露）。推荐通过受保护的交互式输入或环境变量读取：
  • read -s OG_PK; 0g-compute-cli login --private-key "$OG_PK"; unset OG_PK
• 网络已配置：0g-compute-cli setup-network

核心工作流

1. 发现模型

# 列出所有提供模型的服务商，包含价格、可验证性等信息
0g-compute-cli inference list-providers

# 查看详细信息，包括健康度/正常运行时间等指标
0g-compute-cli inference list-providers-detail

# 包含未通过 TEE 签名验证的服务商
0g-compute-cli inference list-providers --include-invalid

支持按模型名称、价格、健康状态及 TeeML 支持情况（即是否在可信执行环境中运行）过滤输出结果。

2. 验证服务商完整性

首次使用新服务商前，务必执行验证。 TEE 验证确保模型运行于具备硬件级可信证明的安全飞地（secure enclave）中。

# 执行完整的 TEE 证明校验
0g-compute-cli inference verify --provider 


# 下载原始证明数据
0g-compute-cli inference download-report --provider 
 --output report.json

verify 命令将检查以下几项：

• TEE 签名者地址是否与合约一致
• Docker Compose 文件哈希完整性
• DStack TEE（Intel TDX）证明有效性

3. 钱包与余额管理

# 账户概览
0g-compute-cli get-account

# 查询指定服务商子账户余额
0g-compute-cli get-sub-account --provider 
 --service inference

# 充值与资金划转操作
0g-compute-cli deposit --amount <0G>                          # 充值至主账户
0g-compute-cli transfer-fund --provider  --amount <0G> --service inference  # 划转至子账户
0g-compute-cli retrieve-fund --service inference              # 从各子账户收回资金
0g-compute-cli refund --amount <0G>                           # 提现至钱包

重要提示：若子账户余额耗尽，推理调用将失败。请定期监控余额状态。

4. 配置 OpenClaw 服务商

从已验证的服务商处获取 API 密钥（交互式命令，会提示设置过期时间）：

0g-compute-cli inference get-secret --provider 

将其添加至 openclaw.json 文件中：

"providers": {
  "0g-": {
    "baseUrl": "/v1/proxy",
    "apiKey": "",
    "api": "openai-completions",
    "models": [{ "id": "", "name": "" }]
  }
}

在 agents.defaults.models 中以别名方式注册该服务商，并设置 cost: 0（因计费由链上完成）。

完整配置指南请参阅 references/openclaw-config.md。

5. 价格对比（0G vs OpenRouter）

对相同模型，对比 0G 与 OpenRouter 的定价：

scripts/0g-price-compare.sh

无需 API 密钥 —— 全部使用公开接口：

• CoinGecko：获取 0G 代币兑 USD 汇率
• OpenRouter /api/v1/models：获取模型定价信息
• 0G CLI：获取服务商报价

输出格式为并排显示的 USD/100 万 token 报价及节省百分比。可通过设置环境变量 OG_TOKEN_PRICE_USD 覆盖 CoinGecko 获取的价格。

6. 状态检查

# 登录状态与钱包信息
0g-compute-cli status

# 当前网络环境（主网/测试网）
0g-compute-cli show-network

安全规范

• 首次使用新服务商前，必须运行 inference verify 进行验证
• 依赖某服务商前，请先检查其健康度与正常运行时间
• 持续监控子账户余额 —— 余额耗尽将导致推理失败
• 私钥存储于 ~/.0g-compute-cli/config.json，切勿泄露该文件

参考文档

• CLI 参考手册 —— 完整命令说明，涵盖所有参数与使用示例
• OpenClaw 配置指南 —— 服务商接入的分步配置教程