OpenClawワンクリックデプロイスクリプト使用ガイド

はじめに

素早く使い始めたいユーザー向けに、OpenClaw はワンクリックデプロイスクリプトを提供しています。1つのコマンドだけで、環境検出からサービス起動までの全プロセスを完了できます。本記事では、ワンクリックデプロイスクリプトの使用方法、カスタマイズオプション、VPS での cloud-init を使った全自動デプロイについて解説します。

ワンクリックインストールコマンド

ターミナルで以下のコマンドを実行するとインストールが開始されます。

curl -fsSL https://get.openclaw.com | bash

または wget を使用する場合：

wget -qO- https://get.openclaw.com | bash

インストールスクリプトは以下のステップを自動的に完了します。

OSとアーキテクチャの検出
Node.js 22 の確認とインストール（未インストールの場合）
npm によるグローバルインストール
openclaw onboard による初期設定の実行
OpenClaw サービスの起動

スクリプトがサポートするOS

OS	アーキテクチャ	サポート状態
Ubuntu 20.04+	x86_64, arm64	完全サポート
Debian 11+	x86_64, arm64	完全サポート
CentOS 8+ / RHEL 8+	x86_64, arm64	完全サポート
Fedora 38+	x86_64, arm64	完全サポート
macOS 13+	x86_64, arm64	完全サポート
Alpine 3.18+	x86_64, arm64	基本サポート
Arch Linux	x86_64	基本サポート

カスタムインストールオプション

インストールスクリプトは環境変数による動作のカスタマイズに対応しています。

バージョン指定

curl -fsSL https://get.openclaw.com | OPENCLAW_VERSION=2.5.0 bash

インストールディレクトリの指定

curl -fsSL https://get.openclaw.com | OPENCLAW_PREFIX=/opt/openclaw bash

Node.jsインストールのスキップ

Node.js 22+ が既にインストールされている場合：

curl -fsSL https://get.openclaw.com | SKIP_NODE_INSTALL=1 bash

初期設定ウィザードのスキップ

インストール後に openclaw onboard を実行しない場合：

curl -fsSL https://get.openclaw.com | SKIP_ONBOARD=1 bash

Dockerでのインストール

curl -fsSL https://get.openclaw.com | INSTALL_METHOD=docker bash

複数オプションの組み合わせ

curl -fsSL https://get.openclaw.com | \
  OPENCLAW_VERSION=latest \
  SKIP_ONBOARD=1 \
  INSTALL_METHOD=npm \
  bash

インストールオプション一覧

環境変数	デフォルト値	説明
`OPENCLAW_VERSION`	`latest`	インストールバージョンの指定
`OPENCLAW_PREFIX`	システムデフォルト	カスタムインストールプレフィックスパス
`INSTALL_METHOD`	`npm`	インストール方法：`npm` または `docker`
`SKIP_NODE_INSTALL`	`0`	`1` に設定するとNode.jsインストールをスキップ
`SKIP_ONBOARD`	`0`	`1` に設定すると初期設定ウィザードをスキップ
`GATEWAY_PORT`	`18789`	カスタムゲートウェイポート
`AUTO_START`	`1`	`0` に設定するとサービスを自動起動しない
`SETUP_SYSTEMD`	`1`	`0` に設定すると systemd の設定をしない
`NPM_REGISTRY`	公式ソース	カスタムnpmミラーソース

無人インストール

無人インストールは、大量デプロイが必要なシナリオに適しています。すべてのパラメータを事前に設定することで、対話的な入力を回避します。

設定ファイルの準備

あらかじめ openclaw.json5 設定ファイルを作成します。

{
  gateway: {
    port: 18789,
    host: "0.0.0.0",
  },
  models: {
    default: "claude",
    providers: {
      claude: {
        apiKey: "sk-ant-your-api-key-here",
        model: "claude-sonnet-4-20250514",
      },
    },
  },
  channels: {
    telegram: {
      enabled: true,
      token: "your-telegram-bot-token",
    },
  },
  logging: {
    level: "info",
  },
}

一行コマンドで無人インストールを完了

# OpenClawをダウンロードしてインストール、ウィザードをスキップ
curl -fsSL https://get.openclaw.com | SKIP_ONBOARD=1 bash

# 事前設定した設定ファイルをコピー
mkdir -p ~/.config/openclaw
curl -fsSL https://your-server.com/openclaw.json5 > ~/.config/openclaw/openclaw.json5

# 起動
openclaw up

または1つのスクリプトにまとめます。

curl -fsSL https://get.openclaw.com | SKIP_ONBOARD=1 AUTO_START=0 bash && \
mkdir -p ~/.config/openclaw && \
curl -fsSL https://your-server.com/openclaw.json5 > ~/.config/openclaw/openclaw.json5 && \
openclaw up

VPSデプロイ：cloud-initの使用

cloud-init は主要なクラウドプロバイダがサポートする自動初期化ツールです。VPS 作成時に cloud-init 設定で OpenClaw の自動デプロイが可能です。

基本的なcloud-init設定

VPS インスタンス作成時に、「ユーザーデータ」または「cloud-init」フィールドに以下を入力します。

#cloud-config

package_update: true
package_upgrade: true

packages:
  - curl
  - git

runcmd:
  # OpenClawをインストール
  - curl -fsSL https://get.openclaw.com | SKIP_ONBOARD=1 SETUP_SYSTEMD=1 bash

  # 設定ファイルをデプロイ
  - mkdir -p /root/.config/openclaw
  - |
    cat > /root/.config/openclaw/openclaw.json5 << 'CONF'
    {
      gateway: {
        port: 18789,
        host: "0.0.0.0",
      },
      models: {
        default: "claude",
        providers: {
          claude: {
            apiKey: "sk-ant-your-api-key-here",
            model: "claude-sonnet-4-20250514",
          },
        },
      },
      logging: {
        level: "info",
      },
    }
    CONF

  # サービスを起動
  - systemctl start openclaw
  - systemctl enable openclaw

  # ファイアウォールを設定
  - ufw allow 18789/tcp
  - ufw --force enable

final_message: "OpenClaw デプロイ完了！http://$_IP:18789/dashboard にアクセスしてください"

各クラウドプラットフォームでのcloud-initの使い方

Alibaba Cloud ECS：

インスタンス作成時に「詳細オプション」で「インスタンスカスタムデータ」を見つける
上記の cloud-init 設定を貼り付け

Tencent Cloud CVM：

インスタンス作成時に「詳細設定」で「カスタムデータ」を見つける
cloud-init 設定を貼り付け

AWS EC2：

インスタンス作成時に「詳細情報」を展開
「ユーザーデータ」に設定を貼り付け

DigitalOcean：

Droplet 作成時に「Advanced Options」を展開
「Add user data」にチェック
設定を貼り付け

セキュリティ強化版cloud-init

以下は、本番環境向けの推奨完全 cloud-init 設定です。

#cloud-config

package_update: true
package_upgrade: true

# 専用ユーザーを作成
users:
  - name: openclaw
    shell: /bin/bash
    groups: [sudo]
    sudo: ['ALL=(ALL) NOPASSWD:ALL']
    ssh_authorized_keys:
      - ssh-rsa YOUR_PUBLIC_KEY_HERE

packages:
  - curl
  - git
  - fail2ban
  - ufw

write_files:
  - path: /home/openclaw/.config/openclaw/openclaw.json5
    owner: openclaw:openclaw
    permissions: '0600'
    content: |
      {
        gateway: {
          port: 18789,
          host: "0.0.0.0",
        },
        models: {
          default: "claude",
          providers: {
            claude: {
              apiKey: "sk-ant-your-api-key-here",
              model: "claude-sonnet-4-20250514",
            },
          },
        },
        logging: {
          level: "warn",
        },
      }

runcmd:
  # openclawユーザーとしてインストール
  - su - openclaw -c 'curl -fsSL https://get.openclaw.com | SKIP_ONBOARD=1 AUTO_START=0 bash'

  # systemdサービスを設定
  - |
    cat > /etc/systemd/system/openclaw.service << 'SVC'
    [Unit]
    Description=OpenClaw AI Assistant
    After=network-online.target
    [Service]
    Type=simple
    User=openclaw
    ExecStart=/home/openclaw/.npm-global/bin/openclaw up
    Restart=always
    RestartSec=10
    [Install]
    WantedBy=multi-user.target
    SVC

  - systemctl daemon-reload
  - systemctl enable openclaw
  - systemctl start openclaw

  # ファイアウォール設定
  - ufw default deny incoming
  - ufw default allow outgoing
  - ufw allow ssh
  - ufw allow 18789/tcp
  - ufw --force enable

  # fail2banを起動
  - systemctl enable fail2ban
  - systemctl start fail2ban

インストールスクリプトの仕組み

ワンクリックデプロイスクリプトのワークフローは以下の通りです。

開始
  ├─ OSとアーキテクチャを検出
  ├─ パッケージマネージャーを検出 (apt/yum/brew)
  ├─ Node.jsバージョンを確認
  │   ├─ 未インストール → Node.js 22をインストール
  │   ├─ バージョンが低い → Node.jsをアップグレード
  │   └─ バージョンが適合 → スキップ
  ├─ インストール方法を選択
  │   ├─ npm → npm install -g openclaw
  │   └─ docker → docker pull openclaw/openclaw
  ├─ openclaw onboardを実行（スキップ可能）
  ├─ systemd/launchd自動起動を設定（スキップ可能）
  └─ OpenClawを起動

オフラインインストール

ネットワークのない環境では、あらかじめインストールパッケージを用意できます。

ネットワーク接続のあるマシンでパッケージング

# OpenClawとその依存関係をダウンロード
mkdir openclaw-offline
cd openclaw-offline
npm pack openclaw@latest
npm cache ls openclaw 2>/dev/null

# Node.jsバイナリをパッケージング
curl -O https://nodejs.org/dist/v22.x.x/node-v22.x.x-linux-x64.tar.xz

ターゲットマシンでインストール

# Node.jsを展開
tar -xJf node-v22.x.x-linux-x64.tar.xz -C /usr/local --strip-components=1

# OpenClawをインストール
npm install -g openclaw-*.tgz

トラブルシューティング

問題	解決方法
curl コマンドが利用できない	`apt install curl` または `yum install curl`
権限不足	`sudo` を使用するか root ユーザーで実行
Node.js のインストールに失敗	手動で Node.js 22 をインストール後、`SKIP_NODE_INSTALL=1` を使用
ネットワークタイムアウト	`NPM_REGISTRY` で国内ミラーを設定
cloud-init が実行されない	`/var/log/cloud-init-output.log` を確認

まとめ

ワンクリックデプロイスクリプトにより、OpenClaw のインストールの敷居が大幅に下がりました。個人の素早い試用から企業の大量デプロイまで対応できます。本番環境では、セキュリティ強化設定と cloud-init を組み合わせて、ゼロからの全自動デプロイを実現することをお勧めします。インストール完了後は、openclaw doctor を実行してすべてのコンポーネントが正常に動作していることを確認してください。