نحوه نصب OpenClaw – پلتفرم عامل هوش مصنوعی خودمختار #

این ویزارد تعاملی، ارائه‌دهندگان مدل، ادغام کانال‌ها و تنظیمات امنیتی را در یک جریان ساده پیکربندی می‌کند.

1. دایرکتوری پروژه را ایجاد کنید و به داخل آن بروید.
   consoleCopy

   $ mkdir -p ~/OpenClaw-assistant
   $ cd ~/OpenClaw-assistant

2. مخزن رسمی OpenClaw را کلون کنید و به دایرکتوری کلون شده بروید.
   consoleCopy

   $ git clone https://github.com/OpenClaw/OpenClaw.git
   $ cd OpenClaw

3. اسکریپت راه‌اندازی داکر را اجرا کنید.
   consoleCopy

   $ ./docker-setup.sh
   

   جادوگر تعاملی شما را در این مسیر راهنمایی می‌کند:

   • تصدیق امنیتی: بهترین شیوه‌های امنیتی برای اجرای عامل‌های هوش مصنوعی را بررسی کنید.
   • تنظیمات ارائه‌دهنده مدل: ارائه‌دهنده مدل مورد نظر خود (Anthropic، OpenAI، Google، OpenRouter و غیره) را انتخاب کنید و کلید API خود را وارد کنید یا از طریق OAuth احراز هویت کنید.
   • پیکربندی کانال: پلتفرم‌های پیام‌رسان (Slack، Discord، Telegram، WhatsApp و غیره) را انتخاب کنید و توکن‌های مورد نیاز را وارد کنید.
   • لیست‌های مجاز کانال: پیکربندی کنید که کدام کانال‌ها یا کاربران می‌توانند با ربات تعامل داشته باشند.
   • تنظیم مهارت‌ها: قابلیت‌های اختیاری مانند جستجوی وب، تولید تصویر و موارد دیگر را فعال کنید.
   • راه‌اندازی درگاه: تصویر را می‌سازد، یک توکن درگاه تولید می‌کند و سرویس را آغاز می‌کند.

   
4. با بررسی لاگ‌های کانتینر، از فعال بودن دروازه (gateway) اطمینان حاصل کنید.
   consoleCopy

   $ docker compose logs OpenClaw-gateway

   خروجی، یک راه‌اندازی موفق را نشان می‌دهد:

   [gateway] listening on ws://0.0.0.0:18789

این ویزارد داده‌های پیکربندی و فضای کاری را در مسیر زیر می‌نویسد:

• ~/.OpenClaw/: پیکربندی، اعتبارنامه‌ها و داده‌های جلسه
• ~/.OpenClaw/workspace:فضای کاری عامل (فایل‌های حافظه، مهارت‌ها و غیره)

برای کاربرانی که ترجیح می‌دهند از مرحله‌ی تنظیمات تعاملی صرف نظر کرده و به صورت دستی پیکربندی کنند:

1. ایمیج داکر OpenClaw را بسازید.
   consoleCopy

   $ docker build -t OpenClaw:local -f Dockerfile .

2. یک فایل .env  با پیکربندی خود ایجاد کنید.  YOUR-GATEWAY-TOKEN  را با یک توکن امن و  YOUR-API-KEY را با کلید API ارائه دهنده مدل انتخابی خود جایگزین کنید.
   consoleCopy

   $ nano .env

   پیکربندی زیر را اضافه کنید:

   iniCopy

   OPENCLAW_GATEWAY_TOKEN=YOUR-GATEWAY-TOKEN
   # Add your provider's API key (choose one)
   ANTHROPIC_API_KEY=sk-ant-YOUR-API-KEY
   # OPENAI_API_KEY=sk-YOUR-API-KEY
   # GEMINI_API_KEY=YOUR-API-KEY

3. برای ادغام، توکن‌های کانال را اضافه کنید. این مثال پیکربندی Slack را نشان می‌دهد.  YOUR-APP-TOKEN و  YOUR-BOT-TOKENرا با توکن‌های برنامه Slack خود جایگزین کنید. برای کانال‌های دیگر، به مستندات کانال مراجعه کنید.
   iniCopy

   SLACK_APP_TOKEN=xapp-YOUR-APP-TOKEN
   SLACK_BOT_TOKEN=xoxb-YOUR-BOT-TOKEN

   فایل را ذخیره کنید و ببندید.

   برای دریافت توکن‌های Slack، یک برنامه Slack در api.slack.com/apps ایجاد کنید، حالت Socket Mode را فعال کنید و برنامه را در فضای کاری خود نصب کنید. برای دستورالعمل‌های دقیق، به مستندات کانال Slack مراجعه کنید.

4. درگاه OpenClaw را اجرا کنید.
   consoleCopy

   $ docker compose up -d OpenClaw-gateway

5. پس از پیکربندی، می‌توانید از طریق Slack با OpenClaw تعامل داشته باشید.

   

از یک تونل SSH برای ارسال پورت دروازه به دستگاه محلی خود استفاده کنید. این روش نیازی به پیکربندی اضافی سرور ندارد.

1. OpenClaw را طوری پیکربندی کنید که امکان احراز هویت Control UI را فراهم کند.
   consoleCopy

   $ nano ~/.OpenClaw/OpenClaw.json

   بخش  gateway را پیدا کنید و تنظیمات  controlUiرا اضافه کنید:

   jsonCopy

   "gateway": {
       "controlUi": {
           "allowInsecureAuth": true
       },
       ...
   }

   فایل را ذخیره کنید و ببندید.

2. برای اعمال تنظیمات، گیت‌وی را مجدداً راه‌اندازی کنید.
   consoleCopy

   $ docker compose restart OpenClaw-gateway

3. یک ترمینال روی دستگاه محلی خود باز کنید و یک تونل SSH ایجاد کنید. به جای SERVER-IP ، آدرس IP سرور خود را قرار دهید.
   consoleCopy

   $ ssh -N -L ۱۸۷۸۹:۱۲۷.۰.۰.۱:۱۸۷۸۹ linuxuser@SERVER-IP

   هنگام دسترسی به رابط کاربری کنترل، این ترمینال را باز نگه دارید.

4. رابط کاربری کنترل را در مرورگر خود باز کنید. به جای  YOUR-TOKEN ، توکن مرحله ۱ را قرار دهید.
   httpCopy

   http://localhost:18789/?token=YOUR-TOKEN

Caddy را به عنوان یک پروکسی معکوس با گواهینامه‌های SSL خودکار از Let’s Encrypt پیکربندی کنید. این روش نیاز به یک نام دامنه دارد که به سرور شما اشاره می‌کند.

1. وابستگی‌های مورد نیاز برای افزودن مخازن خارجی را نصب کنید.
   consoleCopy

   $ sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

2. برای تأیید صحت بسته، کلید Caddy GPG را اضافه کنید.
   consoleCopy

   $ curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

3. مخزن رسمی Caddy را به منابع بسته سیستم خود اضافه کنید.
   consoleCopy

   $ curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list

4. لیست بسته‌ها را به‌روزرسانی کنید و Caddy را نصب کنید.
   consoleCopy

   $ sudo apt update
   $ sudo apt install caddy

5. Caddy را به عنوان یک پروکسی معکوس پیکربندی کنید.  OpenClaw.example.com را با دامنه خود جایگزین کنید.
   consoleCopy

   $ sudo nano /etc/caddy/Caddyfile

   پیکربندی زیر را اضافه کنید:

   iniCopy

   OpenClaw.example.com {
       reverse_proxy localhost:۱۸۷۸۹
   }

   فایل Caddyfile را ذخیره کرده و ببندید.

6. اجازه عبور ترافیک HTTP و HTTPS از طریق فایروال. Caddy از پورت‌های ۸۰ (HTTP) و ۴۴۳ (HTTPS) برای سرویس‌دهی به سایت شما و درخواست/تمدید گواهینامه‌های TLS از Let’s Encrypt استفاده می‌کند.
   consoleCopy

   $ sudo ufw allow ۸۰
   $ sudo ufw allow ۴۴۳
   $ sudo ufw reload

7. برای اعمال پیکربندی و دریافت گواهی SSL، Caddy را مجدداً راه‌اندازی کنید.
   consoleCopy

   $ sudo systemctl restart caddy

8. OpenClaw را طوری پیکربندی کنید که به درخواست‌های پروکسی معکوس اعتماد کند.
   consoleCopy

   $ nano ~/.OpenClaw/OpenClaw.json

   بخش  gateway را پیدا کنید و تنظیمات  trustedProxiesو  controlUi را اضافه کنید:

   jsonCopy

   "gateway": {
       "trustedProxies": ["۱۲۷.۰.۰.۱", "۱۷۲.۱۶.۰.۰/۱۲"],
       "controlUi": {
           "allowInsecureAuth": true
       },
       ...
   }

   فایل را ذخیره کنید و ببندید.

9. برای اعمال تغییرات، گیت‌وی را مجدداً راه‌اندازی کنید.
   consoleCopy

   $ docker compose restart OpenClaw-gateway

10. رابط کاربری کنترل (Control UI) را در مرورگر خود باز کنید. به جای OpenClaw.example.com  دامنه خود و به جای  YOUR-TOKENTOKEN توکن مرحله ۱ را قرار دهید.

    https://OpenClaw.example.com/?token=YOUR-TOKEN