ホーム チュートリアル カテゴリ Skills サイトについて
ZH EN JA KO
インストール

OpenClawクロスプラットフォームデプロイガイド:デスクトップからクラウドサーバーまで

· 9 分で読了

OpenClaw は TypeScript で構築され、Node.js 上で動作するため、本質的にクロスプラットフォーム対応です。macOS、Linux、Windowsのいずれを使用していても、ローカルデスクトップでもクラウドサーバーでも、対応するデプロイ方法があります。本記事では各プラットフォームのインストール方法とクラウドホスティングオプションを体系的に整理し、最適なデプロイパスを見つける手助けをします。

技術基盤

OpenClaw のコアであるGateway(ゲートウェイサービス)は TypeScript で書かれ、Node.js ランタイムに依存しています。つまり、Node.js を実行できる環境であれば、理論的には OpenClaw をデプロイできます。

特に注意すべき点があります。Bun を使用して Gateway を実行しないでください。Bun は大部分の Node.js API と互換性がありますが、WhatsApp や Telegram の接続処理に既知のバグがあり、メッセージの送受信に異常が発生します。必ず公式の Node.js ランタイムを使用してください。

サポートされるクライアントプラットフォーム

コアの Gateway サービスに加えて、OpenClaw はさまざまなデバイスでの管理と監視を便利にするマルチプラットフォームのコンパニオンアプリも提供しています。

プラットフォーム ステータス 説明
macOS リリース済み メニューバー常駐ツール、状態確認とサービス管理が素早く可能
iOS リリース済み モバイル管理、いつでもどこでもメッセージと設定を確認
Android リリース済み iOS同様、プッシュ通知をサポート
Windows 開発中 デスクトップクライアント、近日リリース予定
Linux 開発中 デスクトップクライアント、近日リリース予定

明確にしておくべき点として、コンパニオンアプリは Gateway の管理・監視用であり、メッセージを処理するコアサービスである Gateway 自体は別途デプロイして常時稼働させる必要があります。

Gatewayのインストール方法

OpenClaw は、シンプルなものから柔軟なものまで、4つのインストール方法を提供しています。

方法1:ワンクリックインストールスクリプト(推奨)

公式がインタラクティブなインストールウィザードを提供しており、環境検出、依存関係のインストール、基本設定を自動的に完了します。

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

これは最も推奨される方法で、ほとんどのユーザーに適しています。スクリプトがNode.jsバージョンチェック、Gatewayのインストール、初期化設定を案内します。

方法2:npmグローバルインストール

すでにNode.js環境がある場合は、npmから直接インストールできます。

npm install -g openclaw@latest

インストール完了後、ターミナルで openclaw コマンドが見つからない場合は、npmグローバルインストールパスがシステムPATHに含まれているか確認してください。

npm prefix -g

出力されたパスの bin ディレクトリを PATH 環境変数に追加してください。

方法3:ソースコードからビルド

カスタマイズや開発に参加したいユーザー向け:

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

pnpmを使用する場合は、ビルドスクリプトを許可する追加コマンドが必要です。

pnpm approve-builds -g

方法4:Gatewayを直接インストール

Gatewayコアコンポーネントのみが必要で、完全なツールチェーンが不要な場合は、Gatewayパッケージを個別にインストールすることもできます。具体的なパッケージ名と方法は公式ドキュメントを参照してください。

インストール後の初期化

どのインストール方法を使用しても、完了後に以下の3つの手順を実行することをお勧めします。

# 1. ガイドプログラムを実行し、初期設定を完了してデーモンをインストール
openclaw onboard --install-daemon

# 2. 環境が正常か確認
openclaw doctor

# 3. 管理パネルを開く
openclaw dashboard

openclaw doctor はNode.jsバージョン、ネットワーク接続、設定ファイルなどの重要な項目を検出し、問題を素早く特定するのに役立ちます。

各OSのデプロイポイント

macOS

macOSはOpenClawのファーストクラスプラットフォームです。Gatewayをインストール後、LaunchAgentでスタートアップ時の自動起動とバックグラウンド実行を実現できます。openclaw onboard --install-daemon が対応するLaunchAgent設定ファイルを自動作成するので、plistを手動で記述する必要はありません。

Linux

Linuxサーバーは本番環境デプロイの最優先選択肢です。systemd user servicesを使用してGatewayプロセスを管理し、自動再起動とログ管理を実現することをお勧めします。同様に、openclaw onboard --install-daemon がsystemdサービスファイルを自動生成します。

サービス作成後、以下のコマンドで管理できます。

systemctl --user start openclaw
systemctl --user enable openclaw
systemctl --user status openclaw

Windows

WindowsユーザーにはWSL2(Windows Subsystem for Linux 2)を使用してGatewayを実行することを推奨します。WSL2は完全なLinuxカーネル環境を提供し、ネイティブWindows上で発生する可能性のある互換性問題を回避します。

# WSL2内でインストール
wsl
curl -fsSL https://openclaw.ai/install.sh | bash

WSL2内のGatewayも同様にsystemdで管理できます(WSL2のsystemdサポートを有効にする必要があります)。

クラウドホスティング方式

Gatewayを24時間365日安定して稼働させたい場合は、クラウドへのデプロイがより良い選択です。以下はコミュニティで検証済みのホスティング方式です。

方式 特徴 適したシナリオ
VPS(Vultr、DigitalOceanなど) 完全なコントロール、柔軟な設定 運用経験のあるユーザー
Fly.io コンテナ化デプロイ、グローバルノード 低レイテンシを追求するユーザー
Hetzner + Docker コストパフォーマンスの高いヨーロッパデータセンター 予算を重視するユーザー
Google Cloud Compute Engine エンタープライズ級インフラ 高可用性が必要なチーム
exe.dev VM提供+HTTPSプロキシ内蔵 素早い立ち上げを希望するユーザー

中でもVPSは最も汎用的な方式です。サーバーの完全な制御権を持ち、必要に応じて環境を設定できます。最低1コア2GBメモリでOpenClaw Gatewayをスムーズに実行できます。

デプロイに関するアドバイス

シナリオに応じた実用的なアドバイスをいくつか紹介します。

  • お試し利用:ローカルのmacOSまたはLinuxマシンでワンクリックスクリプトを使ってインストールすれば、数分で体験できます。
  • 長期利用:VPSまたはFly.ioを選択し、systemdまたはコンテナオーケストレーションと組み合わせて、サービスが常時オンラインになるようにしましょう。
  • マルチプラットフォーム管理:Gatewayをデプロイした後、スマートフォンにiOS/Androidコンパニオンアプリをインストールして、いつでも稼働状態を確認できます。
  • Windowsユーザー:ネイティブWindows上でGatewayを直接実行せず、WSL2を使用すれば多くの互換性問題を回避できます。
  • Bunを避ける:どのプラットフォームでも、GatewayはBunではなくNode.jsで実行してください。

OpenClawのクロスプラットフォーム特性により、ニーズに応じて柔軟にデプロイ方法を選択できます。Raspberry Piからクラウドサーバーまで、個人のノートPCからエンタープライズ級クラスターまで、必ず適した方法があります。

OpenClawは無料のオープンソースAIアシスタント。WhatsApp、Telegram、Discordなど多数のプラットフォームに対応