独立した仮想環境にインストールすることを推奨します。ファイルが勝手に削除されたりなどトラブルが発生しても問題がないようにするためです。

• これを書いている人は自宅の PC に proxmox を入れており、仮想マシンに Ubuntu Server 24.04 を入れて OpenClaw を動かしています。
  • https://www.proxmox.com/en/
  • proxmox

• 公式のドキュメントの手順通りに行います
  • https://docs.openclaw.ai/install

1. 「curl -fsSL https://openclaw.bot/install.sh | bash」を実行
2. I understand this is powerful and inherently risky. Continue?: Yes
   • インストーラーが始まるので、セキュリティリスクの説明をよく読んでから Yes を選択
   • もしインストーラーが自動的に始まらない場合は「openclaw onboard --install-daemon」
3. Onboarding mode: QuickStart
   • もし Gateway (Server) ではなく Node としてインストールする場合は Manual を選びます
4. Model/auth provider: 任意の API を選択
   • すでに使用している AI サービスの API があればここで指定します。適当に選択だけしておいて、あとから設定することもできます。
   • もし ollama や LMStudio 等の Local LLM を使う場合は仮の設定として 「Skip for now」→ 「openai」→「Keep current」 を選びます。
5. Select channel (Quick Start): 任意のサービスを選択 または Skip for now
   • Discord や Slack などのセットアップができます。
   • あとから行う場合は「Skip for now」
6. Configure skills now?: Yes
7. Show Homebrew install command?: Yes
   • Homebrew のインストール手順が表示されるので、OpenClaw のインストールが終わってから実行します
8. Preferred node manager for skill installs: npm
9. Install missing skill dependencies: Skip for now
   • SPACE キーでどれか項目を選択してから ENTER で進みます
10. Set GOOGLE_PLACES_API_KEY for goplaces?: No
11. Set GOOGLE_PLACES_API_KEY for local-places?: No
12. Set GEMINI_API_KEY for nano-banana-pro?: No
13. Set NOTION_API_KEY for notion?: No
14. Set OPENAI_API_KEY for openai-image-gen?: No
15. Set OPENAI_API_KEY for openai-whisper-api?: No
16. Set ELEVENLABS_API_KEY for sag?: No
17. Enable hooks?: Skip for now
    • SPACE キーでどれか項目を選択してから ENTER で進みます
18. How do you want to hatch your bot?: Do this later
19. Install shell completion script?: Yes

• https://brew.sh/

もし Homebrew がインストールされていない場合は、初回のインストール時にメッセージが出ます。以下の手順でインストールしておいてください。

1. 「/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"」を実行
2. Homebrew インストーラーの最後に表示されたメッセージに従い、PATH の追加を行います。
   • 「echo >> /home/hiroog/.bashrc」
   • 「echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"' >> $HOME/.bashrc」
   • 「eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"」

もし有料の API を使用する場合は以下の手順で再セットアップできます。

1. 「openclaw configure --section model」を実行
2. Where will this Gateway run?: Local
3. Model/auth provider: 使用するサービスを選択
   • 以降はそれぞれの API 毎に異なります。インストーラーの指示に従ってください。

直接 ~/.openclaw/openclaw.json を編集します。

1. models.providers を定義して任意の provider を追加します。
2. agents.defaults.model.primary に、使用する provider と model を指定します。

ポイントは、provider 名を既存の “ollama” や “lmstudio” と重ならないようにすることです。 OpenClaw にはプリセットの provider として “ollama” 等がすでに含まれておりこれらを上書きすることができません。 例えば agents.defaults.model.primary に “ollama/gpt-oss:120b” を指定した場合、必ず localpc (127.0.0.1:11343) の ollama を見に行こうとして baseUrl にアクセスしません。

🔵 任意の PC 上で走っている ollama を使用する場合の例

{
  ～
 
  "models": {
    "providers": {
      "ollamalocalpc": {
        "baseUrl": "http://＜OLLAMA HOST ADDRESS＞:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-oss:120b",
            "name": "gpt-oss:120b",
            "reasoning": true,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 65536,
            "maxTokens": 655360
          }
        ]
      }
    }
  },
 
  ～ 
 
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollamalocalpc/gpt-oss:120b"
      },
      "workspace": "/home/～/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

🔵 任意の PC 上で走っている lmstudio を使用する場合の例

{
  ～
 
  "models": {
    "providers": {
      "lmstudiolocalpc": {
        "baseUrl": "http://＜LMSTUDIO HOST ADDRESS＞:1234/v1",
        "apiKey": "lmstudio",
        "api": "openai-completions",
        "models": [
          {
            "id": "openai/gpt-oss-120b",
            "name": "openai/gpt-oss-120b",
            "reasoning": true,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 65536,
            "maxTokens": 655360
          }
        ]
      }
    }
  },
 
  ～
 
  "agents": {
    "defaults": {
      "model": {
        "primary": "lmstudiolocalpc/openai/gpt-oss-120b"
      },
      "workspace": "/home/～/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

初回のインストーラーでスキップした場合や、あとから別のツールとの連携を追加したい場合などは以下の手順で設定できます。

1. 「openclaw configure --section channels」を実行
2. Where will this Gateway run?: Local
3. Channels: Configure/link
4. Select a channel: 使用するサービスを選択
   • 以降はそれぞれのサービス毎に異なります。インストーラーの指示に従ってください。