その他のインストール方法

Ansible

本番サーバーにOpenClawをデプロイする推奨方法は、openclaw-ansible による自動インストーラーです。これはセキュリティファーストのアーキテクチャを備えています。

クイックスタート

ワンコマンドインストール:

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

📦 完全ガイド: github.com/openclaw/openclaw-ansible openclaw-ansibleリポジトリがAnsibleデプロイメントの信頼できる情報源です。このページは概要です。

得られるもの

🔒 ファイアウォールファーストのセキュリティ: UFW + Docker分離 (SSH + Tailscaleのみアクセス可能)
🔐 Tailscale VPN: サービスを公開せずに安全なリモートアクセスを実現
🐳 Docker: 分離されたサンドボックスコンテナ、localhostのみバインド
🛡️ 多層防御: 4層のセキュリティアーキテクチャ
🚀 ワンコマンドセットアップ: 数分で完全なデプロイメント
🔧 Systemd統合: セキュリティ強化を施した自動起動

要件

OS: Debian 11+ または Ubuntu 20.04+
アクセス: rootまたはsudo権限
ネットワーク: パッケージインストールのためのインターネット接続
Ansible: 2.14+ (クイックスタートスクリプトにより自動インストール)

インストールされるもの

Ansibleプレイブックは以下をインストール・設定します:

Tailscale (安全なリモートアクセスのためのメッシュVPN)
UFWファイアウォール (SSH + Tailscaleポートのみ許可)
Docker CE + Compose V2 (エージェントサンドボックス用)
Node.js 22.x + pnpm (ランタイム依存関係)
OpenClaw (ホストベース、コンテナ化されていない)
Systemdサービス (セキュリティ強化を施した自動起動)

注: ゲートウェイは ホスト上で直接実行 されます (Docker内ではありません) が、エージェントサンドボックスは分離のためにDockerを使用します。詳細はサンドボックス化を参照してください。

インストール後のセットアップ

インストール完了後、openclawユーザーに切り替えます:

sudo -i -u openclaw

インストール後スクリプトが以下を案内します:

オンボーディングウィザード: OpenClaw設定の構成
プロバイダーログイン: WhatsApp/Telegram/Discord/Signalへの接続
ゲートウェイテスト: インストールの検証
Tailscaleセットアップ: VPNメッシュへの接続

クイックコマンド

# サービスステータスの確認
sudo systemctl status openclaw

# ライブログの表示
sudo journalctl -u openclaw -f

# ゲートウェイの再起動
sudo systemctl restart openclaw

# プロバイダーログイン (openclawユーザーとして実行)
sudo -i -u openclaw
openclaw channels login

セキュリティアーキテクチャ

4層防御

ファイアウォール (UFW): SSH (22) + Tailscale (41641/udp) のみ公開
VPN (Tailscale): ゲートウェイはVPNメッシュ経由でのみアクセス可能
Docker分離: DOCKER-USER iptablesチェーンにより外部ポート公開を防止
Systemd強化: NoNewPrivileges, PrivateTmp, 非特権ユーザー

検証

外部からの攻撃対象領域をテスト:

nmap -p- YOUR_SERVER_IP

ポート22 (SSH) のみ が開いていることを確認してください。他のすべてのサービス (ゲートウェイ、Docker) はロックダウンされています。

Dockerの可用性

Dockerは エージェントサンドボックス (分離されたツール実行) のためにインストールされ、ゲートウェイ自体の実行には使用されません。ゲートウェイはlocalhostのみにバインドされ、Tailscale VPN経由でアクセス可能です。サンドボックス設定についてはマルチエージェントサンドボックス & ツールを参照してください。

手動インストール

自動化よりも手動制御を希望する場合:

# 1. 前提条件のインストール
sudo apt update && sudo apt install -y ansible git

# 2. リポジトリのクローン
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

# 3. Ansibleコレクションのインストール
ansible-galaxy collection install -r requirements.yml

# 4. プレイブックの実行
./run-playbook.sh

# または直接実行 (その後、手動で /tmp/openclaw-setup.sh を実行)
# ansible-playbook playbook.yml --ask-become-pass

OpenClawの更新

Ansibleインストーラーは、手動更新用にOpenClawをセットアップします。標準的な更新フローについては更新を参照してください。Ansibleプレイブックを再実行する場合 (例: 設定変更のため):

cd openclaw-ansible
./run-playbook.sh

注: これは冪等性があり、複数回実行しても安全です。

トラブルシューティング

ファイアウォールが接続をブロックする

アクセスできない場合:

まずTailscale VPN経由でアクセスできることを確認してください
SSHアクセス (ポート22) は常に許可されています
ゲートウェイは設計上、Tailscale経由でのみ アクセス可能です

サービスが起動しない

# ログの確認
sudo journalctl -u openclaw -n 100

# 権限の確認
sudo ls -la /opt/openclaw

# 手動起動のテスト
sudo -i -u openclaw
cd ~/openclaw
pnpm start

Dockerサンドボックスの問題

# Dockerが実行中か確認
sudo systemctl status docker

# サンドボックスイメージの確認
sudo docker images | grep openclaw-sandbox

# サンドボックスイメージが欠落している場合のビルド
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

プロバイダーログインが失敗する

openclaw ユーザーとして実行していることを確認してください:

sudo -i -u openclaw
openclaw channels login

高度な設定

詳細なセキュリティアーキテクチャとトラブルシューティングについては: