OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Containers

Ansible

OpenClaw'u, güvenliği önceliklendiren bir mimariye sahip otomatik yükleyici openclaw-ansible ile üretim sunucularına dağıtın.

Ön koşullar

Gereksinim Ayrıntılar
İşletim sistemi Debian 11+ veya Ubuntu 20.04+
Erişim Root veya sudo ayrıcalıkları
Ağ Paket kurulumu için internet bağlantısı
Ansible 2.14+ (hızlı başlangıç betiği tarafından otomatik yüklenir)

Sağlananlar

  • Güvenlik duvarını önceliklendiren güvenlik: UFW + Docker yalıtımı (yalnızca SSH + Tailscale erişilebilir)
  • Hizmetleri herkese açık hâle getirmeden uzaktan erişim için Tailscale VPN
  • Yalnızca localhost bağlamalarıyla yalıtılmış korumalı alan konteynerleri için Docker
  • Güçlendirme ve önyüklemede otomatik başlatma özellikli systemd entegrasyonu
  • Tek komutla kurulum

Hızlı başlangıç

bash
curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

Yüklenenler

  1. Tailscale (güvenli uzaktan erişim için örgü VPN)
  2. UFW güvenlik duvarı (yalnızca SSH + Tailscale portları)
  3. Docker CE + Compose V2 (varsayılan ajan korumalı alan arka ucu)
  4. Node.js ve pnpm (OpenClaw için Node 22.22.3+, 24.15+ veya 25.9+ gerekir; Node 24 önerilir)
  5. Konteynerleştirilmeden, ana makine tabanlı olarak yüklenen OpenClaw
  6. Güvenlik güçlendirmeli bir systemd hizmeti

Kurulum sonrası yapılandırma

  • openclaw kullanıcısına geçin

    bash
    sudo -i -u openclaw

  • İlk kullanım sihirbazını çalıştırın

    Kurulum sonrası betik, OpenClaw yapılandırması boyunca size rehberlik eder.

  • Mesajlaşma kanallarını bağlayın

    WhatsApp, Telegram, Discord veya Signal'de oturum açın:

    bash
    openclaw channels login --channel <name>

  • Kurulumu doğrulayın

    bash
    sudo systemctl status openclawsudo journalctl -u openclaw -f

  • Tailscale'e bağlanın

    Güvenli uzaktan erişim için VPN örgünüze katılın.

    • Hızlı komutlar

    bash
    # Hizmet durumunu denetleyinsudo systemctl status openclaw # Canlı günlükleri görüntüleyinsudo journalctl -u openclaw -f # Gateway'i yeniden başlatınsudo systemctl restart openclaw # Kanal oturumu açın (openclaw kullanıcısı olarak çalıştırın)sudo -i -u openclawopenclaw channels login --channel <name>

    Güvenlik mimarisi

    Dört katmanlı savunma modeli:

    1. Güvenlik duvarı (UFW): yalnızca SSH (22) ve Tailscale (41641/udp) herkese açıktır
    2. VPN (Tailscale): Gateway'e yalnızca VPN örgüsü üzerinden erişilebilir
    3. Docker yalıtımı: DOCKER-USER iptables zinciri, portların dışarıya açılmasını önler
    4. Systemd güçlendirmesi: NoNewPrivileges, PrivateTmp, ayrıcalıksız kullanıcı

    Harici saldırı yüzeyinizi doğrulayın:

    bash
    nmap -p- YOUR_SERVER_IP

    Yalnızca 22 numaralı port (SSH) açık olmalıdır. Gateway ve Docker erişime kapalı kalır.

    Docker, Gateway'i çalıştırmak için değil, ajan korumalı alanları (yalıtılmış araç yürütme) için yüklenir. Korumalı alan yapılandırması için Çok Ajanlı Korumalı Alan ve Araçlar bölümüne bakın.

    Manuel kurulum

  • Ön koşulları yükleyin

    bash
    sudo apt update && sudo apt install -y ansible git

  • Depoyu klonlayın

    bash
    git clone https://github.com/openclaw/openclaw-ansible.gitcd openclaw-ansible

  • Ansible koleksiyonlarını yükleyin

    bash
    ansible-galaxy collection install -r requirements.yml

  • Playbook'u çalıştırın

    bash
    ./run-playbook.sh

    Alternatif olarak playbook'u doğrudan çalıştırın, ardından kurulum betiğini manuel olarak çalıştırın:

    bash
    ansible-playbook playbook.yml --ask-become-pass# Ardından çalıştırın: /tmp/openclaw-setup.sh

    • Güncelleme

    Ansible yükleyicisi, OpenClaw'u manuel güncellemelere uygun biçimde kurar; standart akış için Güncelleme bölümüne bakın.

    Playbook'u yeniden çalıştırmak için (örneğin yapılandırma değişikliklerinden sonra):

    bash
    cd openclaw-ansible./run-playbook.sh

    Bu işlem eş etkisizdir ve birden çok kez güvenle çalıştırılabilir.

    Sorun giderme

    Güvenlik duvarı bağlantımı engelliyor
    • Önce Tailscale VPN üzerinden bağlanın; Gateway tasarım gereği yalnızca bu yolla erişilebilir.
    • SSH'ye (port 22) her zaman izin verilir.
    Hizmet başlatılamıyor
    bash
    # Günlükleri denetleyinsudo journalctl -u openclaw -n 100 # İzinleri doğrulayınsudo ls -la /opt/openclaw # Manuel başlatmayı test edinsudo -i -u openclawcd ~/openclawopenclaw gateway run
    Docker korumalı alan sorunları
    bash
    # Docker'ın çalıştığını doğrulayınsudo systemctl status docker # Korumalı alan imajını denetleyinsudo docker images | grep openclaw-sandbox # Eksikse korumalı alan imajını oluşturun (kaynak kod çalışma kopyası gerektirir)cd /opt/openclaw/openclawsudo -u openclaw ./scripts/sandbox-setup.sh# Kaynak kod çalışma kopyası olmadan yapılan npm kurulumları için bkz.# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup
    Kanal oturumu açılamıyor

    openclaw kullanıcısı olarak çalıştırdığınızdan emin olun:

    bash
    sudo -i -u openclawopenclaw channels login --channel <name>

    Gelişmiş yapılandırma

    Ayrıntılı güvenlik mimarisi ve sorun giderme bilgileri için openclaw-ansible deposuna bakın:

    İlgili

    Was this useful?
    On this page

    On this page