# OpenClawをLaoZhang APIに接続する設定と確認手順

> LaoZhang APIの利用資格とモデル権限を確認したうえで、OpenClawのmodels.providersに接続先・APIキー参照・通信方式を登録します。設定例と、使いたい会話で応答やツール実行を確かめる手順を紹介します。

- URL: https://blog.laozhang.ai/ja/posts/openclaw-laozhang-ai-setup-guide
- Published: 2026-03-07
- Updated: 2026-10-08
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ja/about)
- Topic: 開発ツールとエージェント
- Tags: OpenClaw, LaoZhang API, API設定, カスタムプロバイダー, モデル切り替え

---
OpenClawからLaoZhang APIを使うには、`models.providers.laozhang`に`baseUrl: "https://api.laozhang.ai/v1"`、APIキーの参照、`api: "openai-completions"`を設定し、使いたいモデルを登録します。さらに、対象agentのモデル選択と利用許可を合わせれば、その会話で接続を確認できます。

*注記：[laozhang.ai は当ブログ運営チームの自社サービスです](https://blog.laozhang.ai/ja/about#laozhang)。その料金は中立的な比較ではなく、自社の提示価格です。*

ただし、設定を追加すると全モデルが使えるわけではありません。2026年10月7日現在、LaoZhang APIの新規利用には企業向けホワイトリストの承認が必要で、利用できるモデルはAPIトークンのグループにも左右されます。まず[現在の利用条件](https://docs.laozhang.ai/)と[モデル一覧](https://docs.laozhang.ai/models)を確認してください。すでにOpenClawを使っていて、LaoZhang APIの利用が承認されている方を対象に、以下では`gpt-5.4-mini`を1つ登録する例を示します。

設定例は現行の公開文書に基づくものです。この記事で行った確認はオフラインのJSON構文と料金計算であり、実際のOpenClaw接続やモデル呼び出しを検証した結果ではありません。

## 接続前に確認するのは利用資格・モデルID・通信方式

LaoZhang APIは、複数のモデルを扱う前払い・従量課金のAPIゲートウェイです。公開案内の運営者はYingTu Technology Pte. Ltd.で、登録方法にはGmailを使う手順が示されています。登録だけで直ちに使えることや無料クレジットの付与は、現在の案内からは保証できません。[利用案内](https://docs.laozhang.ai/)に従って承認とAPI利用の準備を済ませてから設定してください。

*注記：[laozhang.ai は当ブログ運営チームの自社サービスです](https://blog.laozhang.ai/ja/about#laozhang)。その料金は中立的な比較ではなく、自社の提示価格です。*

接続に必要な情報は次のとおりです。

| 確認するもの | 今回の例 | 読み違えやすい点 |
| --- | --- | --- |
| APIキー | 承認済みアカウントで用意したAPI Key | アカウントのAccessTokenとは別物です |
| トークンのグループ | `gpt-5.4-mini`を利用できるグループ | 公開一覧に載っていても、自分のトークンで使えるとは限りません |
| 接続先 | `https://api.laozhang.ai/v1` | `/chat/completions`までを`baseUrl`に入れません |
| モデルID | `gpt-5.4-mini` | 表示名ではなく、サービスが受け付ける正確なIDを使います |
| OpenClawの通信方式 | `openai-completions` | この例ではChat Completionsを使います |

認証とAPIの形式は[LaoZhang APIマニュアル](https://docs.laozhang.ai/api-manual)、OpenClaw側のフィールドは[カスタムプロバイダーの説明](https://docs.openclaw.ai/gateway/config-tools/custom-providers)が根拠です。

モデル選択では数より用途を優先します。LaoZhangの[ツール連携ガイド](https://docs.laozhang.ai/scenarios)は、`gpt-5.4-mini`をChat Completionsのツール対応候補として挙げ、2026年10月5日のストリーミング・ツール確認を報告しています。これはサービス側の確認報告であり、利用中のOpenClaw、agent設定、ツールの組み合わせで動く証明は、後述の確認で得る必要があります。

2026年10月7日の公開一覧ではClaudeモデルがリソース不足により一時停止中です。以前の`claude-sonnet-4-20250514`や`claude-opus-4`を、そのまま現在の接続例や予備モデルとして使わないでください。また、公開カタログの222モデルには画像・音声なども含まれます。「222モデルすべてがOpenClawの会話やツールに対応する」という意味ではありません。[供給状況と価格](https://docs.laozhang.ai/models)は設定時に再確認します。

## openclaw.jsonにLaoZhangプロバイダーを追加する

![API利用資格、実際の設定ファイル、Gatewayのキー参照、agentの許可、会話選択をそろえる図](https://blog.laozhang.ai/posts/ja/openclaw-laozhang-ai-setup-guide/img/setup-flow.webp)

OpenClawの標準設定ファイルは`~/.openclaw/openclaw.json`です。`OPENCLAW_CONFIG_PATH`を指定している環境では、そちらのファイルを編集します。設定はJSON5形式で、知らないキーや誤った型は検証エラーになります。既存ファイルをバックアップし、以下の例を必要な部分へ統合してください。既存のagent、認証、ツール設定を丸ごと置き換えるための例ではありません。[設定ファイルの説明](https://docs.openclaw.ai/gateway/configuration)

```json
{
  "models": {
    "mode": "merge",
    "providers": {
      "laozhang": {
        "baseUrl": "https://api.laozhang.ai/v1",
        "apiKey": "${LAOZHANG_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4-mini",
            "name": "LaoZhang GPT-5.4 Mini"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "laozhang/gpt-5.4-mini"
      },
      "modelPolicy": {
        "allow": ["laozhang/gpt-5.4-mini"]
      }
    }
  }
}
```

この例の`modelPolicy`は[OpenClaw v2026.8.1以降の方式](https://docs.openclaw.ai/concepts/models)です。既存の許可リストを使っている場合は、元の許可モデルを残して`laozhang/gpt-5.4-mini`を追加します。対象agentに個別の設定がある場合の扱いと、旧バージョンからの移行については次の節で説明します。

接続設定の中でも、以下の対応関係が重要です。

- `laozhang`はOpenClaw内で決めるプロバイダー名です。会話で指定する`laozhang/gpt-5.4-mini`の前半と一致させます。
- `id`の`gpt-5.4-mini`はサービスへ送るモデルIDです。`name`は表示用なので、変えても利用権限や接続先は変わりません。
- `openai-completions`は`/v1/chat/completions`を使うアダプターです。LaoZhangは`/v1/responses`や`/v1/messages`も別のAPIとして案内しており、名前だけを交換して同じリクエストを送ることはできません。
- `merge`は既存モデルと追加モデルを併用する方式で、現行OpenClawの既定値でもあります。省略すると組み込みプロバイダーが消える、という説明は現在の仕様に合いません。`replace`は一覧を意図的に置き換える場合の指定です。

詳しくは[OpenClawのプロバイダー仕様](https://docs.openclaw.ai/gateway/config-tools/custom-providers)と[LaoZhangのAPI形式](https://docs.laozhang.ai/api-manual)を参照してください。今回は未確認の画像入力、推論オプション、コンテキスト上限を設定例に加えていません。ローカルで能力を宣言しても、上流サービスの対応範囲が広がるわけではありません。

*注記：[laozhang.ai は当ブログ運営チームの自社サービスです](https://blog.laozhang.ai/ja/about#laozhang)。その料金は中立的な比較ではなく、自社の提示価格です。*

## APIキーはGatewayを動かしているプロセスから参照させる

上の`${LAOZHANG_API_KEY}`は、OpenClawが起動時に環境変数から読み取る参照です。通常のターミナルで変数を設定しても、別に起動したlaunchd、systemd、コンテナのGatewayへ自動で渡るとは限りません。Gatewayの起動方法に合った場所で変数を用意してください。

OpenClawは親プロセスの環境変数に加えて、作業ディレクトリの`.env`と`~/.openclaw/.env`を読みます。環境ファイルの値は、すでにある環境変数を上書きしません。たとえば`~/.openclaw/.env`を利用する場合、次の1行を自分の環境で用意します。

```dotenv
LAOZHANG_API_KEY=ここを自分のLaoZhang_APIキーに置き換える
```

この行は記入形式の例です。実際のキーを記事、AIチャット、Git、公開スクリーンショットへ貼らないでください。変数が未定義または空なら、`${LAOZHANG_API_KEY}`は解決されず警告が出ます。値を画面へ出力するより、Gatewayの起動元、変数の存在、読み込んだ環境ファイルを確認するほうが安全です。[環境変数の読み込み順](https://docs.openclaw.ai/gateway/configuration/environment-variables)

すでにキーを設定しているのに401が続く場合は、別の起動元に古い値が残っていないかを確認します。`.env`だけを書き換えても、親プロセス側の古い値が優先されていれば解決しません。

## モデルを登録したのに選べない・切り替わらない場合

プロバイダーの登録、利用を許可する設定、会話のモデル選択は別々です。`models.providers`に追加しただけでは、対象agentや既存会話の選択まで変わるとは限りません。

### 許可リストとagentごとの設定を合わせる

現行方式では`agents.defaults.modelPolicy.allow`に、`"laozhang/gpt-5.4-mini"`のようなモデル参照文字列を配列で指定します。`agents.entries.*.modelPolicy.allow`を設定しているagentは、既定の許可リストより個別設定が優先されます。既定値へ追加しても特定agentだけ選べない場合は、そのagentの許可モデルを確認してください。[モデル選択と利用ポリシー](https://docs.openclaw.ai/concepts/models)

`agents.defaults.models`はモデルの別名や設定を保持するマップです。v2026.8.1より前の構成や未移行の構成では、古いマップに由来する制限が残る場合があります。インストール済みバージョンに対応する移行説明を確認し、既存の制限を維持したまま必要なモデルを追加します。`doctor --fix`は修復操作であり、未解決の制限を保持することもあります。「選べないから許可設定を削除する」という手順を標準の修正方法にはしません。

### デフォルトを変えても既存会話の指定は残る

`agents.defaults.model.primary`は既定のモデルです。会話で明示的に別のモデルを指定している場合、その指定が残ることがあります。利用したいagentの会話を開き、次のようにモデルを選びます。

```text
/model laozhang/gpt-5.4-mini
```

会話の個別指定を解除して、agentの既定モデルへ戻す場合は次を使います。

```text
/model default
```

同じプロバイダー名でも、agent側の`models.json`に空でない`baseUrl`が残っていると、そちらが優先される場合があります。設定ファイルを直したのに以前の接続先へ向かうなら、実際に使うagentのプロバイダー定義も確認してください。SecretRef形式の認証情報には別のマージ優先規則があるため、単純に「最後に書いたキーが勝つ」とは判断できません。[プロバイダー定義の統合規則](https://docs.openclaw.ai/gateway/config-tools/custom-providers)

### 保存した設定が実行中のGatewayへ反映されたか確かめる

現行OpenClawでは、モデル・プロバイダー・既定モデル・フォールバックの変更はホットリロードの対象です。既定の`hybrid`方式なら、これらの変更のために毎回手動再起動する必要はありません。一方、リロードが`off`なら手動再起動を待ちます。外部からの変更が無効な場合、Gatewayは最後に正常だった設定で動き続けるため、ファイルが保存できたことだけで反映完了とは判断しないでください。[ホットリロードの仕様](https://docs.openclaw.ai/gateway/configuration/hot-reload)

## 接続確認は「一覧・会話の応答・ツール実行」の順に進める

設定したモデルが表示されること、モデルが返答すること、ツールが実際に動くことには、それぞれ別の確認が必要です。まず設定の読み込みを確かめ、次に少量の会話、最後に許可済みのツールを確認すると、失敗箇所を絞れます。

### 設定とモデル一覧を確認する

自分の環境で設定の検証とプロバイダー一覧を確認します。

```bash
openclaw config validate
openclaw models list --provider laozhang
```

検証が成功すれば設定のキーと型が受け付けられたこと、一覧にモデルがあればOpenClawがその登録を認識したことが分かります。どちらもAPIキーの有効性や上流の応答を証明しません。JSON5では末尾のカンマが認められるため、一般的なJSONと同じ理由で構文エラーと決めつけないでください。[設定の検証](https://docs.openclaw.ai/gateway/configuration)

`openclaw models status`は一覧とは別にモデル選択や認証の状態を確認するコマンドです。秘密情報の解決を伴うことがあり、`--check`の終了コード0も、実際にモデルが返答した証拠にはなりません。また、`models status --probe`は本物のAPI呼び出しを行います。実行には状態を排他的に扱える環境、Gatewayの停止、終了後の後片付けが必要なので、動作中の共有環境で気軽に実行する確認には向きません。[modelsコマンドの説明](https://docs.openclaw.ai/cli/models)

### 使いたいagentの会話で短い応答を確かめる

対象agentの新しい会話、またはモデル指定を確認できる会話で`/model laozhang/gpt-5.4-mini`を選びます。そのうえで「接続確認です。確認番号 JA-1047 をそのまま1行で返してください」のような短いメッセージを送ります。

期待する結果は、その会話のモデル表示と対象ターンの記録が意図したプロバイダー・モデルを示し、指定した確認番号を含む返答が届くことです。モデル自身に「何のモデルですか」と尋ねた回答だけでは、接続先を証明できません。フォールバックが動いた場合も、実際に応答したモデルを確認します。ここまでで確認できるのは、そのターンの文字応答です。

### ツールは呼び出しと実際の結果を対応させる

agentにツールを使わせる予定なら、すでに許可された読み取り専用ツールと、機密情報を含まないテスト対象を選びます。たとえば、作業用ディレクトリに自分で確認用の短いファイルを用意し、「このファイルを読み、内容を引用してください」と依頼します。ファイルの場所と使うツールは、自分のagentがアクセスを許可されている範囲に合わせます。

成功と判断するには、対象ターンにツール呼び出しが記録され、対応するツール結果が返り、その結果に基づく回答があることを確認します。「読みました」という文章だけでは実行の証明になりません。ツールの成功が確認できるまでは、ファイル編集、送信、購入などの操作へ広げないほうが失敗時の影響を抑えられます。

Chat Completionsの返答では、本文が空でも`tool_calls`が入っていることがあります。その場合はネットワーク障害と即断せず、ツール結果まで処理が続いているかを確認してください。ツールの対応、ストリーミング、出力トークンのパラメーターはモデルによって異なります。[LaoZhangのChat Completions仕様](https://docs.laozhang.ai/api-reference/chat-completions)

*注記：[laozhang.ai は当ブログ運営チームの自社サービスです](https://blog.laozhang.ai/ja/about#laozhang)。その料金は中立的な比較ではなく、自社の提示価格です。*

## エラー別に、次に確認する場所を絞る

![モデル一覧、許可、認証、API形式、送信制限の問題をエラー別に切り分ける図](https://blog.laozhang.ai/posts/ja/openclaw-laozhang-ai-setup-guide/img/troubleshooting.webp)

エラーの種類と本文をセットで確認します。ログを共有する際はキー、Authorizationヘッダー、個人情報やファイル内容を除き、発生時刻、モデルID、ステータス、エラー本文を残すと切り分けに役立ちます。

| 症状・エラー | 最初に確認する場所 | 次の判断 |
| --- | --- | --- |
| モデルが一覧に出ない | 編集した設定パス、`providers.laozhang`、`models`配列、設定検証 | 実行中の環境が別の設定ファイルや古い有効設定を使っていないか確認します |
| `Model not allowed` | 対象agentの`modelPolicy.allow`と既存の移行状況 | 必要なモデル参照を許可し、既存の制限を保存します |
| 401 | API KeyとAccessTokenの取り違え、Gateway側の変数、古い値や余分な空白 | 正しい起動元へキーを渡し、認証情報を公開せずに確認します |
| 403 | トークングループとモデル権限、利用資格 | 接続先の書き換えで解決しようとせず、サービスの利用条件を確認します |
| 404 | `baseUrl`、API方式、正確なモデルID | `/v1`の重複や、Chat用接続に別のAPI形式を組み合わせていないか確認します |
| 400 | エラー本文のパラメーター名、コンテキスト量 | 対応しない推論設定やトークン指定を見直します |
| 429 | エラー本文、残高・利用条件、混雑や送信頻度 | 不足・制限の原因を確認してから再試行します |
| 5xx・タイムアウト | サービス状況と自分の接続環境 | 一時障害かを確認し、連続試行で費用や重複処理を増やさないようにします |

HTTPエラーの扱いは[LaoZhang APIマニュアル](https://docs.laozhang.ai/api-manual)、モデルの許可と会話指定は[OpenClawのモデル仕様](https://docs.openclaw.ai/concepts/models)に基づきます。

*注記：[laozhang.ai は当ブログ運営チームの自社サービスです](https://blog.laozhang.ai/ja/about#laozhang)。その料金は中立的な比較ではなく、自社の提示価格です。*

400では、すべてのモデルへ同じ設定を付けないことが重要です。LaoZhangの[ツール連携ガイド](https://docs.laozhang.ai/scenarios)はGPT-6系のChatツール利用について、推論設定や`max_tokens`に関係するエラーを案内しています。ChatとResponsesでも扱いが異なるため、別モデルで動いたオプションをそのまま移さず、エラーで指された項目と対象モデルの文書を照合します。

なお、`openclaw models scan`はLaoZhangの登録モデルを調べるコマンドではありません。OpenRouterの無料モデル一覧を対象にし、既定で実際の確認や設定書き込みを伴います。この接続の切り分けには使わないでください。[scanの対象と動作](https://docs.openclaw.ai/cli/models)

## 料金とフォールバックを混同しない

LaoZhang APIの費用は、入力・出力・キャッシュのトークン量、トークングループ、課金方式などで決まります。OpenClawのローカル設定に費用を0と書いても、サービスの請求が無料になるわけではありません。実際の利用明細を確認する必要があります。[料金の仕組み](https://docs.laozhang.ai/pricing)

*注記：[laozhang.ai は当ブログ運営チームの自社サービスです](https://blog.laozhang.ai/ja/about#laozhang)。その料金は中立的な比較ではなく、自社の提示価格です。*

2026年10月7日の公開価格では、既定グループの`gpt-5.4-mini`は100万トークンあたり入力0.75米ドル、出力4.50米ドル、キャッシュ読み取り0.075米ドルです。キャッシュを使わず、入力20,000トークンと出力5,000トークンを使うと仮定した計算は次のとおりです。

```text
入力: 20,000 ÷ 1,000,000 × 0.75 = 0.015米ドル
出力:  5,000 ÷ 1,000,000 × 4.50 = 0.0225米ドル
合計: 0.0375米ドル
```

これは[公開モデル価格](https://docs.laozhang.ai/models)に基づく例で、実際の請求額や月額予測ではありません。agentが複数回モデルを呼ぶ場合や、過去の会話・ツール結果を再送する場合は、その分を含めて計算します。設定直後の短い応答1回を、通常業務の平均費用として扱わないでください。

予備モデルを使う場合は、先にそのモデルのプロバイダー登録、利用許可、現在の供給状況を確認し、`agents.defaults.model.fallbacks`へ希望する順序で登録します。OpenClawは同じモデルで可能な回復処理を経てから、対象となる失敗に対して次の候補へ進みます。認証、レート制限、課金、モデル不在などが対象になり得ますが、回答の質を判定して安いモデルから高性能モデルへ自動昇格する仕組みではありません。[モデルのフォールバック](https://docs.openclaw.ai/concepts/model-failover)

会話で明示的に選んだモデルは厳格に扱われるため、既定のフォールバックで救済されるとは限りません。また、同じLaoZhangゲートウェイ内のモデルを2つ並べても、同じ残高不足やゲートウェイ障害を共有する可能性があります。予備モデルがあることと、独立した障害対策があることを分けて考えます。

## よくある質問

### LaoZhang APIを登録すれば、すぐに無料で試せますか？

現在の公開案内では、新規利用に企業向けホワイトリスト承認が必要です。登録直後の利用や無料クレジットを一律に保証できません。2026年10月7日時点の[利用案内](https://docs.laozhang.ai/)で資格と手順を確認し、トークンの権限と費用を把握してから呼び出してください。

### ClaudeをOpenClawの予備モデルにできますか？

2026年10月7日の[LaoZhangモデル一覧](https://docs.laozhang.ai/models)では、Claudeモデルはリソース不足により一時停止中です。この状態ではLaoZhang経由の有効な予備モデルとして前提にできません。供給が再開した場合も、モデルID・トークン権限・API方式・実際のツール動作を確認してから追加します。

### モデル一覧に出たら、ツールも使えると判断できますか？

判断できません。一覧は登録の認識を示します。ツールについては、対象agentの会話で呼び出しと対応する実行結果を確認する必要があります。LaoZhangの[ツール確認報告](https://docs.laozhang.ai/scenarios)も、自分のOpenClaw環境の確認を代替するものではありません。

### この設定でChatGPTやCodexのサブスクリプションを使えますか？

この例はLaoZhangのAPIキーを使う従量課金の接続です。プロバイダー名やモデル参照を追加しても、ChatGPTやCodexの契約がLaoZhang APIの利用権限になるわけではありません。[LaoZhangの認証方式](https://docs.laozhang.ai/api-manual)に合うAPI Keyを使います。

クラウドAPIとローカルモデルの選び方も検討したい場合は、[OpenClawのLLM設定：Ollama・クラウド接続とモデル切り替え](https://blog.laozhang.ai/ja/posts/openclaw-llm-setup)を参照してください。このLaoZhang接続では、まず1モデルの応答と必要なツールを確認し、その結果を見てモデルや予備の接続先を増やすと、問題と費用を追いやすくなります。

## 参考資料

本文で参照している外部ページを、登場順に並べています。最終更新日：2026-10-08。

- [カスタムプロバイダーの説明](https://docs.openclaw.ai/gateway/config-tools/custom-providers) (docs.openclaw.ai)
- [設定ファイルの説明](https://docs.openclaw.ai/gateway/configuration) (docs.openclaw.ai)
- [OpenClaw v2026.8.1以降の方式](https://docs.openclaw.ai/concepts/models) (docs.openclaw.ai)
- [環境変数の読み込み順](https://docs.openclaw.ai/gateway/configuration/environment-variables) (docs.openclaw.ai)
- [ホットリロードの仕様](https://docs.openclaw.ai/gateway/configuration/hot-reload) (docs.openclaw.ai)
- [modelsコマンドの説明](https://docs.openclaw.ai/cli/models) (docs.openclaw.ai)
- [モデルのフォールバック](https://docs.openclaw.ai/concepts/model-failover) (docs.openclaw.ai)