Ana içeriğe atla
EasyRunner, OpenClaw Gateway’i Caddy proxy’sinin arkasında küçük bir container’lı uygulama olarak barındırabilir. Bu kılavuz, Podman uyumlu Compose uygulamaları çalıştıran ve HTTPS’i Caddy üzerinden sunan bir EasyRunner host’u varsayar.

​
Başlamadan önce

  • Kendisine yönlendirilmiş bir alan adına sahip EasyRunner sunucusu.
  • Derlenmiş veya yayımlanmış bir OpenClaw container imajı.
  • /home/node/.openclaw için kalıcı bir yapılandırma volume’ü.
  • /workspace için kalıcı bir çalışma alanı volume’ü.
  • Güçlü bir Gateway token’ı veya parolası.
Mümkün olduğunda cihaz kimlik doğrulamasını etkin tutun. Reverse proxy dağıtımınız cihaz kimliğini doğru şekilde taşıyamıyorsa önce trusted-proxy ayarlarını düzeltin; tehlikeli kimlik doğrulama atlamalarını yalnızca tamamen özel, operatör denetimli bir ağ için kullanın.

​
Compose uygulaması

Şuna benzer bir Compose dosyasıyla bir EasyRunner uygulaması oluşturun: 
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    environment:
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_HOME: /home/node
      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_WORKSPACE_DIR: /workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"]

volumes:
  openclaw-config:
  openclaw-workspace:
openclaw.example.com yerine Gateway host adınızı yazın. OPENCLAW_GATEWAY_TOKEN değerini uygulama tanımına commit etmek yerine EasyRunner’ın gizli değer/ortam yöneticisinde saklayın.

​
OpenClaw’ı yapılandırma

Kalıcı yapılandırma volume’ü içinde Gateway’in yalnızca proxy üzerinden erişilebilir olmasını sağlayın ve kimlik doğrulama gerektirin: 
{
  gateway: {
    bind: "lan",
    port: 1455,
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}
Caddy, Gateway için TLS’i sonlandırıyorsa kimlik doğrulama denetimlerini genel olarak devre dışı bırakmak yerine tam proxy yolu için trusted proxy ayarlarını yapılandırın. Bkz. Trusted proxy kimlik doğrulaması.

​
Doğrulama

Çalışma istasyonunuzdan: 
openclaw gateway probe --url https://openclaw.example.com --token <token>
openclaw gateway status --url https://openclaw.example.com --token <token>
EasyRunner host’undan, dinleyen bir Gateway olduğunu ve başlangıçta SecretRef, Plugin veya kanal kimlik doğrulama hatası olmadığını doğrulamak için uygulama günlüklerini kontrol edin.

​
Güncellemeler ve yedeklemeler

  • Yeni OpenClaw imajını çekin veya derleyin, ardından EasyRunner uygulamasını yeniden dağıtın.
  • Güncellemelerden önce openclaw-config volume’ünü yedekleyin.
  • Agents orada kalıcı proje verileri yazıyorsa openclaw-workspace öğesini yedekleyin.
  • Büyük güncellemelerden sonra yapılandırma migration’larını ve hizmet uyarılarını yakalamak için openclaw doctor çalıştırın.

​
Sorun giderme

  • gateway probe bağlanamıyor: Caddy host adının uygulamayı gösterdiğini ve container’ın 0.0.0.0:1455 üzerinde dinlediğini doğrulayın.
  • Kimlik doğrulama başarısız oluyor: EasyRunner gizli değerlerindeki token’ı ve yerel istemci komutunu birlikte döndürün.
  • Geri yüklemeden sonra dosyalar root’a ait oluyor: Bağlanan volume’leri, container kullanıcısının /home/node/.openclaw ve /workspace dizinlerine yazabileceği şekilde onarın.
  • Tarayıcı veya kanal Plugin’leri başarısız oluyor: Gerekli harici binary’lerin, ağ çıkışının ve bağlanan kimlik bilgilerinin container içinde kullanılabilir olup olmadığını kontrol edin.