Ansible

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

Ansible dağıtımı için esas kaynak openclaw-ansible deposudur. Bu sayfa kısa bir genel bakış sunar.

Ö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ıç

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

Yüklenenler

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

Gateway, Docker içinde değil, doğrudan ana makinede çalışır. Ajan korumalı alanı isteğe bağlıdır; bu playbook, varsayılan korumalı alan arka ucu olduğu için Docker’ı yükler. Diğer arka uçlar için Korumalı Alan bölümüne bakın.

Kurulum sonrası yapılandırma

openclaw kullanıcısına geçin

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:

openclaw channels login --channel <name>

Kurulumu doğrulayın

sudo systemctl status openclaw
sudo 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

# Hizmet durumunu denetleyin
sudo systemctl status openclaw

# Canlı günlükleri görüntüleyin
sudo journalctl -u openclaw -f

# Gateway'i yeniden başlatın
sudo systemctl restart openclaw

# Kanal oturumu açın (openclaw kullanıcısı olarak çalıştırın)
sudo -i -u openclaw
openclaw channels login --channel <name>

Güvenlik mimarisi

Dört katmanlı savunma modeli:

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

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

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

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

Depoyu klonlayın

git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

Ansible koleksiyonlarını yükleyin

ansible-galaxy collection install -r requirements.yml

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

./run-playbook.sh

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

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):

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

# Günlükleri denetleyin
sudo journalctl -u openclaw -n 100

# İzinleri doğrulayın
sudo ls -la /opt/openclaw

# Manuel başlatmayı test edin
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

Docker korumalı alan sorunları

# Docker'ın çalıştığını doğrulayın
sudo systemctl status docker

# Korumalı alan imajını denetleyin
sudo docker images | grep openclaw-sandbox

# Eksikse korumalı alan imajını oluşturun (kaynak kod çalışma kopyası gerektirir)
cd /opt/openclaw/openclaw
sudo -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:

sudo -i -u openclaw
openclaw 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

openclaw-ansible: tam dağıtım kılavuzu
Docker: konteynerleştirilmiş Gateway kurulumu
Korumalı Alan: ajan korumalı alanı yapılandırması
Çok Ajanlı Korumalı Alan ve Araçlar: ajan başına yalıtım

Install overview

Maintenance

Containers

Hosting

Advanced setup

Ön koşullar

Sağlananlar

Hızlı başlangıç

Yüklenenler

Kurulum sonrası yapılandırma

Hızlı komutlar

Güvenlik mimarisi

Manuel kurulum

Güncelleme

Sorun giderme

Gelişmiş yapılandırma

İlgili

​Ön koşullar

​Sağlananlar

​Hızlı başlangıç

​Yüklenenler

​Kurulum sonrası yapılandırma

​Hızlı komutlar

​Güvenlik mimarisi

​Manuel kurulum

​Güncelleme

​Sorun giderme

​Gelişmiş yapılandırma

​İlgili

Ön koşullar

Sağlananlar

Hızlı başlangıç

Yüklenenler

Kurulum sonrası yapılandırma

Hızlı komutlar

Güvenlik mimarisi

Manuel kurulum

Güncelleme

Sorun giderme

Gelişmiş yapılandırma

İlgili