Podman

OpenClaw Gateway'ini, mevcut root olmayan kullanıcınız tarafından yönetilen rootsuz bir Podman konteynerinde çalıştırın.

Model:

• Podman, Gateway konteynerini çalıştırır.
• Ana makinenizdeki openclaw CLI, kontrol düzlemidir.
• Kalıcı durum varsayılan olarak ana makinede ~/.openclaw altında bulunur.
• Günlük yönetimde sudo -u openclaw, podman exec veya ayrı bir hizmet kullanıcısı yerine openclaw --container <name> ... kullanılır.

Ön koşullar

• Rootless modda Podman
• Ana makinede kurulu OpenClaw CLI
• İsteğe bağlı: Quadlet tarafından yönetilen otomatik başlatma istiyorsanız systemd --user
• İsteğe bağlı: Başsız bir ana makinede açılış sonrası kalıcılık için loginctl enable-linger "$(whoami)" kullanmak istiyorsanız yalnızca sudo

Hızlı başlangıç

./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-openopenclaw gateway status --deep   # ek hizmet taramasını içeriropenclaw doctoropenclaw channels login

Manuel başlatıcı, ~/.openclaw/.env dosyasından yalnızca Podman ile ilgili küçük bir izin listesindeki anahtarları okur ve konteynere açıkça belirtilmiş çalışma zamanı ortam değişkenlerini geçirir; ortam dosyasının tamamını Podman'a vermez.

Podman ve Tailscale

HTTPS veya uzaktan tarayıcı erişimi için ana Tailscale belgelerini izleyin.

Podman'a özgü notlar:

• Podman yayımlama ana makinesini 127.0.0.1 olarak tutun.
• openclaw gateway --tailscale serve yerine ana makine tarafından yönetilen tailscale serve kullanımını tercih edin.
• macOS'te yerel tarayıcının cihaz kimlik doğrulama bağlamı güvenilir değilse geçici yerel tünel çözümleri yerine Tailscale erişimini kullanın.

Bkz. Tailscale ve Denetim Arayüzü.

Systemd (Quadlet, isteğe bağlı)

./scripts/podman/setup.sh --quadlet komutunu çalıştırdıysanız kurulum, ~/.config/containers/systemd/openclaw.container konumuna bir Quadlet dosyası yükler.

Quadlet dosyasını düzenledikten sonra:

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

SSH/başsız ana makinelerde açılış sonrası kalıcılık için mevcut kullanıcınız adına kalıcı kullanıcı hizmetlerini etkinleştirin:

sudo loginctl enable-linger "$(whoami)"

Oluşturulan Quadlet hizmeti sabit ve sıkılaştırılmış bir varsayılan yapı kullanır: 127.0.0.1 üzerinde yayımlanan bağlantı noktaları (18789 Gateway, 18790 köprü), konteyner içinde --bind lan, keep-id kullanıcı ad alanı, OPENCLAW_NO_RESPAWN=1, Restart=on-failure ve TimeoutStartSec=300. OPENCLAW_GATEWAY_TOKEN gibi değerler için ~/.openclaw/.env dosyasını çalışma zamanı EnvironmentFile olarak okur ancak manuel başlatıcının Podman'a özgü geçersiz kılma izin listesini kullanmaz. Özel yayımlama bağlantı noktaları, yayımlama ana makinesi veya diğer konteyner çalıştırma bayrakları için bunun yerine manuel başlatıcıyı kullanın ya da ~/.config/containers/systemd/openclaw.container dosyasını doğrudan düzenleyip hizmeti yeniden yükleyerek yeniden başlatın.

Yapılandırma, ortam ve depolama

• Yapılandırma dizini: ~/.openclaw
• Çalışma alanı dizini: ~/.openclaw/workspace
• Token dosyası: ~/.openclaw/.env
• Başlatma yardımcısı: ./scripts/run-openclaw-podman.sh

Başlatma betiği ve Quadlet, ana makine durumunu konteynere bağlama yoluyla bağlar: OPENCLAW_CONFIG_DIR -> /home/node/.openclaw, OPENCLAW_WORKSPACE_DIR -> /home/node/.openclaw/workspace. Bunlar varsayılan olarak anonim konteyner durumu değil, ana makine dizinleridir; böylece openclaw.json, aracı başına auth-profiles.json, kanal/sağlayıcı durumu, oturumlar ve çalışma alanı konteyner değiştirildiğinde korunur. Kurulum ayrıca yerel panonun konteynerin local loopback olmayan bağlamasıyla çalışması için yayımlanan Gateway bağlantı noktasında 127.0.0.1 ve localhost değerlerini gateway.controlUi.allowedOrigins içine başlangıç değerleri olarak ekler.

Manuel başlatıcı için yararlı ortam değişkenleri (bunları ~/.openclaw/.env içinde kalıcılaştırın; başlatıcı, konteyner/imaj varsayılanlarını kesinleştirmeden önce bu dosyayı okur):

Varsayılan olmayan bir OPENCLAW_CONFIG_DIR veya OPENCLAW_WORKSPACE_DIR kullanıyorsanız hem ./scripts/podman/setup.sh hem de daha sonraki ./scripts/run-openclaw-podman.sh launch komutları için aynı değişkenleri ayarlayın -- depo içindeki başlatıcı, özel yol geçersiz kılmalarını kabuklar arasında kalıcılaştırmaz.

İmajları yükseltme

Yeni bir imaj oluşturduktan veya çektikten sonra konteyneri ya da Quadlet hizmetini yeniden başlatın. Yeni bir OpenClaw sürümünün ilk başlangıcında Gateway, hazır olduğunu bildirmeden önce güvenli durum ve plugin onarımlarını çalıştırır.

Gateway hazır duruma gelmek yerine kapanırsa aynı bağlı durum/yapılandırma üzerinde aynı imajı bir kez openclaw doctor --fix ile çalıştırın, ardından Gateway'i normal biçimde yeniden başlatın:

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

SELinux ana makinelerinde Podman bağlı duruma erişimi engelliyorsa her iki bağlama noktasına da ,Z ekleyin.

Yararlı komutlar

• Konteyner günlükleri: podman logs -f openclaw
• Konteyneri durdur: podman stop openclaw
• Konteyneri kaldır: podman rm -f openclaw
• Pano URL'sini ana makine CLI'sından aç: openclaw dashboard --no-open
• Ana makine CLI'sı üzerinden sağlık/durum: openclaw gateway status --deep (RPC yoklaması + ek hizmet taraması)

Sorun giderme

• Yapılandırma veya çalışma alanında izin reddedildi (EACCES): Konteyner varsayılan olarak --userns=keep-id ve --user <your uid>:<your gid> ile çalışır. Ana makinedeki yapılandırma/çalışma alanı yollarının mevcut kullanıcınıza ait olduğundan emin olun.
• Gateway başlangıcı engellendi (gateway.mode=local eksik): ~/.openclaw/openclaw.json dosyasının mevcut olduğundan ve gateway.mode="local" ayarını içerdiğinden emin olun. scripts/podman/setup.sh, eksikse bunu oluşturur.
• İmaj güncellemesinden sonra konteyner yeniden başlıyor: İmajları yükseltme bölümündeki tek seferlik openclaw doctor --fix komutunu çalıştırın, ardından Gateway'i yeniden başlatın.
• Konteyner CLI komutları yanlış hedefe gidiyor: Açıkça openclaw --container <name> ... kullanın veya kabuğunuzda OPENCLAW_CONTAINER=<name> dışa aktarın.
• openclaw update, --container ile başarısız oluyor: Bu beklenen bir durumdur. İmajı yeniden oluşturun/çekin, ardından konteyneri veya Quadlet hizmetini yeniden başlatın.
• Quadlet hizmeti başlamıyor: systemctl --user daemon-reload, ardından systemctl --user start openclaw.service komutunu çalıştırın. Başsız sistemlerde ayrıca sudo loginctl enable-linger "$(whoami)" kullanmanız gerekebilir.
• SELinux bağlama noktalarını engelliyor: Varsayılan bağlama davranışını değiştirmeyin; SELinux zorlayıcı veya izin verici moddayken başlatıcı Linux'ta otomatik olarak :Z ekler.

İlgili konular

• Docker
• Gateway arka plan işlemi
• Gateway sorun giderme