OpenClaw Docker完全インストールガイド2026:NAS・VPS・クラウドでAIエージェントをコンテナ運用
この記事について:OpenClawをDockerコンテナとして動かすことで、NAS(QNAP・Synology)・VPS・AWS・GCPなどあらゆる環境に移植可能なAIエージェントを構築できます。本記事では、Dockerfileの設定からdocker-composeによる永続化、Telegram/Discord経由のスマホ操作まで、Dockerを使ったOpenClaw運用の全手順を解説します。環境を選ばずAIエージェントを稼働させたい方に最適なガイドです。
なぜOpenClawをDockerで動かすのか
OpenClawは通常macOS・Windows・Linuxに直接インストールして使いますが、Dockerコンテナ化する最大のメリットは「どんな環境でも同じように動く」という点です。自宅のNAS、借りているVPS、AWSのEC2インスタンス、どこに置いてもまったく同じ設定で動作します。
Docker運用 vs 直接インストール 比較
| 項目 | Docker(推奨) | 直接インストール |
|---|---|---|
| 環境の移植性 | ✅ どこでも動く | △ OS依存あり |
| NASへの対応 | ✅ 完全対応 | ❌ 困難 |
| バージョン管理 | ✅ タグで管理 | △ 手動管理 |
| 複数インスタンス | ✅ 簡単に起動 | ❌ 複雑 |
| 自動再起動 | ✅ restart: always | △ systemd設定必要 |
特にSynologyやQNAPなどのNASユーザーにとって、Dockerは唯一現実的な選択肢です。NASはLinuxカーネルで動いていますが、直接Node.jsをインストールして管理するのは非常に煩雑です。Dockerを使えばNAS上でも数分でOpenClawを起動できます。
事前確認:システム要件
ステップ1:Dockerfileの作成
OpenClaw公式はDockerイメージを直接提供していませんが、Node.js 22ベースのDockerfileを自作することで簡単にコンテナ化できます。以下のDockerfileを作業ディレクトリに保存してください。
# Dockerfile
FROM node:22-slim
# 必要パッケージのインストール
RUN apt-get update && apt-get install -y \
curl \
git \
bash \
ca-certificates \
--no-install-recommends \
&& rm -rf /var/lib/apt/lists/*
# 作業ディレクトリ
WORKDIR /openclaw
# OpenClawをグローバルインストール
RUN npm install -g openclaw@latest
# 設定・データ用のボリュームポイント
VOLUME ["/root/.openclaw"]
# ポート(ダッシュボード用)
EXPOSE 18789
# エントリポイント
CMD ["openclaw", "gateway", "start", "--foreground"]
このDockerfileのポイントは、/root/.openclawをVolumeとしてマウントしている点です。OpenClawの設定ファイル・記憶(soul.md)・スキルなどはすべてこのディレクトリに保存されるため、コンテナを再作成してもデータが失われません。
ステップ2:docker-compose.ymlの設定
docker-composeを使うことで、環境変数・ボリューム・ネットワーク設定を一元管理できます。以下のdocker-compose.ymlファイルを作成してください。
version: '3.9'
services:
openclaw:
build: .
container_name: openclaw-agent
restart: always
environment:
# Claude APIキー(必須)
- ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
# OpenAI APIキー(オプション)
- OPENAI_API_KEY=${OPENAI_API_KEY}
# タイムゾーン
- TZ=Asia/Tokyo
# OpenClawエージェント名
- OPENCLAW_BOT_NAME=MyClawbot
volumes:
# データ永続化(設定・記憶・スキルを保持)
- openclaw-data:/root/.openclaw
ports:
# ダッシュボードをホストに公開
- "18789:18789"
networks:
- openclaw-network
volumes:
openclaw-data:
driver: local
networks:
openclaw-network:
driver: bridge
.envファイルでAPIキーを管理
APIキーは.envファイルに記述してdocker-composeに読み込ませると安全です:
# .env ファイル(git管理対象外にすること)
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxxxxxx
ステップ3:ビルドと起動
# イメージをビルド
docker-compose build
# バックグラウンドで起動
docker-compose up -d
# 起動状況を確認
docker-compose ps
# ログをリアルタイムで確認
docker-compose logs -f openclaw
# コンテナ内に入って初期設定を行う
docker exec -it openclaw-agent openclaw onboard
# ダッシュボードはブラウザで http://localhost:18789/ にアクセス
💡 初回起動後の設定手順
コンテナが起動したら、docker execコマンドでコンテナ内に入りopenclaw onboardを実行します。ウィザードに従って、AIモデルの選択・Botの名前設定・通信チャンネル(Telegram/Discord)の設定を行います。設定完了後、コンテナを再起動するとBotが自動でオンラインになります。
# 設定完了後はコンテナを再起動
docker-compose restart openclaw
NAS(Synology・QNAP)へのデプロイ
自宅のNASにOpenClawをDockerで動かすことで、電気代の安い常時稼働AIエージェントを実現できます。SynologyもQNAPもDocker(Container Manager)を標準搭載しています。
1 Synology NAS(DSM 7.2+)の場合
DSMの「パッケージセンター」からContainer Managerをインストールします。その後、「プロジェクト」タブで新規プロジェクトを作成し、上記のdocker-compose.ymlを貼り付けるだけでOpenClawが起動します。
# SSH経由でSynologyに接続してdocker-composeを使う場合
ssh [email protected]
cd /volume1/docker/openclaw
docker-compose up -d
2 QNAP NAS(QTS 5.x+)の場合
QNAPはContainer StationアプリでDockerを管理します。「アプリケーション」メニューからdocker-compose.ymlをインポートするか、SSH経由でターミナルから起動します。
# QNAPのSSH接続後
cd /share/Container/openclaw
docker-compose up -d
📊 NASでOpenClawを動かすメリット
VPS・クラウドへのデプロイ
VPSやAWS・GCPなどのクラウドサーバーにDockerでOpenClawをデプロイすれば、どこからでもアクセスできるクラウドAIエージェントが完成します。
VPS(Ubuntu 22.04/24.04)への手順
# Dockerのインストール(Ubuntu)
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
# docker-composeプラグインのインストール
sudo apt-get install docker-compose-plugin
# プロジェクトディレクトリを作成
mkdir -p ~/openclaw && cd ~/openclaw
# Dockerfile・docker-compose.yml・.envを配置して起動
docker compose up -d
# 起動確認
docker compose ps
AWS EC2(t3.small以上推奨)への手順
# EC2インスタンス起動後(Amazon Linux 2023)
sudo yum update -y
sudo yum install -y docker
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker ec2-user
# docker composeのインストール
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
# セキュリティグループでポート18789を開放
# AWS ConsoleでInbound RulesにTCP 18789を追加
mkdir -p ~/openclaw && cd ~/openclaw
docker-compose up -d
データ永続化とバックアップ
OpenClawのDockerコンテナで最も重要なのがデータの永続化です。コンテナを再作成しても、OpenClawの記憶(soul.md)・スキル・設定を失わないための管理方法を解説します。
# Volumeの場所を確認(ホストマシン上のパス)
docker volume inspect openclaw_openclaw-data
# 手動バックアップ
docker run --rm \
-v openclaw_openclaw-data:/data \
-v $(pwd):/backup \
alpine tar czf /backup/openclaw-backup-$(date +%Y%m%d).tar.gz /data
# バックアップを復元
docker run --rm \
-v openclaw_openclaw-data:/data \
-v $(pwd):/backup \
alpine tar xzf /backup/openclaw-backup-YYYYMMDD.tar.gz -C /
# バインドマウントを使ってホストの特定ディレクトリに保存する場合
# docker-compose.ymlのvolumesを以下のように変更:
# - ./openclaw-data:/root/.openclaw
💡 バインドマウントで直接ファイル編集も可能
Volumeの代わりにバインドマウント(./openclaw-data:/root/.openclaw)を使えば、ホストOS側から直接soul.mdやスキルファイルをテキストエディタで編集できます。開発・カスタマイズ時に非常に便利です。
複数エージェントの並列運用
Dockerの最大の強みは複数のOpenClawインスタンスを同時に起動できることです。たとえば「仕事用Bot」「プライベート用Bot」「監視用Bot」を同一サーバーで同時稼働させることができます。
# 複数エージェントのdocker-compose.yml例
version: '3.9'
services:
openclaw-work:
build: .
container_name: openclaw-work
restart: always
environment:
- ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
- TZ=Asia/Tokyo
volumes:
- openclaw-work-data:/root/.openclaw
ports:
- "18789:18789" # 仕事用ダッシュボード
openclaw-personal:
build: .
container_name: openclaw-personal
restart: always
environment:
- ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
- TZ=Asia/Tokyo
volumes:
- openclaw-personal-data:/root/.openclaw
ports:
- "18790:18789" # プライベート用ダッシュボード
volumes:
openclaw-work-data:
openclaw-personal-data:
よくあるDockerエラーと解決法
❌ エラー:「permission denied while trying to connect to the Docker daemon socket」
現在のユーザーがdockerグループに属していません。
sudo usermod -aG docker $USER
newgrp docker
❌ エラー:「port is already allocated」
ポート18789が他のプロセスに使われています。docker-compose.ymlのホスト側ポートを変更してください。
# ポートを変更(例:18790に変更)
ports:
- "18790:18789"
❌ エラー:OpenClawがAPIに接続できない(タイムアウト)
コンテナからAnthropicやOpenAIのAPIへの接続が遮断されています。VPS・NASのファイアウォール設定、またはISPによるブロックの可能性があります。
解決策:ホストマシンにVPN07を設定し、DockerコンテナがVPN07経由でAPIに接続できるようにします。1000Mbpsの高速回線で海外APIへの接続問題を解消します。
❌ エラー:「npm ERR! network」(インストール時のネットワークエラー)
ビルド中にnpmのパッケージ取得が失敗しています。ホストのDNS設定またはネットワーク接続に問題があります。
# Dockerのデフォル DNSを変更
# /etc/docker/daemon.jsonに追加:
{"dns": ["8.8.8.8", "1.1.1.1"]}
DockerのOpenClawで実現できること
コンテナ化されたOpenClawは、安定したインフラ上で以下のような高度な自動化を実現します。Xユーザーが報告している実際のユースケースを参考に紹介します。
🏠 NASホームサーバー活用
- ・ダウンロードタスクの自動管理
- ・写真整理・メタデータ付与の自動化
- ・家族全員のタスク管理をBot化
- ・ホームネットワークの監視・アラート
☁️ クラウド自動化
- ・EC2コスト最適化の自動提案
- ・CloudWatchアラームへの自動対応
- ・定期的なAWSリソースレポート生成
- ・GitHub Actions失敗の自動分析・修正
🔄 CI/CDパイプライン統合
- ・コードレビューの自動化
- ・テスト失敗時の原因分析
- ・PRへのAIコメント自動追加
- ・デプロイ後の動作確認
📱 マルチチャンネル管理
- ・Telegram・Discord・Slackを同時接続
- ・チャンネルごとに役割を分担
- ・複数のチームへ同時報告
- ・緊急アラートのエスカレーション
DockerのOpenClawにVPN07が必要な理由
NASやVPSでOpenClawをDockerで動かす際、VPN接続は運用の要となります。特に以下の3つのシナリオでVPN07が威力を発揮します。
🌐 海外APIへの安定接続
DockerコンテナからAnthropicやOpenAIのAPIへの接続は、ネットワーク環境によっては不安定になりがちです。VPN07の1000Mbps超高速回線を使えば、コンテナからのAPI通信が常に安定し、タスクの途中失敗を防げます。
📦 Dockerイメージ取得の高速化
DockerHubや各種npmパッケージリポジトリは海外サーバーに存在します。VPN07経由でDockerイメージをpullすれば、ビルド時間を大幅に短縮できます。特にNASのような低帯域環境では効果絶大です。
🔒 外部公開時のセキュリティ
VPSやクラウドのOpenClawダッシュボード(ポート18789)を外部公開する場合、固定IPのVPN07を使ってアクセス元を制限できます。不正アクセスのリスクを大幅に下げながら、外出先からでも安全に操作できます。
VPN07 — Docker × OpenClaw最適のVPN
NAS・VPS・クラウドのAIエージェントを支える国際VPN
DockerでOpenClawを動かすNAS・VPSユーザーに最適なVPNです。VPN07の1000Mbps超高速回線により、コンテナからのAI API通信・Dockerイメージ取得・グローバルサービス連携がすべてスムーズになります。月額$1.5という圧倒的なコストパフォーマンスと、10年以上の安定した実績で、あなたのAIエージェントインフラを支えます。