Podman

• Podman が Gateway コンテナを実行します。
• ホストの openclaw CLI がコントロールプレーンです。
• 永続状態は、デフォルトでホストの ~/.openclaw 配下に保存されます。
• 日常的な管理には、sudo -u openclaw、podman exec、または別のサービスユーザーではなく、openclaw --container <name> ... を使用します。

​

前提条件

• rootless モードの Podman
• ホストにインストールされた OpenClaw CLI
• 任意: Quadlet で管理する自動起動を使用する場合は systemd --user
• 任意: ヘッドレスホストで起動時の永続化に loginctl enable-linger "$(whoami)" を使用する場合に限り sudo

​

クイックスタート

./scripts/podman/setup.sh --quadlet

./scripts/run-openclaw-podman.sh launch

./scripts/run-openclaw-podman.sh launch setup

export OPENCLAW_CONTAINER=openclaw

openclaw dashboard --no-open
openclaw gateway status --deep   # includes extra service scan
openclaw doctor
openclaw channels login

​

Podman と Tailscale

• Podman の公開ホストは 127.0.0.1 のままにします。
• openclaw gateway --tailscale serve よりも、ホスト管理の tailscale serve を優先します。
• macOS でローカルブラウザーのデバイス認証コンテキストが安定しない場合は、その場しのぎのローカルトンネルによる回避策ではなく、Tailscale アクセスを使用してください。

​

Systemd（Quadlet、任意）

systemctl --user daemon-reload
systemctl --user restart openclaw.service

sudo loginctl enable-linger "$(whoami)"

​

設定、環境、ストレージ

• 設定ディレクトリ: ~/.openclaw
• ワークスペースディレクトリ: ~/.openclaw/workspace
• トークンファイル: ~/.openclaw/.env
• 起動ヘルパー: ./scripts/run-openclaw-podman.sh

​

イメージのアップグレード

OPENCLAW_CONFIG_DIR="${OPENCLAW_CONFIG_DIR:-$HOME/.openclaw}"
OPENCLAW_WORKSPACE_DIR="${OPENCLAW_WORKSPACE_DIR:-$OPENCLAW_CONFIG_DIR/workspace}"
OPENCLAW_PODMAN_IMAGE="${OPENCLAW_PODMAN_IMAGE:-${OPENCLAW_IMAGE:-openclaw:local}}"

podman run --rm -it \
  --userns=keep-id \
  --user "$(id -u):$(id -g)" \
  -e HOME=/home/node \
  -e NPM_CONFIG_CACHE=/home/node/.openclaw/.npm \
  -v "$OPENCLAW_CONFIG_DIR:/home/node/.openclaw:rw" \
  -v "$OPENCLAW_WORKSPACE_DIR:/home/node/.openclaw/workspace:rw" \
  "$OPENCLAW_PODMAN_IMAGE" \
  openclaw doctor --fix

​

便利なコマンド

• コンテナログ: podman logs -f openclaw
• コンテナを停止: podman stop openclaw
• コンテナを削除: podman rm -f openclaw
• ホスト CLI からダッシュボード URL を開く: openclaw dashboard --no-open
• ホスト CLI によるヘルス／状態確認: openclaw gateway status --deep（RPC プローブ + 追加のサービススキャン）

​

トラブルシューティング

• 設定またはワークスペースでアクセス許可が拒否される（EACCES）: コンテナはデフォルトで --userns=keep-id と --user <your uid>:<your gid> を使用して実行されます。ホストの設定／ワークスペースパスが現在のユーザーによって所有されていることを確認してください。
• Gateway の起動がブロックされる（gateway.mode=local がない）: ~/.openclaw/openclaw.json が存在し、gateway.mode="local" が設定されていることを確認してください。存在しない場合は scripts/podman/setup.sh がこれを作成します。
• イメージ更新後にコンテナが再起動を繰り返す: イメージのアップグレードにある一回限りの openclaw doctor --fix コマンドを実行し、Gateway を再度起動してください。
• コンテナの CLI コマンドが誤った対象に接続する: openclaw --container <name> ... を明示的に使用するか、シェルで OPENCLAW_CONTAINER=<name> をエクスポートしてください。
• openclaw update が --container で失敗する: 想定どおりです。イメージをリビルドまたはプルしてから、コンテナまたは Quadlet サービスを再起動してください。
• Quadlet サービスが起動しない: systemctl --user daemon-reload を実行してから、systemctl --user start openclaw.service を実行してください。ヘッドレスシステムでは sudo loginctl enable-linger "$(whoami)" も必要になる場合があります。
• SELinux がバインドマウントをブロックする: デフォルトのマウント動作を変更しないでください。Linux で SELinux が enforcing または permissive の場合、ランチャーは :Z を自動的に追加します。

​

関連項目

• Docker
• Gateway のバックグラウンドプロセス
• Gateway のトラブルシューティング