--- read_when: - Anda menginginkan Gateway dalam kontainer dengan Podman alih-alih Docker summary: Jalankan OpenClaw dalam kontainer Podman tanpa root title: Podman x-i18n: generated_at: "2026-06-27T17:38:30Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 3f6950956551dc3c274db33712cf66632fb5facbca4954bf67c30a8bff740c2f source_path: install/podman.md workflow: 16 --- Jalankan OpenClaw Gateway dalam kontainer Podman tanpa root, dikelola oleh pengguna non-root Anda saat ini. Model yang dimaksud adalah: - 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 ...`, 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 Dari root repo, jalankan `./scripts/podman/setup.sh`. Mulai kontainer dengan `./scripts/run-openclaw-podman.sh launch`. Jalankan `./scripts/run-openclaw-podman.sh launch setup`, lalu buka `http://127.0.0.1:18789/`. Tetapkan `OPENCLAW_CONTAINER=openclaw`, lalu gunakan perintah `openclaw` normal dari host. Detail penyiapan: - `./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. Penyiapan yang dikelola Quadlet: ```bash ./scripts/podman/setup.sh --quadlet ``` Quadlet adalah opsi khusus Linux karena bergantung pada layanan pengguna systemd. Anda juga dapat menetapkan `OPENCLAW_PODMAN_QUADLET=1`. Env var build/penyiapan opsional: - `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) Mulai kontainer: ```bash ./scripts/run-openclaw-podman.sh launch ``` Skrip memulai kontainer sebagai uid/gid Anda saat ini dengan `--userns=keep-id` dan bind-mount state OpenClaw Anda ke dalam kontainer. Onboarding: ```bash ./scripts/run-openclaw-podman.sh launch setup ``` Lalu buka `http://127.0.0.1:18789/` dan gunakan token dari `~/.openclaw/.env`. Autentikasi model di Podman: - 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. Default CLI host: ```bash export OPENCLAW_CONTAINER=openclaw ``` Lalu perintah seperti ini akan berjalan di dalam kontainer tersebut secara otomatis: ```bash openclaw dashboard --no-open openclaw gateway status --deep # includes extra service scan openclaw doctor openclaw channels login ``` Di macOS, mesin Podman dapat membuat browser tampak non-lokal bagi Gateway. Jika UI Kontrol melaporkan error autentikasi perangkat setelah peluncuran, gunakan panduan Tailscale di [Podman dan Tailscale](#podman--tailscale). ## Podman dan Tailscale Untuk HTTPS atau akses browser jarak jauh, ikuti dokumentasi utama Tailscale. Catatan khusus Podman: - 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. Lihat: - [Tailscale](/id/gateway/tailscale) - [UI Kontrol](/id/web/control-ui) ## Systemd (Quadlet, opsional) Jika Anda menjalankan `./scripts/podman/setup.sh --quadlet`, penyiapan memasang file Quadlet di: ```bash ~/.config/containers/systemd/openclaw.container ``` Perintah berguna: - **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` Setelah mengedit file Quadlet: ```bash systemctl --user daemon-reload systemctl --user restart openclaw.service ``` Untuk persistensi boot pada host SSH/headless, aktifkan lingering untuk pengguna Anda saat ini: ```bash 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` Skrip peluncuran dan Quadlet melakukan bind-mount state host ke dalam kontainer: - `OPENCLAW_CONFIG_DIR` -> `/home/node/.openclaw` - `OPENCLAW_WORKSPACE_DIR` -> `/home/node/.openclaw/workspace` Secara default, itu adalah direktori host, bukan state kontainer anonim, sehingga `openclaw.json`, `auth-profiles.json` per agen, state channel/provider, sesi, dan workspace tetap ada setelah penggantian kontainer. Penyiapan Podman juga mengisi `gateway.controlUi.allowedOrigins` untuk `127.0.0.1` dan `localhost` pada port Gateway yang dipublikasikan agar dashboard lokal berfungsi dengan bind non-loopback kontainer. Env var berguna untuk launcher manual: - `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` Launcher manual membaca `~/.openclaw/.env` sebelum menyelesaikan default kontainer/image, sehingga Anda dapat mempertahankannya di sana. Jika Anda menggunakan `OPENCLAW_CONFIG_DIR` atau `OPENCLAW_WORKSPACE_DIR` non-default, tetapkan variabel yang sama untuk `./scripts/podman/setup.sh` dan perintah `./scripts/run-openclaw-podman.sh launch` berikutnya. Launcher repo-lokal tidak mempertahankan override path kustom lintas shell. Catatan Quadlet: - 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 :` 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 ...` secara eksplisit, atau ekspor `OPENCLAW_CONTAINER=` 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](/id/install/docker) - [Proses latar belakang Gateway](/id/gateway/background-process) - [Pemecahan masalah Gateway](/id/gateway/troubleshooting)