ドキュメント
ターミナルエージェント

OpenClaw

Markdown

ターミナルエージェント · OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini

完全ガイド
形式設定場所
OpenAI Chat, OpenAI Responses, Anthropic Messages, GeminiOpenClaw設定(~/.openclaw/openclaw.json) → models.providers.<id>;デフォルトモデルはagents.defaults.model.primary;安全な変更コマンドはopenclaw config set models.providers.<id> '<json>' --strict-json --merge

設定

設定をコピーし、 sk-... を、Ailootのダッシュボードで取得した自分のキーに置き換えてください。キーは、次の環境変数で保管することを推奨します:AILOOT_API_KEY。アプリケーションが対応している場合に使用してください。

実行前に、AilootキーでGET /v1/modelsを取得します。対応メソッドにPOST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContentを含む正確なモデルIDを選び、設定に使用してください。エージェントでは、クライアントのバージョンに必要なツールと機能の対応も確認します。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ailoot/claude-sonnet-5-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ailoot": {
        "baseUrl": "https://api.ailoot.ai/v1",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      },
      "ailoot-claude": {
        "baseUrl": "https://api.ailoot.ai",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}

この設定は、次の変数からキーを取得します:AILOOT_API_KEY。アプリケーションの起動前に設定してください:

export AILOOT_API_KEY="sk-..."   # ~/.zshrcまたは~/.bashrcに追加する

モデルの例:claude-sonnet-5-5。別のモデルを選ぶ際の参照先:カタログ 。必要な形式に対応しているか確認してください。

注意事項

確認

  • OpenAI形式のアドレス:https://api.ailoot.ai/v1 (アプリケーションが完全なアドレスを求める場合は、完全なパス)。
  • Anthropic形式のアドレス:https://api.ailoot.ai 、除外するパス:/v1。
  • Gemini形式のアドレス:https://api.ailoot.ai がAPIのルートアドレスです。上の例には、この形式の完全な設定は示されていません。クライアントの欄に指定するパスは、そのクライアントのドキュメントで確認してください。APIルートのプレフィックス:/v1beta。
  • 短い質問を送信してください。エラーが返った場合は、コードとRequest IDを確認し、次のページと照合してください:エラーと制限。
  • 設定直後の404は、ほとんどの場合、アドレスの間違いです。追加しすぎ、または不足している部分:/v1。
  • 402は、仮確保に必要な残高の不足です。エージェントはチャットより多くの金額を仮確保します。参照:理由。

アプリケーションのドキュメント:https://docs.openclaw.ai/gateway/config-tools/custom-providers

ご不明な点はありますか?Request IDと状況の説明をお送りください。調査をお手伝いします。サポートに問い合わせる