OpenClaw API中継接続ガイド：自律エージェントフレームワークの設定

一、OpenClaw とは

OpenClaw は、オープンソースの AI エージェントフレームワークです。モデル（ローカルまたはクラウドゲートウェイ）を指定するだけで、PC上で自動的にタスクを実行（UI操作、コマンド実行、ファイル管理など）できます。核心となるのは「モデルエンドポイントの設定」であり、当サイトのゲートウェイとの接続に最適です。

二、OpenClaw のインストール

ワンクリックインストールスクリプトを推奨します：

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard

Docker またはソースコードからのインストールも可能です：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Docker：./scripts/docker/setup.sh
# ソースコード（pnpm）：corepack enable && pnpm install && pnpm openclaw setup

三、当サイトのゲートウェイへの接続（2つの方法）

方法1：対話型ガイド（onboard）

openclaw onboard を実行し、Provider を選択する際にカスタムアドレスをサポートするオプションを選択して、以下を入力します：

Base URL : https://www.relay-api.com
API Key  : sk-あなたのキー
Model ID : claude-sonnet-5

（openai / gemini エンドポイントはそれぞれ https://www.relay-api.com/v1 と https://www.relay-api.com/v1beta に対応しています）

方法2：設定ファイルの直接編集

OpenClaw は ~/.openclaw/openclaw.json（Linux/macOS）または %USERPROFILE%\.openclaw\openclaw.json（Windows）を読み込みます。models.providers に新しい Provider を追加します：

{
  "gateway": {
    "mode": "local"
  },
  "agents": {
    "defaults": {
      "model": {"primary": "jizhi/claude-sonnet-5"}
    }
  },
  "models": {
    "providers": {
      "jizhi": {
        "baseUrl": "https://www.relay-api.com",
        "apiKey": "sk-あなたのキー",
        "api": "openai-completions"
      }
    }
  }
}

primary を使用するモデルスラグに変更すれば、OpenClaw のすべてのエージェントタスクで当サイトのゲートウェイが使用されます。

四、起動とよく使うコマンド

openclaw gateway --port 18789

起動後、http://localhost:18789 にアクセスしてコンソールに入ります。よく使うコマンド：

openclaw doctor              # 問題の診断
openclaw security audit      # セキュリティチェック
openclaw config set key x    # 設定の変更
openclaw channels add --channel telegram  # メッセージチャンネルの追加

五、トラブルシューティング

現象	対処
401 / 403	キーが無効、未有効化、または残高不足です。sk- が正しいか確認し、チャージしてください。
404 / モデル利用不可	モデルスラグがプラットフォームと一致していないか、モデルが未有効化です。モデルIDを確認してください。
モデルに接続できない	baseUrl が当サイトの入口になっているか確認してください。

セキュリティに関するアドバイス：sk- キーを公開リポジトリに書き込まないでください。エージェントタスクはトークン消費量が大きいため、残高に注意してください。