OpenClawでOpenAI GPTモデルを設定する完全ガイド

はじめに

OpenAI の GPT シリーズモデルは、現在最も主流な大規模言語モデルの一つです。OpenClaw は OpenAI の全シリーズモデルをネイティブサポートしており、GPT-4、GPT-4o、GPT-4o mini、そして最新の o3 推論モデルにも対応しています。本記事では、ゼロから OpenAI モデルの完全な設定を行う手順をご紹介します。

事前準備

設定を始める前に、以下の条件を満たしていることをご確認ください：

条件	説明
OpenClaw がインストール済み	`openclaw doctor` を実行してインストールが正常であることを確認
Node.js 22+	OpenClaw のランタイム依存関係
OpenAI アカウント	支払い方法が紐づけられたアカウントが必要
ネットワーク環境	OpenAI API に正常にアクセスできること（一部の地域ではプロキシが必要）

ステップ1：OpenAI API Key の取得

1.1 OpenAI プラットフォームにログイン

platform.openai.com にアクセスし、アカウントにログインします。

1.2 API Key の作成

API Keys ページに移動し、Create new secret key をクリックします：

名称：openclaw-production（わかりやすい名前を付けることを推奨）
権限：All（または必要に応じて選択）

作成後、すぐにキーをコピーして安全に保管してください。API Key は一度しか表示されません。形式は以下の通りです：

sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1.3 利用限度額の設定

Billing → Usage limits で月間利用上限を設定することを強く推奨します：

Hard limit: $50（ご予算に応じて調整）
Soft limit: $40（上限に近づくとメール通知が届きます）

ステップ2：OpenClaw で OpenAI を設定する

2.1 設定ファイルの編集

OpenClaw の設定ファイルを開きます：

nano ~/.config/openclaw/openclaw.json5

models セクションに OpenAI の設定を追加します：

{
  // OpenClaw メイン設定ファイル
  models: {
    openai: {
      provider: "openai",
      apiKey: "sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      defaultModel: "gpt-4o",
      baseUrl: "https://api.openai.com/v1",  // デフォルト値、通常は変更不要
    }
  }
}

2.2 環境変数の使用（推奨）

セキュリティのため、API Key は設定ファイルに直接記述するのではなく、環境変数で渡すことを推奨します：

# ~/.bashrc または ~/.zshrc に追加
export OPENAI_API_KEY="sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

設定ファイルでは環境変数を参照します：

{
  models: {
    openai: {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "gpt-4o",
    }
  }
}

2.3 OpenClaw を再起動して設定を反映

openclaw restart

設定が正しいか確認します：

openclaw doctor

出力に ✓ OpenAI connection OK と表示されれば、設定は成功です。

ステップ3：モデル選択ガイド

OpenAI は現在複数のモデルを提供しており、それぞれに特徴があります：

モデル	特徴	入力価格 (100万トークンあたり)	出力価格 (100万トークンあたり)	推奨シーン
gpt-4o	フラッグシップマルチモーダルモデル	$2.50	$10.00	日常会話、画像理解
gpt-4o-mini	軽量高効率	$0.15	$0.60	簡単なタスク、高並列処理
gpt-4	定番の高性能モデル	$30.00	$60.00	複雑な推論（高価格）
o3	推論強化モデル	$10.00	$40.00	数学、プログラミング、論理推論
o3-mini	推論モデル軽量版	$1.10	$4.40	推論とコストのバランス

3.1 複数モデルの設定

設定で複数の OpenAI モデルを登録し、異なるチャンネルに異なるモデルを割り当てることができます：

{
  models: {
    "openai-main": {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "gpt-4o",
    },
    "openai-lite": {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "gpt-4o-mini",
    },
    "openai-reasoning": {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "o3",
    }
  },
  channels: {
    telegram: {
      model: "openai-main",      // Telegram では GPT-4o を使用
    },
    discord: {
      model: "openai-lite",      // Discord ではより安価な mini モデルを使用
    }
  }
}

ステップ4：パラメータチューニング

4.1 Temperature パラメータ

Temperature は出力のランダム性を制御します。範囲は 0 から 2 です：

{
  models: {
    openai: {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "gpt-4o",
      parameters: {
        temperature: 0.7,     // デフォルト値、創造性と一貫性のバランス
        // temperature: 0,    // 完全に決定論的、コード生成に適合
        // temperature: 1.2,  // より創造的、執筆に適合
      }
    }
  }
}

一般的なシーンでの推奨 Temperature 値：

シーン	推奨Temperature	説明
コード生成	0 - 0.2	正確で一貫した出力が必要
日常会話	0.5 - 0.8	自然で変化のある会話
創作活動	0.8 - 1.2	より多様な表現
データ抽出	0	厳密にフォーマットに従った出力が必要

4.2 Token 制限

1回の回答の最大長を制御します：

parameters: {
  temperature: 0.7,
  maxTokens: 4096,          // 1回あたりの最大出力トークン数
  // GPT-4o は最大 16384 出力トークンに対応
  // o3 は最大 100000 出力トークンに対応
}

4.3 システムプロンプト

モデルに役割と行動指針を設定します：

{
  models: {
    openai: {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "gpt-4o",
      systemPrompt: "你是一个友好的AI助手，名叫小智。你的回答简洁准确，使用中文交流。",
      parameters: {
        temperature: 0.7,
        maxTokens: 4096,
      }
    }
  }
}

ステップ5：Azure OpenAI の設定

Azure でホストされている OpenAI サービスを使用する場合、設定方法が若干異なります：

{
  models: {
    "azure-openai": {
      provider: "openai",
      apiKey: "${AZURE_OPENAI_API_KEY}",
      baseUrl: "https://your-resource.openai.azure.com/openai/deployments/your-deployment",
      defaultModel: "gpt-4o",       // Azure で作成したデプロイメント名
      azureApiVersion: "2024-12-01-preview",
      parameters: {
        temperature: 0.7,
        maxTokens: 4096,
      }
    }
  }
}

Azure OpenAI の利点：

エンタープライズグレードの SLA 保証
データが指定した Azure リージョンから離れない
プライベートネットワークデプロイメントに対応
コンプライアンス認証が充実

ステップ6：費用の見積もり

以下は一般的なシーンにおける月額費用の参考です（GPT-4o 使用時）：

利用頻度	1日あたりのメッセージ数	1メッセージあたりの平均トークン数	月額費用の目安
個人（軽度）	20 件	~1000	$3 - $5
個人（重度）	100 件	~1500	$15 - $25
小規模チーム	500 件	~1200	$50 - $80
中規模	2000 件	~1000	$150 - $250

予算が限られている場合は、日常会話を gpt-4o-mini に切り替えることで、費用を約90%削減できます。

ステップ7：検証とテスト

設定完了後、以下の手順で検証します：

# サービスを再起動
openclaw restart

# 接続状態を確認
openclaw doctor

# リアルタイムログを確認
openclaw logs

その後、連携済みの任意のチャンネルからテストメッセージを送信し、モデルが正常に応答することを確認してください。

よくある質問

API Key が無効

Error: 401 Unauthorized - Invalid API key

解決方法：API Key が正しくコピーされているか、sk- で始まっているか、OpenAI の管理画面で有効化されているかを確認してください。

クォータ超過

Error: 429 Rate limit exceeded

解決方法：OpenAI 管理画面の利用制限を確認し、支払い方法が紐づけられていることを確認してください。新規アカウントではレート制限が低い場合がありますが、利用を続けることで自動的に引き上げられます。

ネットワーク接続の問題

お住まいの地域から OpenAI API に直接アクセスできない場合は、プロキシを設定できます：

{
  proxy: {
    url: "http://127.0.0.1:7890",  // プロキシアドレス
  },
  models: {
    openai: {
      provider: "openai",
      apiKey: "${OPENAI_API_KEY}",
      defaultModel: "gpt-4o",
    }
  }
}

まとめ

本記事では、OpenClaw で OpenAI GPT モデルを設定する完全な手順を紹介しました。主なステップは、API Key の取得、設定ファイルの編集、適切なモデルの選択、パラメータのチューニングです。ほとんどのユーザーには、メインモデルとして GPT-4o を使用し、簡単なタスクには GPT-4o mini を組み合わせて費用を節約することを推奨します。中国本土やその他のアクセス制限がある地域にお住まいの場合は、Azure OpenAI が安定した信頼性の高い代替手段です。