​

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 以上（クイックスタートスクリプトにより自動インストール）

​

インストールされる内容

1. Tailscale（安全なリモートアクセスのためのメッシュ VPN）
2. UFW ファイアウォール（SSH + Tailscale ポートのみ）
3. Docker CE + Compose V2（エージェントのサンドボックス用）
4. Node.js 22.x + pnpm（ランタイム依存関係）
5. OpenClaw（ホスト上で実行、コンテナ化しない）
6. Systemd サービス（セキュリティ強化付きの自動起動）

​

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

sudo -i -u openclaw

1. オンボーディングウィザード: OpenClaw の設定
2. プロバイダーログイン: WhatsApp / Telegram / Discord / Signal の接続
3. Gateway テスト: インストールの検証
4. 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 層防御

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

​

Docker の利用範囲

​

手動インストール

# 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 の更新

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

​

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

sudo -i -u openclaw
openclaw channels login

​

高度な設定

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

​

関連

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