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 を使用します。詳細はサンドボックス化を参照してください。詳細は Sandboxing を参照してください。

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

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

sudo -i -u openclaw

インストール後スクリプトでは、以下が案内されます。

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

クイックコマンド¶

# Check service status
sudo systemctl status openclaw

# View live logs
sudo journalctl -u openclaw -f

# Restart gateway
sudo systemctl restart openclaw

# Provider login (run as openclaw user)
sudo -i -u openclaw
openclaw channels login

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

4 層防御¶

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

検証¶

外部からの攻撃対象領域をテストします。

nmap -p- YOUR_SERVER_IP

ポート 22（SSH）のみが開いていることが表示されるはずです。その他のすべてのサービス（ゲートウェイ、Docker）はロックダウンされています。他のすべてのサービス (ゲートウェイ、Docker) はロックダウンされています。

Docker の利用範囲¶

Docker は エージェントのサンドボックス（分離されたツール実行）のためにインストールされます。ゲートウェイ自体の実行には使用されません。ゲートウェイは localhost のみにバインドされ、Tailscale VPN 経由でアクセスされます。このゲートウェイは、localhostにのみバインドされ、Tailscale VPN経由でアクセスできます。

サンドボックスの設定については、マルチエージェントサンドボックス & ツールを参照してください。

手動インストール¶

自動化ではなく手動での制御を希望する場合は、以下を使用してください。

# 1. Install prerequisites
sudo apt update && sudo apt install -y ansible git

# 2. Clone repository
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

# 3. Install Ansible collections
ansible-galaxy collection install -r requirements.yml

# 4. Run playbook
./run-playbook.sh

# Or run directly (then manually execute /tmp/openclaw-setup.sh after)
# ansible-playbook playbook.yml --ask-become-pass

OpenClaw の更新¶

Ansible インストーラーは、OpenClaw を手動更新できるようにセットアップします。標準的な更新手順については更新を参照してください。標準の更新フローについては、 Updating を参照してください。

Ansible プレイブックを再実行する場合（例: 設定変更時）は、以下を実行します。

cd openclaw-ansible
./run-playbook.sh

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

トラブルシューティング¶

ファイアウォールにより接続がブロックされる¶

ロックアウトされた場合は、以下を確認してください。

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

サービスが起動しない¶

# Check logs
sudo journalctl -u openclaw -n 100

# Verify permissions
sudo ls -la /opt/openclaw

# Test manual start
sudo -i -u openclaw
cd ~/openclaw
pnpm start

Docker サンドボックスの問題¶

# Verify Docker is running
sudo systemctl status docker

# Check sandbox image
sudo docker images | grep openclaw-sandbox

# Build sandbox image if missing
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

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

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

sudo -i -u openclaw
openclaw channels login

高度な設定¶

詳細なセキュリティアーキテクチャおよびトラブルシューティングについては、以下を参照してください。

Install overview

Other install methods

Maintenance

Hosting and deployment

Advanced

Ansible