OpenClawでLLMモデルを変更する方法 - Claude/GPT/GLMの設定完全ガイド

OpenClawは複数のLLMプロバイダー（OpenAI、Anthropic、Zhipuなど）に対応した柔軟なAIエージェントフレームワークです。モデルの変更は設定ファイルopenclaw.jsonを編集するだけで簡単に行えます。この記事では、基本的な設定方法からトラブルシューティングまで、OpenClawでのモデル設定を完全に理解できるよう解説します。

この記事でわかること

設定ファイルの構造と編集方法
モデルエイリアスの活用テクニック
主要プロバイダーの具体的な設定例
セッションごとのモデル切り替え方法
よくあるエラーの解決方法

openclaw.jsonの場所と基本構造

設定ファイルの場所

OpenClawの設定ファイルは、デフォルトで以下の場所に保存されます：

~/.openclaw/openclaw.json

環境変数OPENCLAW_CONFIG_PATHを設定することで、別の場所を指定することも可能です。また、--profileオプションを使うと、複数の設定を切り替えられます：

# devプロファイルを使用（~/.openclaw-dev に隔離）
openclaw --dev gateway

基本的なJSON構造

openclaw.jsonは複数のセクションで構成されています。モデル設定に関連する主なセクションは以下の通りです：

{
  "models": {
    "mode": "merge",
    "providers": {
      "zai": { ... },
      "openai": { ... }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "zai/glm-5"
      },
      "models": {
        "zai/glm-5": { "alias": "GLM" }
      }
    }
  },
  "auth": {
    "profiles": { ... }
  }
}

セクション	役割
`models.providers`	利用可能なモデルの定義（ID、コンテキストウィンドウ、コストなど）
`agents.defaults.model`	デフォルトで使用するモデルの指定
`agents.defaults.models`	モデルエイリアスの定義
`auth.profiles`	APIキーやOAuth認証の設定

モデルエイリアスの使い方

エイリアスとは

エイリアスは、長いモデルIDを短い名前で参照できる機能です。例えば、zai/glm-5というモデルIDをGLMという短い名前で呼び出せます。

{
  "agents": {
    "defaults": {
      "models": {
        "zai/glm-5": { "alias": "GLM" },
        "zai/glm-4.7": { "alias": "GLM47" },
        "openai-codex/gpt-5.3-codex": { "alias": "GPT5C" }
      }
    }
  }
}

デフォルトのエイリアス一覧

現在設定されているエイリアスは以下のコマンドで確認できます：

openclaw models aliases list

出力例：

GLM -> zai/glm-5
GLM47 -> zai/glm-4.7
GLM47F -> zai/glm-4.7-flash
GPT5C -> openai-codex/gpt-5.3-codex

カスタムエイリアスの追加方法

CLIから簡単にエイリアスを追加できます：

# エイリアスの追加
openclaw models aliases add Claude claude/claude-opus-4.5

# エイリアスの削除
openclaw models aliases remove Claude

主要プロバイダーの設定方法

OpenAI（GPT-5.3 Instant, GPT-5.3 Codexなど）

OpenAIのモデルを使用するには、まず認証を設定します：

# インタラクティブなセットアップ
openclaw configure

# または、APIキーを直接設定
openclaw models auth add openai --api-key sk-xxx

設定ファイルでの定義例：

{
  "models": {
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.3-instant",
            "name": "GPT-5.3 Instant",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

Anthropic（Claude Opus 4.5など）

{
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://api.anthropic.com",
        "api": "anthropic",
        "models": [
          {
            "id": "claude-opus-4.5",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Zhipu（GLM-4.7, GLM-5など）

{
  "models": {
    "providers": {
      "zai": {
        "baseUrl": "https://api.z.ai/api/coding/paas/v4",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-5",
            "name": "GLM-5",
            "contextWindow": 204800,
            "maxTokens": 131072
          },
          {
            "id": "glm-4.7",
            "name": "GLM-4.7",
            "reasoning": true,
            "contextWindow": 204800,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}

その他（DeepSeek, Qwenなど）

OpenAI互換APIを使用するプロバイダーは、api: "openai-completions"を指定して設定できます：

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-chat", "name": "DeepSeek Chat" }
        ]
      }
    }
  }
}

セッションごとのモデル指定

デフォルトモデルの変更

普段使いのモデルを変更するには：

# モデルIDで指定
openclaw models set zai/glm-4.7

# エイリアスで指定
openclaw models set GLM47

この変更は永続的で、新しいセッションすべてに適用されます。

特定の会話だけ別モデルを使う方法

チャット内でスラッシュコマンドを使って一時的にモデルを変更できます：

/model claude-opus-4.5

またはエイリアスを使用：

/model GPT5C

この変更は現在のセッション（会話）のみに適用され、新しいセッションを開始するとデフォルトモデルに戻ります。

フォールバックの設定

メインモデルが利用できない場合の代替モデルを設定できます：

# フォールバックリストの確認
openclaw models fallbacks list

# フォールバックの追加
openclaw models fallbacks add openai/gpt-4o

# フォールバックの削除
openclaw models fallbacks remove openai/gpt-4o

フォールバックは順番に試行されます。例えば、GLM-5 → GPT-4o → Claude という順序で設定すると、GLM-5が利用できない場合はGPT-4oが、それもダメならClaudeが使用されます。

トラブルシューティング

1. 「Model not found」エラー

Error: Model 'claude-3' not found

原因: モデルIDが間違っている、またはプロバイダーが設定されていない

解決方法:

# 利用可能なモデル一覧を確認
openclaw models list --all

# 正しいモデルIDを確認して設定
openclaw models set anthropic/claude-opus-4.5

よくある間違い:

claude-3 → 正しくは anthropic/claude-3-opus（プロバイダー名が必要）
gpt-4 → 正しくは openai/gpt-4-turbo（具体的なモデル名が必要）
エイリアスの大文字小文字が間違っている（glm ではなく GLM）

2. 認証エラー

Error: 401 Unauthorized

原因: APIキーが無効または期限切れ

解決方法:

# 認証状態を確認
openclaw models status

# 認証プロファイルを再設定
openclaw models auth add openai --api-key sk-xxx

3. 設定ファイルの検証エラー

# 設定ファイルの妥当性をチェック
openclaw config validate

# 設定値を確認
openclaw config get agents.defaults.model.primary

よくある設定ミス:

JSONの構文エラー（カンマの忘れ、括弧の不一致）
必須フィールドの欠落（idやnameなど）
不正なbaseUrl形式

4. レート制限エラー

Error: 429 Too Many Requests

原因: APIのレート制限に達した

解決方法:

フォールバックモデルを設定して自動切り替え
しばらく待ってから再試行
プランのアップグレードを検討

まとめ

OpenClawでのモデル設定は、以下の3つのレイヤーで管理されます：

プロバイダー設定 (models.providers): 利用可能なモデルの定義
エイリアス設定 (agents.defaults.models): 短い名前での参照
デフォルト設定 (agents.defaults.model.primary): 普段使いのモデル

クイックリファレンス

やりたいこと	コマンド
現在のモデル確認	`openclaw models status`
デフォルト変更	`openclaw models set <model>`
エイリアス追加	`openclaw models aliases add <name> <model>`
エイリアス一覧	`openclaw models aliases list`
セッション内変更	`/model <alias>`
モデル一覧	`openclaw models list --all`
認証確認	`openclaw models auth list`
設定検証	`openclaw config validate`
フォールバック追加	`openclaw models fallbacks add <model>`

これでOpenClawでのモデル設定をマスターできました。好みのモデルを設定して、快適なAIエージェントライフを楽しんでください！

OpenClawでLLMモデルを変更する方法 – Claude/GPT/GLMの設定完全ガイド

この記事でわかること

openclaw.jsonの場所と基本構造

設定ファイルの場所

基本的なJSON構造

モデルエイリアスの使い方

エイリアスとは

デフォルトのエイリアス一覧

カスタムエイリアスの追加方法

主要プロバイダーの設定方法

OpenAI（GPT-5.3 Instant, GPT-5.3 Codexなど）

Anthropic（Claude Opus 4.5など）

Zhipu（GLM-4.7, GLM-5など）

その他（DeepSeek, Qwenなど）

セッションごとのモデル指定

デフォルトモデルの変更

特定の会話だけ別モデルを使う方法

フォールバックの設定

トラブルシューティング

1. 「Model not found」エラー

2. 認証エラー

3. 設定ファイルの検証エラー

4. レート制限エラー

まとめ

クイックリファレンス

コメント