OpenClawを
CoreAPIで
設定する
CoreAPI を OpenClaw のカスタム モデル プロバイダーとして使用します。1 つの API、公式定価で 多数のモデル。このガイドは、現在の OpenClaw オンボーディング フロー(2026.3.8 以降) に従い、インストール、プロバイダーの構成、検証、モデルの切り替えについて説明します。
# サンプルのみ—本番環境前にご使用の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" }]
}
}
}
}ガイドの範囲
と前提条件
CoreAPIでOpenClawを設定する
OpenClaw のカスタム モデル プロバイダーとして CoreAPI を使用すると、公式定価で 1 つの API で 多数のモデルにアクセスできます。このページは、現在の OpenClaw オンボーディング フロー(2026.3.8 以降) に従います。
前提条件
Node.js >= 22とCoreAPI APIキーが必要です。デーモンインストールの場合は、COREAPI_KEYを~/.openclaw/.envに保存し、openclaw.jsonが$COREAPI_KEYで参照できるようにしてください。
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参照を使用してください。バージョン更新後は 設定リファレンス.
1つのCoreAPIキーに
なぜ2つのプロバイダーが必要か
インストール、オンボード、設定、
検証、切り替え
OpenClawは ~/.openclaw/openclaw.json を編集するソース設定として使用します。カスタムプロバイダーはエージェントごとの models.json ファイルとして ~/.openclaw/agents/<agentId>/に実体化されます。アップグレード後は 設定リファレンス と 環境変数 ガイドでキーと動作を再確認してください。CoreAPIのベースURLは ライブドキュメントの定義のみに従ってください。
{
"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を手動で作成する必要はありません。プロバイダーでは auth-profiles.jsonを使用し、 ${COREAPI_KEY} を通じて変数を注入するか、 ~/.openclaw/.env、shellまたはサービスマネージャーを使用してください。
ライブレートは
CoreAPIサイトで確認
以下の表では、100 万あたりのトークンの数値を例示的に使用しています。モデル カタログ、価格設定、および SLA は、現在の CoreAPI 条件に従います。 CoreAPIのドキュメントとコンソール の現在の表示内容に従います。
統合前に
これらを確認してください
このセットアップにauth-profiles.jsonは必要ですか？
基本セットアップには不要です。OpenClawは$COREAPI_KEYを通じてmodels.providers.*.apiKeyからプロバイダーのapiKeyを解決できます。プロファイルごとのシークレット保存やローテーションが必要な場合のみauth-profiles.jsonを使用してください。
なぜ1つのベンダーに2つのプロバイダーエントリが必要なのですか？
OpenClawはAPI形式の互換性でルーティングします。openai-completions、anthropic-messagesに対して個別のエントリを維持してください。
設定は実際にどこで編集・実体化されますか？
~/.openclaw/openclaw.jsonを編集します。カスタムプロバイダーは同期/ロード後に~/.openclaw/agents/<agentId>/配下のエージェントごとのmodels.jsonに実体化されます。
このガイドで使用されるモデルIDは何ですか？
deepseek-flash、claude-sonnet-4-5-20250929です。CoreAPIモデルページから任意のモデルを対応するプロバイダーブロックに追加できます。