AZZ API

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

  • 发布时间
  • 栏目guide
  • 语言ja

OpenClaw自律型エージェントフレームワーク接続ガイド：install.shによる一括インストール、onboardガイドによる設定、またはopenclaw.jsonへのモデルProvider追加によるゲートウェイ接続方法。

1. OpenClawとは

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

2. 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

3. 当サイトのゲートウェイへの接続（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を使用するモデルのslugに変更すれば、OpenClawのすべてのエージェントタスクで当サイトのゲートウェイが使用されます。

4. 起動とよく使うコマンド

openclaw gateway --port 18789

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

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

5. よくあるトラブルシューティング

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

セキュリティの推奨事項：sk-キーを公開リポジトリにコミットしないでください。エージェントタスクはトークン消費量が多いため、残高に注意してください。

Base URLに関する説明：当サイトは /v1beta/models/... と /v1beta/v1beta/models/...（および /v1/... と /v1/v1/...）の両方を受け付けます。そのため、クライアント側で /v1 や /v1beta を補完するかどうかは呼び出しに影響しません。Base URLにはドメインルートまたは /v1beta を含むアドレスのどちらでも入力可能です。モデルIDは、コンソールの「トークン」ページ右上にある「モデルID」からコピーして確認してください。