Podman

• Podman menjalankan kontainer gateway.
• CLI openclaw host Anda adalah control plane.
• State persisten berada di host di bawah ~/.openclaw secara default.
• Pengelolaan harian menggunakan openclaw --container <name> ..., bukan sudo -u openclaw, podman exec, atau pengguna layanan terpisah.

​

Prasyarat

• Podman dalam mode tanpa root
• CLI OpenClaw terinstal di host
• Opsional: systemd --user jika Anda ingin auto-start yang dikelola Quadlet
• Opsional: sudo hanya jika Anda menginginkan loginctl enable-linger "$(whoami)" untuk persistensi boot pada host headless

​

Mulai cepat

• ./scripts/podman/setup.sh membangun openclaw:local di penyimpanan Podman tanpa root Anda secara default, atau menggunakan OPENCLAW_IMAGE / OPENCLAW_PODMAN_IMAGE jika Anda menetapkannya.
• Ini membuat ~/.openclaw/openclaw.json dengan gateway.mode: "local" jika belum ada.
• Ini membuat ~/.openclaw/.env dengan OPENCLAW_GATEWAY_TOKEN jika belum ada.
• Untuk peluncuran manual, helper hanya membaca allowlist kecil berisi kunci terkait Podman dari ~/.openclaw/.env dan meneruskan env var runtime eksplisit ke kontainer; ini tidak menyerahkan seluruh file env ke Podman.

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

• OPENCLAW_IMAGE atau OPENCLAW_PODMAN_IMAGE — gunakan image yang sudah ada/ditarik alih-alih membangun openclaw:local
• OPENCLAW_IMAGE_APT_PACKAGES — instal paket apt tambahan selama build image (juga menerima OPENCLAW_DOCKER_APT_PACKAGES lama)
• OPENCLAW_IMAGE_PIP_PACKAGES — instal paket Python tambahan selama build image; pin versi dan gunakan hanya indeks paket yang Anda percayai
• OPENCLAW_EXTENSIONS — pra-instal dependensi Plugin pada waktu build
• OPENCLAW_INSTALL_BROWSER — pra-instal Chromium dan Xvfb untuk otomasi browser (tetapkan ke 1 untuk mengaktifkan)

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

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

• Gunakan autentikasi yang dikelola OpenClaw selama penyiapan: kunci API Anthropic untuk Anthropic, atau autentikasi OAuth browser/kode perangkat OpenAI Codex untuk OpenAI yang didukung Codex.
• Launcher Podman tidak memasang home kredensial CLI host seperti ~/.claude atau ~/.codex ke kontainer penyiapan atau gateway.
• Login CLI host yang sudah ada adalah jalur kemudahan host yang sama. Untuk instalasi kontainer, simpan autentikasi provider di state ~/.openclaw terpasang yang dikelola penyiapan.

export OPENCLAW_CONTAINER=openclaw

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

​

Podman dan Tailscale

• Pertahankan host publish Podman di 127.0.0.1.
• Lebih pilih tailscale serve yang dikelola host daripada openclaw gateway --tailscale serve.
• Di macOS, jika konteks autentikasi perangkat browser lokal tidak andal, gunakan akses Tailscale alih-alih workaround tunnel lokal ad hoc.

• Tailscale
• UI Kontrol

​

Systemd (Quadlet, opsional)

~/.config/containers/systemd/openclaw.container

• Mulai: systemctl --user start openclaw.service
• Hentikan: systemctl --user stop openclaw.service
• Status: systemctl --user status openclaw.service
• Log: journalctl --user -u openclaw.service -f

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

sudo loginctl enable-linger "$(whoami)"

​

Config, env, dan penyimpanan

• Direktori config: ~/.openclaw
• Direktori workspace: ~/.openclaw/workspace
• File token: ~/.openclaw/.env
• Helper peluncuran: ./scripts/run-openclaw-podman.sh

• OPENCLAW_CONFIG_DIR -> /home/node/.openclaw
• OPENCLAW_WORKSPACE_DIR -> /home/node/.openclaw/workspace

• OPENCLAW_PODMAN_CONTAINER — nama kontainer (openclaw secara default)
• OPENCLAW_PODMAN_IMAGE / OPENCLAW_IMAGE — image yang dijalankan
• OPENCLAW_PODMAN_GATEWAY_HOST_PORT — port host yang dipetakan ke kontainer 18789
• OPENCLAW_PODMAN_BRIDGE_HOST_PORT — port host yang dipetakan ke kontainer 18790
• OPENCLAW_PODMAN_PUBLISH_HOST — antarmuka host untuk port yang dipublikasikan; default adalah 127.0.0.1
• OPENCLAW_GATEWAY_BIND — mode bind Gateway di dalam kontainer; default adalah lan
• OPENCLAW_PODMAN_USERNS — keep-id (default), auto, atau host

• Layanan Quadlet yang dihasilkan sengaja mempertahankan bentuk default yang tetap dan diperkeras: port yang dipublikasikan 127.0.0.1, --bind lan di dalam kontainer, dan namespace pengguna keep-id.
• Ini mem-pin OPENCLAW_NO_RESPAWN=1, Restart=on-failure, dan TimeoutStartSec=300.
• Ini memublikasikan 127.0.0.1:18789:18789 (Gateway) dan 127.0.0.1:18790:18790 (bridge).
• Ini membaca ~/.openclaw/.env sebagai EnvironmentFile runtime untuk nilai seperti OPENCLAW_GATEWAY_TOKEN, tetapi tidak mengonsumsi allowlist override khusus Podman milik launcher manual.
• Jika Anda memerlukan port publish kustom, host publish, atau flag container-run lainnya, gunakan launcher manual atau edit ~/.config/containers/systemd/openclaw.container secara langsung, lalu muat ulang dan mulai ulang layanan.

​

Perintah berguna

• Log kontainer: podman logs -f openclaw
• Hentikan kontainer: podman stop openclaw
• Hapus kontainer: podman rm -f openclaw
• Buka URL dashboard dari CLI host: openclaw dashboard --no-open
• Health/status melalui CLI host: openclaw gateway status --deep (probe RPC + pemindaian layanan tambahan)

​

Pemecahan masalah

• Izin ditolak (EACCES) pada config atau workspace: Kontainer berjalan dengan --userns=keep-id dan --user <your uid>:<your gid> secara default. Pastikan path config/workspace host dimiliki oleh pengguna Anda saat ini.
• Start Gateway diblokir (gateway.mode=local tidak ada): Pastikan ~/.openclaw/openclaw.json ada dan menetapkan gateway.mode="local". scripts/podman/setup.sh membuat ini jika belum ada.
• Perintah CLI kontainer mengenai target yang salah: Gunakan openclaw --container <name> ... secara eksplisit, atau ekspor OPENCLAW_CONTAINER=<name> di shell Anda.
• openclaw update gagal dengan --container: Ini sesuai ekspektasi. Bangun ulang/tarik image, lalu mulai ulang kontainer atau layanan Quadlet.
• Layanan Quadlet tidak mulai: Jalankan systemctl --user daemon-reload, lalu systemctl --user start openclaw.service. Pada sistem headless, Anda mungkin juga perlu sudo loginctl enable-linger "$(whoami)".
• SELinux memblokir bind mount: Biarkan perilaku mount default apa adanya; launcher otomatis menambahkan :Z di Linux ketika SELinux dalam mode enforcing atau permissive.

​

Terkait

• Docker
• Proses latar belakang Gateway
• Pemecahan masalah Gateway