Alibaba Cloud Model Studio:OpenClaw

手動インストール

1. Node.js のインストールまたは更新

   1. 現在のバージョンを確認します。Node.js はバージョン 22.0 以降が必要です。「command not found」と表示された場合は、Node.js が未インストールです。また、バージョンが 22.0 より低い場合は、Node.js を更新してください。

      macOS でターミナルを開くには、Command + Space キーを押して「Terminal」と入力し、Enter キーを押します。Windows でターミナルを開くには、Windows キーを押して「Terminal」「PowerShell」または「cmd」と入力し、Enter キーを押します。

      node -v

   2. ダウンロードおよびインストールを行います。Node.js のウェブサイトにアクセスし、バージョン番号 >= 22.x.x の長期サポート（LTS）版を選択して、ご利用のオペレーティングシステムに対応するインストーラーをダウンロードします。

      たとえば、Windows の場合、Windows インストーラー（.msi）をダウンロードします。macOS の場合、macOS インストーラー（.pkg）をダウンロードします。

2. 以下のコマンドを実行して OpenClaw をインストールします。

   1. macOS または Linux の場合：

      Command + Space キーを押して「Terminal」と入力し、Enter キーを押します。

      curl -fsSL https://openclaw.ai/install.sh | bash

   2. Windows の場合：

      タスクバーの検索ボックスで PowerShell を入力し、「管理者として実行」を選択します。PowerShell で以下のコマンドを実行します：

      iwr -useb https://openclaw.ai/install.ps1 | iex

3. インストール後、画面上の指示に従って OpenClaw を構成します。参考となる構成設定を以下に示します。

   項目	構成
   この機能は強力ですが、本質的にリスクを伴います。続行しますか？	[はい] を選択します
   オンボーディングモード	[クイックスタート] を選択します
   モデル／認証プロバイダー	当面は [スキップ] を選択します。後から構成できます。
   プロバイダーによるモデルのフィルター	[すべてのプロバイダー] を選択します
   デフォルトモデル	デフォルト設定を使用します
   チャネルの選択（クイックスタート）	当面は [スキップ] を選択します。後から構成できます。
   スキルを今すぐ構成しますか？（推奨）	[いいえ] を選択します。後から構成できます。
   フックを有効化しますか？	Space キーを押して [スキップ] を選択し、Enter キーを押して続行します。
   ボットをどのように起動しますか？	TUI で [ハッチ] を選択してください。

Qwen Code を使用したインストールのガイド

OpenClaw は Node.js を必要とします。手動インストールでは構成エラーが発生する可能性があります。そのため、Qwen Code を使用して自動的にインストールおよび検証することを推奨します。

1. Qwen Code のインストールおよび構成を行います。

2. ターミナルから Qwen Code を起動します。

   qwen

3. Qwen Code のチャットウィンドウに以下の指示を入力します。

   1. macOS または Linux の場合：

        OpenClaw をインストールし、以下のコマンドを実行して初期セットアップを完了します：
        1. 前提条件：Node.js（v22.0 以降）をインストールします。node --version で確認します。アップグレード時に既存の Node.js をアンインストールしないでください。
        2. curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
        3. openclaw gateway install
        4. openclaw onboard --non-interactive --accept-risk --flow quickstart --auth-choice skip --skip-channels --skip-skills
        5. openclaw status を実行して、OpenClaw が正常に動作していることを確認します

   2. Windows の場合：

      Windows での OpenClaw のインストール手順：
      
      ## 実行指示
      
      すべての PowerShell コマンドは以下の形式で実行します：
      ```
      powershell -ExecutionPolicy Bypass -Command "<command>"
      ```
      
      ### 注意事項：
      1. 複数行のファイルを作成するには `write_file` ツールを使用します。ヒアストリング構文は使用しないでください。
      2. 環境変数を変更した後は、同じセッション内でその変数を使用するために `$env:Path` を明示的にリフレッシュします。
      3. ネットワーク経由のダウンロードコマンドには長めのタイムアウト（≥120000 ms）を設定します。
      
      ---
      
      ## ステップ 1：前提条件の確認
      
      以下のツールがインストール済みであり、そのバージョンが表示されることを確認します：
      - `node --version`（v22 以降が必要）
      - `npm --version`
      - `git --version`
      
      すべてがインストール済みで、Node.js のバージョンが v22 以上であれば、ステップ 4 に進んでください。
      
      ---
      
      ## ステップ 2：Node.js のインストール（未インストールまたは古い場合）
      
      1. システムアーキテクチャー（x64 / x86 / ARM64）を検出します。
      2. 公式ソースから Node.js の zip をダウンロードおよび展開します：
      ```
      powershell -ExecutionPolicy Bypass -Command "$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://nodejs.org/dist/v24.0.0/node-v24.0.0-win-x64.zip' -OutFile \"$env:TEMP\node24.zip\"; Expand-Archive \"$env:TEMP\node24.zip\" -DestinationPath \"$env:LOCALAPPDATA\nodejs-v24\" -Force; Remove-Item \"$env:TEMP\node24.zip\""
      ```
      3. システム PATH に追加します（新しいターミナルでも利用可能）：
      ```
      powershell -ExecutionPolicy Bypass -Command "$nodePath = \"$env:LOCALAPPDATA\nodejs-v24\node-v24.0.0-win-x64\"; $machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); [Environment]::SetEnvironmentVariable('PATH', \"$nodePath;$machinePath\", 'Machine'); $env:Path = \"$nodePath;$env:Path\"; node --version; npm --version"
      ```
      
      ---
      
      ## ステップ 3：Git のインストール（未インストールの場合）
      
      1. 公式ソースから Git をダウンロードおよびサイレントインストールします：
      ```
      powershell -ExecutionPolicy Bypass -Command "$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.2/Git-2.53.0.2-64-bit.exe' -OutFile \"$env:TEMP\Git-Installer.exe\"; Start-Process -FilePath \"$env:TEMP\Git-Installer.exe\" -ArgumentList '/VERYSILENT','/NORESTART','/NOCANCEL','/SP-','/CLOSEAPPLICATIONS','/RESTARTAPPLICATIONS','/COMPONENTS=icons,ext\reg\shellhere,assoc,assoc_sh' -Wait; Remove-Item \"$env:TEMP\Git-Installer.exe\""
      ```
      2. PATH をリフレッシュして確認します：
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $env:Path = \"$machinePath;$env:Path\"; git --version"
      ```
      
      ---
      
      ## ステップ 4：OpenClaw のインストール
      
      PATH をリフレッシュしてグローバルにインストールします：
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User'); $env:Path = \"$machinePath;$userPath;$env:Path\"; npm install -g openclaw@latest"
      ```
      
      ---
      
      ## ステップ 5：インストールの検証
      
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User'); $env:Path = \"$machinePath;$userPath;$env:Path\"; openclaw --version"
      ```
      
      ---
      
      ## ステップ 6：ゲートウェイのインストール
      
      ```
      openclaw gateway install
      ```
      
      ---
      
      ## ステップ 7：初期セットアップの自動完了
      
      `write_file` ツールを使用して設定ファイルを作成し、すべての設定（クイックスタートモード）を自動的に完了します：
      
      設定ファイルのパス：`%USERPROFILE%\.openclaw\config.yaml`
      
      設定ファイルの内容：
      ```yaml
      # OpenClaw 構成 — クイックスタートモード
      
      workspace:
        name: default
        directory: .
      
      gateway:
        mode: local
        auth:
          token: openclaw-quickstart-token
      
      session:
        scope: personal
        dmScope: per-channel
      
      channels:
        - type: tui
          enabled: true
      
      skills:
        enabled: false
      
      hooks:
        enabled: false
      
      security:
        acknowledged: true
        mode: personal
      
      ui:
        hatch: tui
      ```
      
      ファイル作成後に以下のコマンドを実行します：
      ```
      powershell -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('OPENCLAW_GATEWAY_TOKEN', 'openclaw-quickstart-token', 'User')"
      ```
      
      ---
      
      ## ステップ 8：起動および利用
      
      ```
      # TUI インターフェイスを起動
      openclaw tui
      
      # またはステータスを確認
      openclaw status
      
      # ダッシュボード（ブラウザーで表示）
      # http://127.0.0.1:18789/
      ```

4. インストールが完了するまで、Qwen Code がコマンドを実行できるように許可します。

5. Qwen Code を終了するには、/exit を入力します。

   /exit

方法 1：Qwen Code のガイダンスによる構成

1. Qwen Code のインストールおよび構成を行います。

2. ターミナルから Qwen Code を起動します。

   qwen

3. Qwen Code のチャットウィンドウに以下の指示を入力します。

   Coding Plan への接続用に OpenClaw を構成します：
   
   ## ステップ 1：API キーの取得
   ユーザーに次のメッセージを送信します：「Coding Plan の API キーを入力してください」。
   ユーザーからの返答を待ってから次に進みます。
   
   ## ステップ 2：設定ファイルの編集
   1. 設定ファイルを開きます：`~/.openclaw/openclaw.json`
      - ファイルが存在しない場合は新規作成します。
      - 重要：JSON 形式のみを使用します。
   
   2. 次のフィールドを検索または作成し、構成をマージします（既存の設定は保持します。不足しているフィールドは追加します）：
      - 「mode」を「merge」に設定して、既存の設定を上書きしないようにします。
      - 「YOUR_API_KEY」をユーザーの実際の API キーに置き換えます。
   {
     "models": {
       "mode": "merge",
       "providers": {
         "bailian": {
           "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
           "apiKey": "YOUR_API_KEY",
           "api": "openai-completions",
           "models": [
             {
               "id": "qwen3.5-plus",
               "name": "qwen3.5-plus",
               "reasoning": false,
               "input": ["text", "image"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 1000000,
               "maxTokens": 65536,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "qwen3-max-2026-01-23",
               "name": "qwen3-max-2026-01-23",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 262144,
               "maxTokens": 65536,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "qwen3-coder-next",
               "name": "qwen3-coder-next",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 262144,
               "maxTokens": 65536
             },
             {
               "id": "qwen3-coder-plus",
               "name": "qwen3-coder-plus",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 1000000,
               "maxTokens": 65536
             },
             {
               "id": "MiniMax-M2.5",
               "name": "MiniMax-M2.5",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 196608,
               "maxTokens": 32768
             },
             {
               "id": "glm-5",
               "name": "glm-5",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 202752,
               "maxTokens": 16384,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "glm-4.7",
               "name": "glm-4.7",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 202752,
               "maxTokens": 16384,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "kimi-k2.5",
               "name": "kimi-k2.5",
               "reasoning": false,
               "input": ["text", "image"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 262144,
               "maxTokens": 32768,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             }
           ]
         }
       }
     },
     "agents": {
       "defaults": {
         "model": {
           "primary": "bailian/qwen3.5-plus"
         },
         "models": {
           "bailian/qwen3.5-plus": {},
           "bailian/qwen3-max-2026-01-23": {},
           "bailian/qwen3-coder-next": {},
           "bailian/qwen3-coder-plus": {},
           "bailian/MiniMax-M2.5": {},
           "bailian/glm-5": {},
           "bailian/glm-4.7": {},
           "bailian/kimi-k2.5": {}
         }
       }
     },
     "gateway": {
       "mode": "local"
     }
   } 
   3. ファイルを保存します。
   
   ## ステップ 3：再起動および検証
   1. `openclaw gateway restart` を実行してゲートウェイを再起動し、変更を適用します。
   2. `openclaw models list` を実行して構成を検証します：
      - 出力に「bailian/」で始まるモデルが含まれていることを確認します。
      - 各モデルに「configured」ラベルが表示されていることを確認します。
      - エラーメッセージに基づいてエラーを修正します。

4. 構成が完了するまで、Qwen Code がコマンドを実行できるように許可します。

5. 構成が完了すると、Qwen Code は openclaw models list コマンドの出力を表示します。bailian/qwen3.5-plus などのモデルのステータスが `構成済み` と表示された場合、構成は成功しています。

方法 2：GUI を使用した構成

OpenClaw を Simple Application Server を使用してデプロイした場合、GUI を使用して Coding Plan を構成できます。詳細については、「Simple Application Server における Coding Plan の構成」をご参照ください。

方法 3：設定ファイルの直接編集

Web ブラウザー

1. 新しいターミナルを開き、OpenClaw のダッシュボードを起動します。

   openclaw dashboard

2. 会話を開始します。

   

ターミナルコマンドライン

1. 新しいターミナルを開き、以下のコマンドを実行します。

   openclaw tui

2. 会話を開始します。