---
read_when:
    - به استقرار خودکار سرور با سخت‌سازی امنیتی نیاز دارید
    - به راه‌اندازی ایزوله‌شده با فایروال و دسترسی VPN نیاز دارید
    - در حال استقرار روی سرورهای راه دور Debian/Ubuntu هستید
summary: نصب خودکار و سخت‌سازی‌شده OpenClaw با Ansible، VPN ‏Tailscale و جداسازی فایروال
title: Ansible
x-i18n:
    generated_at: "2026-06-27T17:57:03Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 03eb6f40139d7e154eee92a7a1a67471da90b128cc90daf86fbc87e383a5297c
    source_path: install/ansible.md
    workflow: 16
---

OpenClaw را با **[openclaw-ansible](https://github.com/openclaw/openclaw-ansible)** در سرورهای تولید مستقر کنید -- یک نصب‌کننده خودکار با معماری امنیت‌محور.

<Info>
مخزن [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) منبع حقیقت برای استقرار Ansible است. این صفحه یک مرور سریع است.
</Info>

## پیش‌نیازها

| نیازمندی | جزئیات                                                   |
| ----------- | --------------------------------------------------------- |
| **سیستم‌عامل**      | Debian 11+ یا Ubuntu 20.04+                               |
| **دسترسی**  | امتیازهای root یا sudo                                   |
| **شبکه** | اتصال اینترنت برای نصب بسته‌ها              |
| **Ansible** | 2.14+ (به‌صورت خودکار توسط اسکریپت شروع سریع نصب می‌شود) |

## چه چیزی دریافت می‌کنید

- **امنیت با اولویت فایروال** -- جداسازی UFW + Docker (فقط SSH + Tailscale قابل دسترسی است)
- **VPN مبتنی بر Tailscale** -- دسترسی راه دور امن بدون عمومی کردن سرویس‌ها
- **Docker** -- کانتینرهای sandbox جداشده، اتصال‌ها فقط روی localhost
- **دفاع چندلایه** -- معماری امنیتی ۴ لایه
- **یکپارچه‌سازی Systemd** -- شروع خودکار هنگام بوت با سخت‌سازی
- **راه‌اندازی با یک دستور** -- استقرار کامل در چند دقیقه

## شروع سریع

نصب با یک دستور:

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

## چه چیزهایی نصب می‌شود

playbook مربوط به Ansible موارد زیر را نصب و پیکربندی می‌کند:

1. **Tailscale** -- VPN مش برای دسترسی راه دور امن
2. **فایروال UFW** -- فقط پورت‌های SSH + Tailscale
3. **Docker CE + Compose V2** -- برای backend پیش‌فرض sandbox عامل
4. **Node.js 24 + pnpm** -- وابستگی‌های زمان اجرا (Node 22 LTS، در حال حاضر `22.19+`، همچنان پشتیبانی می‌شود)
5. **OpenClaw** -- مبتنی بر میزبان، نه کانتینری
6. **سرویس Systemd** -- شروع خودکار با سخت‌سازی امنیتی

<Note>
Gateway مستقیما روی میزبان اجرا می‌شود (نه در Docker). sandbox کردن عامل
اختیاری است؛ این playbook چون Docker، backend پیش‌فرض sandbox است، آن را نصب
می‌کند. برای جزئیات و backendهای دیگر، [Sandboxing](/fa/gateway/sandboxing) را ببینید.
</Note>

## راه‌اندازی پس از نصب

<Steps>
  <Step title="رفتن به کاربر openclaw">
    ```bash
    sudo -i -u openclaw
    ```
  </Step>
  <Step title="اجرای راهنمای شروع">
    اسکریپت پس از نصب شما را در پیکربندی تنظیمات OpenClaw راهنمایی می‌کند.
  </Step>
  <Step title="اتصال ارائه‌دهندگان پیام‌رسانی">
    به WhatsApp، Telegram، Discord، یا Signal وارد شوید:
    ```bash
    openclaw channels login
    ```
  </Step>
  <Step title="تایید نصب">
    ```bash
    sudo systemctl status openclaw
    sudo journalctl -u openclaw -f
    ```
  </Step>
  <Step title="اتصال به Tailscale">
    برای دسترسی راه دور امن به مش VPN خود بپیوندید.
  </Step>
</Steps>

### دستورهای سریع

```bash
# 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
```

## معماری امنیتی

استقرار از یک مدل دفاعی ۴ لایه استفاده می‌کند:

1. **فایروال (UFW)** -- فقط SSH (22) + Tailscale (41641/udp) به‌صورت عمومی در معرض دسترسی هستند
2. **VPN (Tailscale)** -- Gateway فقط از طریق مش VPN قابل دسترسی است
3. **جداسازی Docker** -- زنجیره iptables مربوط به DOCKER-USER از قرار گرفتن پورت‌های خارجی در معرض دسترسی جلوگیری می‌کند
4. **سخت‌سازی Systemd** -- NoNewPrivileges، PrivateTmp، کاربر بدون امتیاز

برای تایید سطح حمله خارجی خود:

```bash
nmap -p- YOUR_SERVER_IP
```

فقط پورت 22 (SSH) باید باز باشد. همه سرویس‌های دیگر (Gateway، Docker) قفل شده‌اند.

Docker برای sandboxهای عامل (اجرای ابزار جداشده) نصب می‌شود، نه برای اجرای خود Gateway. برای پیکربندی sandbox، [Multi-Agent Sandbox and Tools](/fa/tools/multi-agent-sandbox-tools) را ببینید.

## نصب دستی

اگر کنترل دستی را به خودکارسازی ترجیح می‌دهید:

<Steps>
  <Step title="نصب پیش‌نیازها">
    ```bash
    sudo apt update && sudo apt install -y ansible git
    ```
  </Step>
  <Step title="کلون کردن مخزن">
    ```bash
    git clone https://github.com/openclaw/openclaw-ansible.git
    cd openclaw-ansible
    ```
  </Step>
  <Step title="نصب مجموعه‌های Ansible">
    ```bash
    ansible-galaxy collection install -r requirements.yml
    ```
  </Step>
  <Step title="اجرای playbook">
    ```bash
    ./run-playbook.sh
    ```

    همچنین می‌توانید آن را مستقیما اجرا کنید و سپس اسکریپت راه‌اندازی را بعدا به‌صورت دستی اجرا کنید:
    ```bash
    ansible-playbook playbook.yml --ask-become-pass
    # Then run: /tmp/openclaw-setup.sh
    ```

  </Step>
</Steps>

## به‌روزرسانی

نصب‌کننده Ansible، OpenClaw را برای به‌روزرسانی‌های دستی راه‌اندازی می‌کند. برای جریان استاندارد به‌روزرسانی، [Updating](/fa/install/updating) را ببینید.

برای اجرای دوباره playbook مربوط به Ansible (مثلا برای تغییرات پیکربندی):

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

این کار idempotent است و اجرای چندباره آن امن است.

## عیب‌یابی

<AccordionGroup>
  <Accordion title="فایروال اتصال من را مسدود می‌کند">
    - مطمئن شوید ابتدا از طریق VPN مبتنی بر Tailscale دسترسی دارید
    - دسترسی SSH (پورت 22) همیشه مجاز است
    - Gateway بنا به طراحی فقط از طریق Tailscale قابل دسترسی است

  </Accordion>
  <Accordion title="سرویس شروع نمی‌شود">
    ```bash
    # Check logs
    sudo journalctl -u openclaw -n 100

    # Verify permissions
    sudo ls -la /opt/openclaw

    # Test manual start
    sudo -i -u openclaw
    cd ~/openclaw
    openclaw gateway run
    ```

  </Accordion>
  <Accordion title="مشکلات sandbox در Docker">
    ```bash
    # Verify Docker is running
    sudo systemctl status docker

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

    # Build sandbox image if missing (requires source checkout)
    cd /opt/openclaw/openclaw
    sudo -u openclaw ./scripts/sandbox-setup.sh
    # For npm installs without a source checkout, see
    # https://docs.openclaw.ai/gateway/sandboxing#images-and-setup
    ```

  </Accordion>
  <Accordion title="ورود ارائه‌دهنده ناموفق است">
    مطمئن شوید که به‌عنوان کاربر `openclaw` اجرا می‌کنید:
    ```bash
    sudo -i -u openclaw
    openclaw channels login
    ```
  </Accordion>
</AccordionGroup>

## پیکربندی پیشرفته

برای معماری امنیتی و عیب‌یابی تفصیلی، مخزن openclaw-ansible را ببینید:

- [معماری امنیتی](https://github.com/openclaw/openclaw-ansible/blob/main/docs/security.md)
- [جزئیات فنی](https://github.com/openclaw/openclaw-ansible/blob/main/docs/architecture.md)
- [راهنمای عیب‌یابی](https://github.com/openclaw/openclaw-ansible/blob/main/docs/troubleshooting.md)

## مرتبط

- [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) -- راهنمای کامل استقرار
- [Docker](/fa/install/docker) -- راه‌اندازی Gateway کانتینری
- [Sandboxing](/fa/gateway/sandboxing) -- پیکربندی sandbox عامل
- [Multi-Agent Sandbox and Tools](/fa/tools/multi-agent-sandbox-tools) -- جداسازی برای هر عامل