Ansible

​

前提条件

​

提供されるもの

• ファイアウォール優先のセキュリティ：UFW + Docker 分離（SSH + Tailscale のみに到達可能）
• サービスを公開せずにリモートアクセスできる Tailscale VPN
• localhost のみにバインドされた分離サンドボックスコンテナ用の Docker
• セキュリティ強化と起動時の自動開始を備えた systemd 統合
• 1 コマンドでのセットアップ

​

クイックスタート

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

​

インストールされるもの

1. Tailscale（安全なリモートアクセス用のメッシュ VPN）
2. UFW ファイアウォール（SSH + Tailscale ポートのみ）
3. Docker CE + Compose V2（デフォルトのエージェントサンドボックスバックエンド）
4. Node.js と pnpm（OpenClaw には Node 22.22.3+、24.15+、または 25.9+ が必要です。Node 24 を推奨します）
5. コンテナ化せず、ホストベースでインストールされる OpenClaw
6. セキュリティ強化を施した systemd サービス

​

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

sudo -i -u openclaw

openclaw channels login --channel <name>

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

​

クイックコマンド

# サービスの状態を確認
sudo systemctl status openclaw

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

# Gateway を再起動
sudo systemctl restart openclaw

# チャネルにログイン（openclaw ユーザーとして実行）
sudo -i -u openclaw
openclaw channels login --channel <name>

​

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

1. ファイアウォール（UFW）：SSH（22）と Tailscale（41641/udp）のみを公開
2. VPN（Tailscale）：Gateway には VPN メッシュ経由でのみ到達可能
3. Docker 分離：DOCKER-USER iptables チェーンによって外部へのポート公開を防止
4. systemd のセキュリティ強化：NoNewPrivileges、PrivateTmp、非特権ユーザー

nmap -p- YOUR_SERVER_IP

​

手動インストール

sudo apt update && sudo apt install -y ansible git

git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

ansible-galaxy collection install -r requirements.yml

./run-playbook.sh

ansible-playbook playbook.yml --ask-become-pass
# 次に実行：/tmp/openclaw-setup.sh

​

更新

cd openclaw-ansible
./run-playbook.sh

​

トラブルシューティング

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

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

# 手動起動をテスト
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

# Docker が実行中であることを確認
sudo systemctl status docker

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

# イメージがない場合はサンドボックスイメージをビルド（ソースチェックアウトが必要）
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# ソースチェックアウトなしで npm インストールを使用する場合は、以下を参照
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

sudo -i -u openclaw
openclaw channels login --channel <name>

​

高度な設定

• セキュリティアーキテクチャ
• 技術詳細
• トラブルシューティングガイド

​

関連項目

• openclaw-ansible：完全なデプロイガイド
• Docker：コンテナ化された Gateway のセットアップ
• サンドボックス化：エージェントサンドボックスの設定
• マルチエージェントのサンドボックスとツール：エージェント単位の分離