​

Ansible Kurulumu

​

Hızlı Başlangıç

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

📦 Tam kılavuz: github.com/openclaw/openclaw-ansible openclaw-ansible deposu, Ansible dağıtımı için tek doğruluk kaynağıdır. Bu sayfa hızlı bir genel bakış sunar.

​

Neler Kazanırsınız

• 🔒 Güvenlik duvarı öncelikli güvenlik: UFW + Docker yalıtımı (yalnızca SSH + Tailscale erişilebilir)
• 🔐 Tailscale VPN: Hizmetleri herkese açık hale getirmeden güvenli uzaktan erişim
• 🐳 Docker: Yalıtılmış sandbox konteynerleri, yalnızca localhost bağlamaları
• 🛡️ Derinlemesine savunma: 4 katmanlı güvenlik mimarisi
• 🚀 Tek komutlu kurulum: Dakikalar içinde eksiksiz dağıtım
• 🔧 Systemd entegrasyonu: Güçlendirme ile önyüklemede otomatik başlatma

​

Gereksinimler

• İşletim Sistemi: Debian 11+ veya Ubuntu 20.04+
• Erişim: Root veya sudo yetkileri
• Ağ: Paket kurulumu için internet bağlantısı
• Ansible: 2.14+ (hızlı başlangıç betiği tarafından otomatik kurulur)

​

Kurulum sonrası betik sizi şu konularda yönlendirecek:

1. Tailscale (güvenli uzaktan erişim için mesh VPN)
2. UFW güvenlik duvarı (yalnızca SSH + Tailscale portları)
3. Docker CE + Compose V2 (ajan sandbox’ları için)
4. Node.js 22.x + pnpm (çalışma zamanı bağımlılıkları)
5. OpenClaw (host tabanlı, konteyner içinde değil)
6. Systemd servisi (güvenlik güçlendirmesiyle otomatik başlatma)

​

Kurulum Sonrası Ayarlar

sudo -i -u openclaw

1. Onboarding sihirbazı: OpenClaw ayarlarını yapılandırma
2. Sağlayıcı girişi: WhatsApp/Telegram/Discord/Signal bağlama
3. Gateway testi: Kurulumu doğrulama
4. Tailscale kurulumu: VPN mesh’inize bağlanma

​

Hızlı komutlar

# Check service status
sudo systemctl status openclaw

# View live logs
sudo journalctl -u openclaw -f

# Restart gateway
sudo systemctl restart openclaw

# Provider login (run as openclaw user)
sudo -i -u openclaw
openclaw channels login

​

Güvenlik Mimarisi

​

4 Katmanlı Savunma

1. Güvenlik Duvarı (UFW): Yalnızca SSH (22) + Tailscale (41641/udp) herkese açık
2. VPN (Tailscale): Gateway yalnızca VPN mesh üzerinden erişilebilir
3. Docker Yalıtımı: DOCKER-USER iptables zinciri dış portların açılmasını engeller
4. Systemd Güçlendirmesi: NoNewPrivileges, PrivateTmp, ayrıcalıksız kullanıcı

​

Doğrulama

nmap -p- YOUR_SERVER_IP

​

Docker Kullanılabilirliği

​

Manuel Kurulum

# 1. Install prerequisites
sudo apt update && sudo apt install -y ansible git

# 2. Clone repository
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

# 3. Install Ansible collections
ansible-galaxy collection install -r requirements.yml

# 4. Run playbook
./run-playbook.sh

# Or run directly (then manually execute /tmp/openclaw-setup.sh after)
# ansible-playbook playbook.yml --ask-become-pass

​

OpenClaw Güncelleme

cd openclaw-ansible
./run-playbook.sh

​

Sorun Giderme

​

Güvenlik duvarı bağlantımı engelliyor

• Önce Tailscale VPN üzerinden erişebildiğinizden emin olun
• SSH erişimine (22 numaralı port) her zaman izin verilir
• Gateway tasarım gereği yalnızca Tailscale üzerinden erişilebilirdir

​

Servis başlamıyor

# Check logs
sudo journalctl -u openclaw -n 100

# Verify permissions
sudo ls -la /opt/openclaw

# Test manual start
sudo -i -u openclaw
cd ~/openclaw
pnpm start

​

Docker sandbox sorunları

# Verify Docker is running
sudo systemctl status docker

# Check sandbox image
sudo docker images | grep openclaw-sandbox

# Build sandbox image if missing
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

​

Sağlayıcı girişi başarısız

sudo -i -u openclaw
openclaw channels login

​

Gelişmiş Yapılandırma

• Security Architecture
• Technical Details
• Troubleshooting Guide

​

İlgili

• openclaw-ansible — tam dağıtım kılavuzu
• Docker — konteynerleştirilmiş gateway kurulumu
• Sandboxing — ajan sandbox yapılandırması
• Multi-Agent Sandbox & Tools — ajan başına yalıtım