CoreAPI × OpenClaw

配置
OpenClaw，
通过 CoreAPI

将 CoreAPI 用作 OpenClaw 的自定义模型提供商：一个 API、丰富的模型目录，价格与官方一致。本指南对应最新 OpenClaw 接入流程（2026.3.8+），涵盖安装、提供商配置、验证和模型切换。

~/.openclaw/openclaw.json

# 仅供参考——请在生产环境前根据您的 OpenClaw 版本验证
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "coreapi-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "coreapi-openai": {
        "baseUrl": "https://unixcore.io/v1",
        "apiKey": "${COREAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
      },
      "coreapi-claude": {
        "baseUrl": "https://unixcore.io",
        "apiKey": "${COREAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
      }
    }
  }
}

00 — 从这里开始

指南范围
与前置条件

指南概览

通过 CoreAPI 配置 OpenClaw

将 CoreAPI 用作 OpenClaw 的自定义模型提供商，通过一个 API 以官方标价访问模型目录。本页对应最新 OpenClaw 接入流程（2026.3.8+）。

OpenClaw 文档闸道设置

前置条件

需要 Node.js >= 22 和 CoreAPI API 密钥。对于守护进程安装，请将 COREAPI_KEY 存放在 ~/.openclaw/.env 中，以便 openclaw.json 通过 $COREAPI_KEY 引用，无需硬编码密钥。

CoreAPI 文档

快速指令

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

新增 ~/.openclaw/.env 或编辑提供商设置后，使用 openclaw gateway restart重启一次，然后执行诊断。在所有指令和工作阶段中使用完整的 provider/model 引用。版本升级后请重新检查设置参考.

01 — 提供商设置说明

为什么一个 CoreAPI 密钥
需要两个提供商

基于 API 格式的提供商路由

OpenClaw 按 API 兼容性（而非仅供应商标签）进行路由，因此需要为 openai-completions 和 anthropic-messages 分别设置提供商。

单一密钥，多提供商设置

保持单一 COREAPI_KEY，在 coreapi-openai 和 coreapi-claude 区块中复用。所有地方均使用完整的 provider/model 引用。

当前流程验证

执行一次引导程序，在变更后重启闸道，然后通过 models status、provider 范围的 models list 和 doctor 诊断进行验证。

02 — 接入 OpenClaw

安装、引导、设置、
验证、切换

版本感知说明

OpenClaw 使用 ~/.openclaw/openclaw.json 作为您编辑的来源设置档。自定义提供商将被实体化为每个 agent 的 models.json 文件，位于 ~/.openclaw/agents/<agentId>/下。升级后请使用设置参考和环境变量指南重新检查密钥和行为。CoreAPI 的 base URL 仅以实时文档中的定义为准。

01 安装或更新 OpenClaw

推荐：curl -fsSL https://openclaw.ai/install.sh | bash。或者如果您保持全域 npm 安装，使用 npm install -g openclaw@latest。

02 执行一次引导程序

执行：openclaw onboard --install-daemon。在 Model/Auth 中选择 Skip 进行基础安装，除非需要否则保持默认工作区，让精灵完成常驻程序和健康检查。

03 存放 COREAPI_KEY

对于守护进程安装，将 COREAPI_KEY 追加到 ~/.openclaw/.env 并执行 chmod 600。如果您已有 shell/服务密钥工作流程，继续使用即可。

04 在 openclaw.json 中新增 {brand} 提供商

新增 coreapi-openai（openai-completions）和 coreapi-claude（anthropic-messages），然后将 primary 设为 coreapi-claude/claude-sonnet-4-5-20250929。

05 重启并验证

执行 openclaw gateway restart，然后执行 openclaw models status、openclaw models list --provider coreapi-claude 和 openclaw doctor。CoreAPI 提供商不应出现配置架构/认证错误。

06 使用 provider/model 切换模型

使用 openclaw models set coreapi-claude/claude-sonnet-4-5-20250929 设置默认模型。在对话中，通过 /model coreapi-openai/deepseek-flash 切换。

07 选用：全新重新安装

如果在修复旧的损坏安装，请停止网关，删除 ~/.openclaw，重新执行引导流程，然后重新应用 CoreAPI 配置。这将重置本地配置、会话、日志和认证状态。

设置片段（合并到 openclaw.json）

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "coreapi-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "coreapi-openai": {
        "baseUrl": "https://unixcore.io/v1",
        "apiKey": "${COREAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
      },
      "coreapi-claude": {
        "baseUrl": "https://unixcore.io",
        "apiKey": "${COREAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
      }
    }
  }
}

基础设置无需手动创建 auth-profiles.json。在提供商中使用 ${COREAPI_KEY} ，并通过 ~/.openclaw/.env、shell 或服务管理器注入变量。

03 — 参考定价

实时费率以
CoreAPI 官网为准

下表使用示意性的每百万 Token 价格。模型目录、定价和 SLA 以 CoreAPI 当前条款为准。 CoreAPI 文档与控制台当前显示的数据为准。

查看当前定价估算每月费用

04 — 常见问题

整合前请先
查看这些问题

此设置需要 auth-profiles.json 吗？

基础设置不需要。OpenClaw 可以通过 $COREAPI_KEY 从 models.providers.*.apiKey 解析提供商 apiKey。仅在需要按配置文件存放密钥或密钥轮换时才使用 auth-profiles.json。

为什么一个供应商需要 2 个提供商条目？

OpenClaw 按 API 格式兼容性路由。请为 openai-completions 和 anthropic-messages 保持独立条目。

设置实际在哪里编辑和实体化？

编辑 ~/.openclaw/openclaw.json。自定义提供商在同步/加载后会实体化为 ~/.openclaw/agents/<agentId>/ 下每个 agent 的 models.json。

本指南使用哪些模型 ID？

deepseek-flash 和 claude-sonnet-4-5-20250929。您可以将 CoreAPI 模型页面上的任意模型添加到对应的提供商区块中。

配置OpenClaw，通过 CoreAPI

指南范围与前置条件