openclaw

OpenClaw - セルフホスト型 AI ゲートウェイ

OpenClaw（coollabsio/openclaw）をコンテナ化された AI ゲートウェイとしてデプロイし、管理します。 フルツール利用、セッション分離、ブラウザー自動化に対応し、メッセージングプラットフォームと複数の LLM プロバイダー間の会話をルーティングします。

本番環境でテスト済み：KASM 1.17.0（Ubuntu 22.04）上の OpenClaw v2026.1.x ソース：https://github.com/coollabsio/openclaw

---

ステップ 0：適切なリファレンスを参照する

タスク	リファレンス
Docker の新規デプロイ	references/installation.md
KASM ワークスペースのセットアップ	references/kasm-workspace.md
環境変数と設定	references/configuration.md
メッセージングチャネル（Telegram、Discord など）	references/channels.md
セキュリティ強化	references/security.md
エラーのトラブルシューティング	references/troubleshooting.md
ブラウザーサイドカーと自動化	references/browser-automation.md

---

重要なルール

1. 必ず OPENCLAW_GATEWAY_BIND=loopback を設定してください - デフォルトのバインドでは、ポート 18789 でゲートウェイがパブリックインターネットに公開されます。これは重大な既知のセキュリティ問題です（2026 年 2 月）。
2. AUTH_PASSWORD を省略しないでください - nginx のベーシック認証は最初の防御層です。
3. ボリュームをマウントする前に、ディレクトリの所有者を uid 1000 に設定してください - コンテナは非 root ユーザーの node として実行されます。
4. API キーは環境変数でのみ指定します - プロバイダーのキーを JSON 設定ファイルに記述しないでください。
5. WhatsApp は全体置換モードを使用します - WHATSAPP_ENABLED=true の場合、WhatsApp ブロック全体が置き換えられます（マージされません）。
6. 環境変数がすべての設定に優先します - 3 層のマージ：JSON < 永続化された状態 < 環境変数。
7. KASM の場合：OpenClaw ワークスペースごとに最低 4GB の RAM を割り当て、/data ボリューム用に永続プロファイルを設定してください。

---

クイックリファレンス

アーキテクチャ

[Messaging Channels] → [OpenClaw Gateway :18789] → [LLM Providers]
       ↑                        ↑                         ↑
  WhatsApp, Telegram    nginx reverse proxy :8080    Anthropic, OpenAI
  Discord, Slack        HTTP Basic Auth              Gemini, Groq, etc.
  Google Chat, Signal   Webhook routing

デフォルトのポート

ポート	サービス	バインド
8080	nginx リバースプロキシ（外部）	PORT で設定可能
18789	OpenClaw ゲートウェイ（内部）	必ず loopback に設定
9223	Chrome CDP（ブラウザーサイドカー）	内部のみ

対応 AI プロバイダー

Anthropic、OpenAI、Google Gemini、xAI Grok、Groq、Mistral、Cerebras、 Venice、Moonshot、Kimi、MiniMax、AWS Bedrock、Ollama（ローカル）、GitHub Copilot

対応チャネル

WhatsApp（Baileys）、Telegram（grammY）、Discord（discord.js）、Slack（Bolt）、 Google Chat、Signal、iMessage/BlueBubbles、Microsoft Teams、Matrix、Zalo

---

システム要件

スタンドアロン Docker

リソース	最小要件	推奨
RAM	2 GB	4 GB 以上
ディスク	10 GB	20 GB 以上
Docker	Engine + Compose v2	最新の安定版
アーキテクチャ	amd64 または arm64	どちらでも可

KASM ワークスペース

リソース	値
コア数	2
メモリ	4096 MB
Docker イメージ	coollabsio/openclaw:latest
永続プロファイル	/data に必要
GPU	不要

必須の設定

OpenClaw には最低限、以下が必要です：

1. AI プロバイダーの API キーを 1 つ（例：ANTHROPIC_API_KEY）
2. nginx のベーシック認証用の AUTH_PASSWORD
3. セキュリティのための OPENCLAW_GATEWAY_BIND=loopback

---

最小構成でのデプロイ

docker run -d --name openclaw \
  -p 8080:8080 \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -e AUTH_PASSWORD=changeme \
  -e OPENCLAW_GATEWAY_BIND=loopback \
  -e OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32) \
  -v openclaw-data:/data \
  coollabsio/openclaw:latest

ダッシュボードへのアクセス先：http://localhost:8080/

---

ヘルスチェック

# Container health
docker inspect --format='{{.State.Health.Status}}' openclaw

# Gateway health
docker exec openclaw node dist/index.js health \
  --token "$OPENCLAW_GATEWAY_TOKEN"

# Diagnostic scan
docker exec openclaw openclaw doctor --fix

# Full status
docker exec openclaw openclaw status --all

# Logs
docker logs -f openclaw

---

Docker Compose（ブラウザーを含む完全構成）

services:
  openclaw-gateway:
    image: coollabsio/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - AUTH_USERNAME=admin
      - AUTH_PASSWORD=${AUTH_PASSWORD}
      - OPENCLAW_GATEWAY_BIND=loopback
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - BROWSER_CDP_URL=http://browser:9223
    volumes:
      - openclaw-data:/data
    depends_on:
      - browser

  browser:
    image: coollabsio/openclaw-browser:latest
    container_name: openclaw-browser
    restart: unless-stopped
    shm_size: 2gb
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - browser-data:/config

volumes:
  openclaw-data:
  browser-data:

---

このスキルで防止できるエラー

#	エラー	根本原因	防止策
1	ゲートウェイがインターネットに公開される	デフォルトの 0.0.0.0 バインド	常に OPENCLAW_GATEWAY_BIND=loopback を設定します
2	「1008 token mismatch」	古い環境変数が設定を上書きする	--no-cache を指定して再ビルドし、環境変数を確認します
3	EACCES 権限拒否	非 root コンテナ（uid 1000）	マウントディレクトリで chown -R 1000:1000 を実行します
4	「context_length_exceeded」の誤検知	トークン数の誤り	セッションをクリアし、履歴の上限を減らします
5	WhatsApp の設定が無視される	全置換モード	有効にする場合は、すべての WhatsApp 変数を設定します
6	設定ファイル内の API キー	キーがログやバックアップに漏洩する	環境変数のみを使用します
7	実行時のパッケージインストール不可	非 root コンテナ	ビルド時に OPENCLAW_DOCKER_APT_PACKAGES を使用します
8	ブラウザー自動化が失敗する	Chromium が同梱されていない	ブラウザーサイドカーコンテナを使用します