チュートリアル 01 — クイックスタート：5分でプライベートAIアシスタントを起動する

目標：OpenClawをインストールし、MiniMaxモデルを設定して、ゲートウェイを起動し、最初のメッセージを送信します。

必要なもの

macOS / Linux（WindowsはWSL2が必要）
Node.js 22+（nvmでの管理を推奨）
pnpm 9+
MiniMax API Key（登録はこちら）

ステップ1：クローンと依存関係のインストール

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install

ステップ2：環境変数の設定

サンプル .env ファイルをコピーして、MiniMax API Keyを入力します：

cp .env.example .env   # exampleがない場合は ~/.openclaw/.env を直接作成

.env を編集して以下を追加します：

MINIMAX_API_KEY=sk-あなたのkey

ステップ3：設定ファイルの作成

~/.openclaw/openclaw.json を新規作成します：

{
  "gateway": { "mode": "local" },
  "env": { "MINIMAX_API_KEY": "${MINIMAX_API_KEY}" },
  "agents": {
    "defaults": {
      "model": { "primary": "minimax/MiniMax-M2.1" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "apiKey": "${MINIMAX_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 15, "output": 60, "cacheRead": 2, "cacheWrite": 10 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

ステップ4：ゲートウェイのインストールと起動

pnpm openclaw gateway install
pnpm openclaw gateway start

状態を確認します：

pnpm openclaw gateway status
# Runtime: running と RPC probe: ok が表示されるはずです

ステップ5：WebChatを開いてチャット

ブラウザでアクセスします：

http://127.0.0.1:18789/

最初のメッセージを入力してみましょう、例えば：

"こんにちは！Pythonのバブルソートを書いてください"

モデルの確認

pnpm openclaw models list
# minimax/MiniMax-M2.1  default が表示されるはずです

よくある質問

OpenClawはWindowsをサポートしていますか？

OpenClawはmacOSとLinuxをサポートしています。Windowsユーザーはまず WSL2（Windows Subsystem for Linux）をインストールし、WSL2環境内で同じ手順に従って操作してください。WSL2のインストールチュートリアルはMicrosoftの公式ドキュメントを参照してください。

MiniMax以外に、OpenClawはどのAIモデルをサポートしていますか？

OpenClawはMiniMax（M2.1、M2.5、VL-01）、Anthropic（Claude Sonnet、Opus）、OpenAI（GPT-4o）など、多くの主要なモデルプロバイダーをサポートしています。マルチモデルの設定方法はチュートリアル 05をご覧ください。

ゲートウェイ起動後にブラウザで開けない場合はどうすればよいですか？

まずポートが占有されていないか確認します：lsof -i :18789。ポートが競合している場合は、openclaw.json の gateway.port フィールドを変更してから再起動してください。ファイアウォールの問題であれば、ローカルのlocalhost接続がブロックされていないことを確認してください。

pnpm installがエラーになる場合の対処法は？

最も一般的な原因はNode.jsのバージョンが要件を満たしていないことです（22+が必要）。node -v でバージョンを確認し、nvmを使ったバージョン管理を推奨します：nvm install 22 && nvm use 22、その後 pnpm install を再実行してください。

メッセージを送ってもAIが応答しない場合は？

pnpm openclaw gateway status を実行してゲートウェイが稼働しているか確認します（Runtime: running が表示されるはずです）。次に pnpm openclaw models list を実行してモデルが正しく読み込まれているか確認します。モデルリストが空の場合は、API Keyの設定が正しいか確認してください。

次のステップ

チュートリアル 02 — AIをTelegramに接続し、スマートフォンからいつでも質問できるようにする
チュートリアル 03 — 独自のSkillを作成してAIの能力を拡張する