将 OpenClaw 接入 Scenepond

1. 准备模型与 API Key

从目录复制已启用的完整模型 ID，并创建具有相应访问权限的 Scenepond API Key。智能体任务需要确认模型支持工具调用；选择前请核对上下文限制和支持协议。

将 YOUR_MODEL_ID 替换为已配置的完整模型 ID。本指南配置聊天接口，图片或视频生成工具需单独接入。模型可用性与调用成功取决于后台配置和账户余额。

2. 配置自定义供应商

将这些字段合并到 ~/.openclaw/openclaw.json 或实际使用的 OpenClaw 配置文件中，保留其他供应商、智能体、消息渠道与密钥设置。

1{
2  "models": {
3    "mode": "merge",
4    "providers": {
5      "scenepond": {
6        "baseUrl": "https://scenepond-api-production.up.railway.app/v1",
7        "api": "openai-completions",
8        "auth": "api-key",
9        "authHeader": true,
10        "apiKey": {
11          "source": "env",
12          "provider": "default",
13          "id": "SCENEPOND_API_KEY"
14        },
15        "models": [
16          {
17            "id": "YOUR_MODEL_ID",
18            "name": "YOUR_MODEL_ID"
19          }
20        ]
21      }
22    }
23  },
24  "agents": {
25    "defaults": {
26      "model": {
27        "primary": "scenepond/YOUR_MODEL_ID"
28      }
29    }
30  }
31}

为 OpenClaw 进程设置 SCENEPOND_API_KEY，或将其保存到 ~/.openclaw/.env。SecretRef 从该变量读取密钥原值，无需把密钥写入上述 JSON。若环境读取器限制变量，请在配置中允许 SCENEPOND_API_KEY。

SCENEPOND_API_KEY=YOUR_SCENEPOND_API_KEY

聊天补全接口选择 openai-completions。模型引用为 scenepond/YOUR_MODEL_ID。即使模型 ID 含斜杠，也保留 scenepond/ 前缀。请先设置已核实的上下文和输出限制，不要依赖客户端默认值。

3. 选择模型并开始会话

1openclaw config validate
2openclaw models list --provider scenepond
3openclaw models set 'scenepond/YOUR_MODEL_ID'

OpenClaw TUI 需要 Gateway 正在运行。先在一个终端执行 openclaw gateway，再在另一个终端执行 openclaw tui。若已有托管 Gateway 服务，请通过正常的服务重启流程应用环境变量。

openclaw gateway

openclaw tui

在 OpenClaw 能读取上述环境变量的环境中执行命令。替换模型 ID 后，先进行简短对话并核对返回结果和 Scenepond 用量，再启用更长的智能体任务。

4. 核对返回结果与用量

确认客户端选中了 Scenepond 供应商和完整的模型 ID。在新会话发送下面这条简短消息，请求会使用账户余额。

不要调用工具，只回复 READY。

收到文本回复后，打开 Scenepond 用量记录，核对模型、请求时间与实际结算费用。文本回复可确认基本聊天接入；工具与推理能力应在模型支持时分别测试。

常见配置问题

找不到密钥或凭据被拒绝

确认实际运行的客户端能读取原始密钥，且 Scenepond 密钥已启用。诊断输出中不要包含密钥。

模型不可用

检查模型目录中的完整 ID、密钥权限与余额。OpenClaw 的模型引用还需要加上 scenepond/ 前缀。

TUI 无法连接

确认 OpenClaw Gateway 正在运行，且能读取 SCENEPOND_API_KEY。托管服务修改环境变量后，请按其正常流程重启。

聊天成功，工具调用失败

检查所选模型的工具支持和客户端的工具设置。文本聊天成功不能证明所有智能体能力都可用。