OpenClaw モデルを変更する方法: 完全ガイド

OpenClaw でのモデル切り替えはどのように機能しますか?

OpenClaw は、構成チェーンを通じてアクティブなモデルを解決します。

1. Environment variables — システムまたはプロセスレベルで設定
2. Config file — 通常、プロジェクト ルートの openClaw.config.json または .env
3. Runtime override — API リクエスト ペイロードで直接渡されます

リクエストが受信されると、OpenClaw はモデル識別子を読み取り、それをプロバイダーにマッピングし、プロバイダーの API キーで認証して、プロンプトを転送します。その後、応答は正規化されてアプリケーションに返されます。

OpenClaw モデルを変更する主な方法

1. 設定ファイルを編集する

最も一般的なアプローチ。 openClaw.config.json (または同等の構成ファイル) を開き、モデル フィールドを更新します。

{
  "model": "gpt-4o",
  "provider": "openai",
  "apiKey": "your-api-key-here"
}

別のモデルに切り替えるには、"model" 値を変更します。

{
  "model": "claude-3-5-sonnet-20241022",
  "provider": "anthropic",
  "apiKey": "your-anthropic-key"
}

ファイルを保存し、OpenClaw サーバーを再起動して変更を有効にします。

2. 環境変数を使用する

Environment variables は構成ファイルをオーバーライドし、運用環境で推奨されるアプローチです。

OPENCLAW_MODEL=gemini-1.5-pro
OPENCLAW_PROVIDER=google
OPENCLAW_API_KEY=your-google-key

これらを .env ファイルまたはデプロイメント環境 (Docker、クラウド プラットフォームなど) に設定します。

3. 実行時にモデルを渡す

リクエストごとにモデルを切り替えるには、API 呼び出しの本文にモデルを含めます。

{
  "model": "mistral-large-latest",
  "messages": [
    { "role": "user", "content": "Explain quantum entanglement simply." }
  ]
}

これは、アプリケーション内の異なるワークフローで異なるモデルが同時に必要な場合に便利です。

4. ローカルモデル（Ollama / LM Studio）に切り替える

モデルをローカルで実行する場合:

1. Ollama をインストールし、モデルをプルします: ollama pull llama3
2. ローカル エンドポイントを指すように OpenClaw 構成を更新します。

{
  "model": "llama3",
  "provider": "ollama",
  "baseUrl": "http://localhost:11434"
}

ローカル モデルには API キーは必要ありません。

OpenClaw モデルを変更するメリット

一般的な使用例

一般的な問題のトラブルシューティング

よくある質問

最終的な考え

OpenClaw モデルの変更は構成レベルの操作であり、アプリケーション ロジックを書き直す必要はありません。コスト、速度、プライバシー、機能のいずれを最適化する場合でも、OpenClaw の階層化された構成システムには、構成ファイルの編集、環境変数の設定、またはリクエスト時のモデルの受け渡しという 3 つの明確なオプションが用意されています。

シンプルにするために構成ファイルのアプローチから始めて、実稼働に向けてスケールするにつれて環境変数に移行します。複雑なマルチエージェント パイプラインを実行しているチームの場合は、モデルのルーティングを視覚的なインターフェイスに抽象化し、手動による構成管理を完全に排除する EasyClaw のような専用ツールを検討してください。