在 OpenClaw 中使用 RunAPI。
RunAPI 可以作为 OpenClaw 的 OpenAI 兼容端点使用。把 prompt 复制进 OpenClaw，让它添加 provider；需要核对字段时再看配置 tab。
Configure this OpenClaw workspace to use RunAPI.
Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a model provider named runapi.
- Use baseUrl "https://runapi.ai/v1".
- Use api "openai-completions".
- Register provider-local model id "gpt-5.2" with display name "RunAPI GPT 5.2".
- Set the default model to "runapi/gpt-5.2" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.2` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.{
agents: {
defaults: {
model: { primary: "runapi/gpt-5.2" },
models: {
"runapi/gpt-5.2": { alias: "RunAPI GPT 5.2" },
},
},
},
models: {
mode: "merge",
providers: {
runapi: {
baseUrl: "https://runapi.ai/v1",
apiKey: "${RUNAPI_API_KEY}",
api: "openai-completions",
models: [
{
id: "gpt-5.2",
name: "RunAPI GPT 5.2",
reasoning: false,
input: ["text"],
contextWindow: 128000,
maxTokens: 8192,
},
],
},
},
},
}export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.2
openclaw这个配置会改变什么
OpenClaw 可以通过 model provider 配置调用自定义 OpenAI 兼容模型 provider。最快路径是把 RunAPI setup prompt 粘贴进 OpenClaw，让 agent 自己更新配置。provider ID 只存在于你的 OpenClaw 配置里，模型引用变成 runapi/gpt-5.2，API key 保存在 RUNAPI_API_KEY。
用 prompt 在 OpenClaw 中安装 RunAPI
粘贴 setup prompt
复制第一个 tab 里的 prompt 给 OpenClaw。它会要求 OpenClaw 读取 RUNAPI_API_KEY、添加 runapi provider，并保留现有 provider。
复制 prompt
核对生成的配置
OpenClaw 应该把 gpt-5.2 加为 provider 内部模型 ID，再通过带 provider 前缀的 runapi/gpt-5.2 选择模型。
runapi/gpt-5.2
验证选择
运行 openclaw models status，切换到 RunAPI 模型，然后启动 OpenClaw 会话。如果模型没有出现，检查 allowlist 是否包含 runapi/gpt-5.2。
openclaw models status
配置字段
| 字段 | 值 | 作用 |
|---|---|---|
baseUrl |
https://runapi.ai/v1 |
让 OpenClaw 指向 RunAPI 的 OpenAI 兼容 API 表面。 |
apiKey |
${RUNAPI_API_KEY} |
从环境变量读取 RunAPI API key。 |
api |
openai-completions |
使用 OpenAI 兼容端点需要的 Chat Completions 适配方式。 |
agents.defaults.model.primary |
runapi/gpt-5.2 |
把 RunAPI 模型设为新 OpenClaw 会话的默认模型。 |
OpenClaw 配置问题
可以。OpenClaw 通过 models.providers 支持自定义 OpenAI 兼容 provider。为 RunAPI 配置 /v1 base URL，把 api 设为 openai-completions，并在 agents.defaults.model.primary 中选择带 provider 前缀的模型引用。
不要。在 models.providers.runapi.models 内使用 provider 内部 ID，例如 gpt-5.2。只有在 OpenClaw 默认模型或命令里选择模型时，才使用 runapi/gpt-5.2 这种带 provider 前缀的引用。
把 key 存在 RUNAPI_API_KEY，并在 OpenClaw 配置里读取它。这样凭证不会进入版本控制，也能让同一份配置用于本地 shell、服务器和自动化环境。
可以。保持 models.mode 为 merge，并把 RunAPI 作为其中一个 provider 加进去。现有 provider 仍可用；需要恢复链路时，把 fallback 放进 agents.defaults.model.fallbacks。