إعداد OpenClaw

يشرح هذا الدليل كيفية تثبيت وتكوين وكيل OpenClaw على خادم RoqueOS الخاص بك.

---

المتطلبات الأساسية

المتطلبات

• خادم RoqueOS مثبت وقيد التشغيل (انظر التثبيت)
• Docker مع صلاحية الوصول إلى المقبس (Socket) (/var/run/docker.sock)
• مفتاح API من مزود ذكاء اصطناعي (OpenAI أو Anthropic)
• ذاكرة عشوائية (RAM) لا تقل عن 4 جيجابايت على الخادم (يوصى بـ 8 جيجابايت)

---

1. تنزيل صورة OpenClaw

يعمل OpenClaw كحاوية Docker منفصلة. قم بتنزيل الصورة الرسمية:

docker pull roqueribeiro1988/roqueos-openclaw:latest

تتضمن الصورة:

• Ubuntu 22.04
• سطح مكتب XFCE
• TigerVNC + noVNC
• متصفح Chromium
• Node.js 20
• وكيل OpenClaw

---

2. تكوين مفتاح الـ API

في ملف docker-compose.yml الخاص بخادم RoqueOS، أضف متغيرات البيئة الخاصة بمفتاح الذكاء الاصطناعي:

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Riyadh
      - OPENAI_API_KEY=sk-your-key-here

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Riyadh
      - ANTHROPIC_API_KEY=sk-ant-your-key-here

الأمان

لا تقم أبدًا برفع (Commit) مفاتيح API الخاصة بك إلى المستودعات العامة. استخدم ملف .env لتخزين الأسرار وأشر إليه باستخدام env_file: .env في ملف compose.

مثال باستخدام ملف .env:

# .env (لا تقم برفعه إلى git!)
OPENAI_API_KEY=sk-your-key-here

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. التحقق من التكوين

بعد إعادة تشغيل الخادم باستخدام docker compose down && docker compose up -d، تحقق من إمكانية الوصول إلى وحدة الوكيل:

curl http://localhost:27021/agent/sessions

الاستجابة المتوقعة:

[]

---

4. الوصول إلى الوكيل من الواجهة الأمامية

1. افتح RoqueOS وتأكد من اتصالك بالخادم.
2. في لوحة الإطلاق (Launchpad)، ابحث عن تطبيق AI Agent (أيقونة OpenClaw).
3. سيتم فتح التطبيق مع واجهة الدردشة ولوحة معاينة سطح المكتب.

---

المنافذ المستخدمة

المنفذ	البروتوكول	الوصف
27021	HTTP/WS	واجهة برمجة تطبيقات خادم RoqueOS (API) و WebSocket
5901	VNC	سطح مكتب VNC لحاوية OpenClaw
6080	HTTP	noVNC (وصول الويب إلى سطح المكتب)

تتم إدارة المنافذ 5901 و 6080 داخليًا بواسطة الخادم ولا تحتاج إلى أن تكون مكشوفة للخارج.

---

متغيرات البيئة المتاحة

المتغير	الوصف	الافتراضي
OPENAI_API_KEY	مفتاح API لـ OpenAI	—
ANTHROPIC_API_KEY	مفتاح API لـ Anthropic	—
AGENT_MAX_SESSIONS	الحد الأقصى للجلسات المتزامنة	3
AGENT_TIMEOUT	مهلة الجلسة بالدقائق	30

---

الخطوات التالية

• كيفية استخدام OpenClaw — دليل عملي وأمثلة