OpenClaw での Claude API 接続

OpenClaw で 1折AI の Claude API 中継のアドレス、API キー、モデルを設定する手順。プロトコル選択、設定例、検証手順、よくあるエラーを含む。

OpenClaw のカスタムプロバイダー機能を使って 1折AI に接続します。まず API キーを作成し、現在利用可能なモデルを確認してください。以下のモデル ID は例です。あなたのキーの権限に合わせて調整してください。

公式設定の確認日：2026-10-15。以下の設定は公式ドキュメントに基づいて整理したものです。当サイトでのエンドツーエンド検証は未完了です。まず簡単な質問応答とツール呼び出しの検証を済ませてから、長時間のタスクに使用してください。OpenAI / GPT モデルは提供開始済みです。モデル一覧と価格はモデル説明を参照してください。

カスタムプロバイダーと設定例に基づき、~/.openclaw/openclaw.json に以下を追加します：

1
{
2
  "agents": {
3
    "defaults": {
4
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
5
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
6
    }
7
  },
8
  "models": {
9
    "mode": "merge",
10
    "providers": {
11
      "onezhe": {
12
        "baseUrl": "https://1zheai.com",
13
        "apiKey": "${ONEZHE_API_KEY}",
14
        "api": "anthropic-messages",
15
        "models": [
16
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
17
        ]
18
      }
19
    }
20
  }
21
}

実際に Gateway を実行しているプロセスが ONEZHE_API_KEY を読み取れることを確認してください。ターミナルの環境変数が既存のバックグラウンドサービスに渡るとは限りません。公式 Synthetic ドキュメントによると、Anthropic クライアントは自動的に /v1 を追加するため、ここでは /v1 を付けず、完全な /v1/messages も入力しません。

Chat Completions を使う場合は、ペアで baseUrl: "https://1zheai.com/v1" と api: "openai-completions" に置き換えます。名称に completions と含まれていますが、このアダプターは /v1/chat/completions に対応します。openai-responses を誤って選択しないでください。既存のモデル許可リストには他のエントリを残したまま新しいモデルを追加してください。例ではコストやコンテキストのパラメータを捏造していません。現在のインストール済みバージョンの検証に追加のメタデータが必要な場合は、実際のモデルの能力を確認してから追加してください。

接続の検証とトラブルシューティング

設定を保存して再読み込みし、現在選択されているのが onezhe プロバイダー、またはあなたが追加したカスタムモデルであることを確認します。
短い質問を 1 つ送信し、応答が返ることを確認します。その後、取り消し可能な小さなタスクを試し、ツール呼び出しとマルチターン会話を個別に確認します。
呼び出しログを開き、リクエスト時刻、モデル、ステータス、使用量を照合します。テキスト応答が 1 回成功しただけで、すべての Agent 機能が互換性を持つわけではありません。
404 が発生した場合は、本文のアドレスとプロトコルが対応しているか確認してください。401 が発生した場合は、キーの出所とプロセスが環境変数を読み取れているか確認してください。429 が発生した場合は、レート制限情報を確認してから再試行してください。詳細はエラーコードとトラブルシューティングを参照してください。

API キーはローカル環境またはツールの資格情報ストアにのみ保存し、コードリポジトリ、スクリーンショット、公開ログにコミットしないでください。バックグラウンドサービスはターミナルの環境変数を継承しない場合があります。補助モデル、検索、その他のツールには個別のプロバイダー設定がある場合があり、それぞれ確認が必要です。

費用とその他の接続方法

Claude API のリアルタイム価格と課金規則を確認してください。他のクライアントが必要な場合はツール接続ディレクトリに戻ってください。自分でプログラムを書く場合はSDK と開発ガイドを利用できます。