راهنمای کامل نصب و مدیریت OpenCLAW بر روی سرور

OpenCLAW پلتفرمی متن‌باز است که برای ایجاد و مدیریت کانال‌های پیام‌رسان (مانند واتس‌اپ و تلگرام) بر روی سرور طراحی شده است. البته کارایی این سرویس به همین جا ختم نمی‌شود؛ با کمک OpenCLAW شما یک دستیار هوش مصنوعی خواهید داشت که به‌صورت ۲۴ ساعته و بدون وقفه به پیام‌ها پاسخ می‌دهد. این پلتفرم امکان ارسال پیام‌های خودکار و مدیریت ارتباطات را برای کسب‌وکارها و توسعه‌دهندگان فراهم می‌کند. جالب است بدانید که این پلتفرم در گذشته با نام‌های Moltbot یا Clawdbot شناخته می‌شد. در این راهنما از بخش آموزش سرور، ما گام‌به‌گام نحوه نصب و مدیریت OpenCLAW بر روی سرور را بررسی خواهیم کرد و به شما کمک خواهیم کرد تا بتوانید این پلتفرم را به راحتی راه‌اندازی و مدیریت کنید.

کاربردهای OpenClaw

قبل از آن‌که مراحل نصب این پلتفرم و استفاده از آن را بررسی کنیم، بهتر است نگاهی کوتاه به کاربردهای بی‌نظیر آن داشته باشیم. در این بخش برخی از مهم‌ترین کاربردهای OpenClaw را معرفی می‌کنیم:

• پاسخ‌گویی خودکار و شبانه‌روزی در پیام‌رسان‌ها
• پشتیبانی هوشمند کاربران و مشتریان
• دستیار شخصی یا کاری برای نوشتن و تحلیل
• آموزش تعاملی و پاسخ به پرسش‌ها

پیش‌نیازهای نصب OpenClaw روی سرور

برای نصب و راه‌اندازی اغلب برنامه‌ها شما نیاز به رعایت یکسری پیش‌نیاز دارید. در مورد نصب OpenClaw هم این مسئله صدق می‌کنید. پیش‌نیازهای نصب این سرویس شامل موارد زیر هستند:

• سیستم‌عامل لینوکس (ترجیحا Ubuntu نسخه 22.04 یا 24.04)
• دسترسی مدیریتی (root یا sudo)
• نصب Docker و Docker Compose
• حداقل ۲ الی ۴ گیگابایت رم
• حداقل ۱۰ گیگابایت فضای ذخیره‌سازی برای ایمیج‌های Docker، داده‌ها و لاگ‌ها

مراحل نصب و راه‌اندازی OpenClaw

۱. آماده‌سازی سرور

در این مرحله، ابتدا باید سیستم خود را به‌روزرسانی کنید و ابزارهای پایه مانند SSH و Git را نصب نمایید.
برای به‌روزرسانی سیستم از دستور زیر استفاده کنید:

sudo apt update && sudo apt upgrade -y

اگر Git بر روی سرور شما نصب نیست، آن را با دستور زیر نصب کنید:

sudo apt install git -y

همچنین برای نصب SSH هم می‌توانید دستور زیر را استفاده کنید:

sudo apt install openssh-server -y

۲. نصب و پیکربندی Docker

Docker ابزاری است که OpenClaw از طریق آن اجرا می‌شود. می‌توان Docker را به‌عنوان یک محیط کانتینری در نظر گرفت که تمام وابستگی‌ها و اجزای موردنیاز OpenClaw را در یک بسته منسجم قرار می‌دهد. برای نصب Docker روی Ubuntu باید مراحل زیر را طی کنید:

مرحله ۱: حذف نسخه‌های قدیمی Docker (در صورت وجود)

sudo apt remove docker docker-engine docker.io containerd runc

مرحله ۲: به‌روزرسانی فهرست بسته‌ها و نصب پیش‌نیازها:

sudo apt update
sudo apt install ca-certificates curl gnupg lsb-release

مرحله ۳: افزودن کلید GPG رسمی Docker با کد زیر:

sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

مرحله ۴: افزودن مخزن رسمی Docker به کمک دستور زیر:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

مرحله ۵: نصب Docker و Docker Compose با کد:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

مرحله ۶: بررسی صحت نصب Docker با کدهای زیر:

docker --version
docker compose version

همچنین، می‌توانید با اجرای دستور زیر از صحت نصب مطمئن شوید:

sudo docker run hello-world

۳. کلون کردن و پیکربندی کد منبع

حالا که Docker و Docker Compose نصب شدند، باید کد منبع OpenCLAW را از گیت‌هاب کلون کنید.
اگر Git روی سیستم شما نصب نشده ‌است، با دستور زیر نصب Git را انجام دهید:

sudo apt install git -y

برای کلون کردن ریپازیتوری OpenCLAW ابتدا به دایرکتوری مورد نظر بروید و سپس کد منبع را کلون کنید:

git clone https://github.com/OpenCLAW/OpenCLAW.git

سپس با دستور زیر به فولدر پروژه وارد شوید:

cd OpenCLAW

پس از ورود به پوشه پروژه، اسکریپت راه‌اندازی Docker را اجرا کنید. OpenClaw یک اسکریپت اختصاصی دارد که تقریباً تمام مراحل راه‌اندازی را به‌صورت خودکار انجام می‌دهد:

./docker-setup.sh

۴. پیکربندی اطلاعات دسترسی و تنظیمات OpenClaw

حالا شما باید پیکربندی تنظیمات پیش‌فرض OpenCLAW و Credentials را انجام دهید. برای این منظور، فایل `.env` را در دایرکتوری پروژه ویرایش کنید:

cp .env.example .env
nano .env

در این فایل، باید اطلاعات مربوط به API Keys و تنظیمات مرتبط با کانال‌های پیام‌رسان را وارد کنید.

۵. اجرای OpenCLAW

حالا که پیکربندی‌ها انجام شد، وقت آن است که OpenCLAW را راه‌اندازی کنید. برای اطمینان از اجرای صحیح، وضعیت کانتینرها را بررسی کنید:

cd ~/openclaw
docker compose ps

در خروجی، باید کانتینری با نام openclaw-gateway را با وضعیت Up یا Running مشاهده کنید.

sudo docker-compose up -d

دسترسی و تعامل با OpenCLAW

شاید بپرسید که پس از اجرای فرایند نصب چگونه از OpenClaw استفاده کنیم؟ در ادامه به صورت گام‌به‌گام نحوه دسترسی و تعامل با OpenCLAW را بررسی می‌کنیم:

دسترسی به رابط کاربری (UI)

برای دسترسی به رابط کاربری OpenCLAW، کافی است آدرس آی‌پی سرور خود را در مرورگر وارد کنید و به پورت مناسب (معمولاً 8080) دسترسی پیدا کنید:
http://<your-server-ip>:8080

اتصال کانال‌های پیام‌رسان

در بخش تنظیمات OpenCLAW، می‌توانید کانال‌های پیام‌رسان مختلف (مانند واتس‌اپ، تلگرام و …) را به پلتفرم متصل کنید. برای هر یک از این سرویس‌ها، باید اطلاعات API Keys را وارد کنید که در گام‌های قبلی دریافت کرده‌اید.

امنیت و ملاحظات عملیاتی

برای اطمینان از امنیت سیستم و جلوگیری از دسترسی‌های غیرمجاز، توصیه می‌شود که دسترسی به پورت‌های سرور را محدود کنید و از فایروال‌ها برای کنترل دسترسی استفاده کنید. همچنین، برای اطلاعات حساس مانند API Keys، باید از روش‌های رمزنگاری مناسب استفاده شود.

نحوه رفع مشکلات رایج راه‌اندازی و نصب OpenClaw

در این بخش نوبت به بررسی مشکلات رایج در نصب و استفاده از OpenClaw می‌رسد. سپس راه‌حل مناسب برای رفع هر یک از آن‌ها را ارائه می‌دهیم.

خطاهای مربوط به کلیدهای API

اگر هنگام اتصال به کانال‌های پیام‌رسان با خطا مواجه شدید، ابتدا کلیدهای API را بررسی کنید و از صحت آن‌ها اطمینان حاصل کنید. همچنین، مطمئن شوید که محدودیت‌هایی از سمت سرویس‌دهنده وجود ندارد.

تداخل پورت

اگر در زمان راه‌اندازی با مشکل تداخل پورت روبه‌رو شدید، بررسی کنید که پورت‌های مورد نیاز (معمولاً 8080 و 443) در سرور شما آزاد باشند.

حلقه‌های راه‌اندازی مجدد کانتینر

در صورتی که کانتینرهای Docker در حال راه‌اندازی مجدد مداوم باشند، می‌توانید با بررسی لاگ‌ها و خطاهای نمایش داده‌شده، مشکل را شناسایی کرده و رفع کنید. برای مشاهده لاگ‌های کانتینر از کد زیر استفاده کنید:

docker-compose logs

عدم دسترسی به رابط کاربری

اگر به رابط کاربری OpenCLAW دسترسی ندارید، با کد زیر مطمئن شوید که سرویس‌ها به درستی در حال اجرا هستند:

docker-compose ps
Restarting safely

برای راه‌اندازی مجدد سرویس‌ها به‌طور ایمن، از دستور زیر استفاده کنید:

docker-compose down
docker-compose up -d

نکات مدیریت و نگهداری پس از نصب

حالا که مراحل نصب را پشت سر گذاشته‌اید، برخی نکات در مورد مدیریت و نگه‌داری این سرویس وجود دارد که در ادامه آن‌ها را بررسی می‌کنیم:

به‌روزرسانی منظم:

توصیه می‌شود که به‌روزرسانی‌های جدید Docker و OpenCLAW را به‌طور منظم بررسی کرده و آن‌ها را نصب کنید تا از آسیب‌پذیری‌های امنیتی جلوگیری کنید.

پشتیبان‌گیری:

از داده‌های مهم و تنظیمات OpenCLAW به‌طور منظم یک نسخه پشتیبان تهیه کنید.

نظارت بر عملکرد:

استفاده از ابزارهای نظارتی مانند `docker stats` برای نظارت بر مصرف منابع و عملکرد سرویس‌ها بسیار مفید خواهد بود.

جمع‌بندی

در این راهنما، گام به گام نحوه نصب و پیکربندی OpenCLAW بر روی سرور را بررسی کردیم. همچنین، به مشکلات رایج نصب و نحوه رفع آن‌ها پرداخته‌ایم. با پیروی از این دستورالعمل‌ها، می‌توانید پلتفرم OpenCLAW را به‌راحتی راه‌اندازی کرده و به‌طور موثر از آن استفاده کنید.