دليل عميل OpenClaw الذاتي: البنية المعمارية وDocker والتكاليف

### إجابة سريعة: ما هو OpenClaw وما الذي يميزه؟

يُعد OpenClaw مساعد ذكاء اصطناعي شخصي مستقل ومفتوح المصدر مبني على معمارية Gateway المنفصلة، مع دعم لأكثر من 20 منصة مراسلة وتنفيذ متعدد الوكلاء داخل بيئة معزولة (Sandbox). بخلاف وكلاء SaaS المغلقين بتكلفة 20–50 دولار شهرياً، لا يتطلب OpenClaw أي اشتراك ($0) وتبلغ تكلفة كل مهمة ما بين 0.003 و 0.042 دولار عبر واجهات API المباشرة.

1. نظرة عامة: ماذا يمثل OpenClaw في عام 2026؟

في عام 2026، انتقلت تكنولوجيا وكلاء الذكاء الاصطناعي من نوافذ الدردشة الفردية إلى حلقات تنفيذ ذاتية ومستمرة مدفوعة بالأحداث على مدار 24 ساعة يومياً. وفي حين تركز أدوات مثل Claude Code وOpenAI Codex على بيئة سطر الأوامر (CLI) للمطورين، برز OpenClaw كمنظومة رائدة ومفتوحة المصدر للمساعدين الشخصيين عبر تطبيقات المراسلة، والجداول الزمنية (Cron)، وتنفيذ المهام متعددة الوكلاء المعزولة.

يرتكز OpenClaw على ثلاثة أعمدة رئيسية:

1. بروتوكول البوابة المنفصل (Gateway Protocol): خادم خلفي مركزي يعمل على المنفذ 18789، يدير توجيه القنوات، وحفظ الجلسات، والمهام المجدولة، واستقبال خطافات الويب (Webhooks).
2. تكامل شامل مع أكثر من 20 قناة: دعم أصيل لمنصات Telegram وWhatsApp (Baileys) وDiscord وSlack وSignal وiMessage وMatrix وWebChat.
3. محرك المهارات والأمان الصارم: معيار مهارات بصيغة Markdown (SKILL.md) متصل بمتجر ClawHub، مع عزل كامل عبر حاويات Docker وتجريد صلاحيات POSIX.

2. بنية OpenClaw: البوابة والقنوات وبيئة العمل

تقوم قوة OpenClaw على الفصل بين طبقة التحكم وطبقة التنفيذ. يتواصل الخادم المركزي (OpenClaw Gateway) عبر تقنيات WebSocket ومقابس Unix مع واجهات المستخدم وواجهات برمجة تطبيقات المراسلة.

+-----------------------------------------------------------------------------------+
|                              قنوات المراسلة الخارجية                              |
|   Telegram  |  WhatsApp  |  Discord  |  Slack  |  Signal  |  iMessage  |  Matrix  |
+-----------------------------------------------------------------------------------+
                                          | (Webhook / WebSocket / Bot API)
                                          v
+-----------------------------------------------------------------------------------+
|                            OpenClaw Gateway (Port 18789)                          |
|  - محرك الاقتران وقوائم السماح (Allowlist) - مخزن السياق وحفظ الجلسات             |
|  - مجدول المهام المبرمجة (CronTab)        - توجيه ومعالجة خطافات الويب (Webhooks) |
|  - إعادة التحميل الحي (Hybrid Watch)      - التبديل التلقائي للنماذج (Failover)   |
+-----------------------------------------------------------------------------------+
       |                                      |                              |
       v                                      v                              v
+------------------+                  +------------------+         +-------------------+
|  الوكيل: المنزل  |                  |  الوكيل: العمل   |         |  الوكيل: DevOps   |
|  - Workspace-Home|                  |  - Workspace-Work|         |  - Workspace-Ops  |
|  - SOUL.md       |                  |  - SOUL.md       |         |  - SOUL.md        |
|  - إدارة شخصية   |                  |  - Jira / Linear |         |  - أتمتة السحابة  |
+------------------+                  +------------------+         +-------------------+
       |                                      |                              |
       +--------------------------------------+------------------------------+
                                          |
                                          v
+-----------------------------------------------------------------------------------+
|                       طبقة التنفيذ المعزولة (Multi-Agent Sandbox)                 |
|  - العزل التام عبر حاويات Docker (`mode: non-main` / `mode: all`)                 |
|  - تجريد صلاحيات POSIX بالكامل (`cap_drop: ALL`, مستخدم عادي UID 10001)           |
|  - وحدات تخزين للقراءة فقط (`:ro`) وذاكرة مؤقتة Tmpfs (`/tmp:noexec`)             |
|  - بيئة تشغيل المهارات (`SKILL.md` parser وفحص الحزم التنفيذية)                   |
+-----------------------------------------------------------------------------------+

هيكل مجلد مساحة العمل (Workspace)

~/.openclaw/
├── openclaw.json          # ملف التكوين الرئيسي التقريري (JSON5)
├── cron.json              # المهام المجدولة المسجلة
├── state/                 # قواعد بيانات الجلسات SQLite والرموز
├── skills/                # المهارات العامة المشتركة
└── workspace/             # بيئة عمل الوكيل الافتراضية
    ├── AGENTS.md          # القواعد العامة والتوجيهات السلوكية
    ├── SOUL.md            # شخصية الوكيل ونبرة الحوار والقيود
    ├── TOOLS.md           # إرشادات استخدام الأدوات المحلية
    └── skills/            # مهارات خاصة بمساحة العمل
        └── repo-analyzer/
            └── SKILL.md   # تعريف المهارة التنفيذية

الأوامر الأساسية لإدارة البوابة

# فحص حالة البوابة واستخدام الموارد
openclaw gateway status

# تشغيل البوابة في الخلفية كخادم مستقل
openclaw gateway start

# تشغيل البوابة في المقدمة مع تفاصيل السجلات
openclaw gateway --port 18789 --verbose

# إجراء فحص شامل للنظام والتحقق من التكوين
openclaw doctor

# الإصلاح التلقائي للأذونات والمسارات المفقودة
openclaw doctor --fix

3. دليل النشر في بيئة الإنتاج باستخدام Docker

يمثل منح الوكيل صلاحيات سطر الأوامر على نظام التشغيل المضيف مباشرة خطراً كبيراً. لذا، فإن المعيار الإنتاجي يعتمد على Docker Compose مع شبكات معزولة.

ملف docker-compose.yml الإنتاجي

version: "3.9"

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    user: "10001:10001"
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETUID
      - SETGID
    environment:
      - NODE_ENV=production
      - OPENCLAW_HOME=/home/openclaw/.openclaw
      - OPENCLAW_STATE_DIR=/home/openclaw/.openclaw/state
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_GATEWAY_PASSWORD=${OPENCLAW_GATEWAY_PASSWORD}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
    volumes:
      - openclaw-config:/home/openclaw/.openclaw
      - openclaw-workspace:/home/openclaw/.openclaw/workspace
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "127.0.0.1:18789:18789"
    networks:
      - openclaw-net
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 20s

  openclaw-sandbox:
    image: ghcr.io/openclaw/sandbox-runner:latest
    container_name: openclaw-sandbox
    restart: always
    network_mode: none
    read_only: true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=256m
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    volumes:
      - openclaw-workspace:/workspace:rw
    environment:
      - RUNNER_UID=10001
      - RUNNER_GID=10001

volumes:
  openclaw-config:
    driver: local
  openclaw-workspace:
    driver: local

networks:
  openclaw-net:
    driver: bridge

ملف تكوين openclaw.json

{
  agents: {
    defaults: {
      workspace: "/home/openclaw/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["deepseek/deepseek-chat", "openai/gpt-5.4"],
      },
      thinking: "high",
      sandbox: {
        mode: "non-main", // off | non-main | all
        scope: "agent",   // session | agent | shared
        dockerImage: "ghcr.io/openclaw/sandbox-runner:latest",
        timeoutSeconds: 300,
        memoryLimitMb: 1024,
      },
    },
    list: [
      {
        id: "main",
        default: true,
        workspace: "/home/openclaw/.openclaw/workspace",
      },
      {
        id: "devops",
        workspace: "/home/openclaw/.openclaw/workspace-devops",
        sandbox: { mode: "all" },
      },
    ],
  },
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAFq_example_token_secret",
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["tg:987654321"],
    },
    discord: {
      enabled: true,
      botToken: "MTI4OTexampleDiscordBotToken",
      dmPolicy: "allowlist",
      allowFrom: ["dc:382910394857291029"],
    },
  },
  cron: {
    enabled: true,
    maxConcurrentRuns: 4,
  },
  hotReload: "hybrid",
}

4. تنسيق الوكلاء المتعددين وأمان الصندوق الرملي

سياسات الرسائل المباشرة ودرجات العزل

1. سياسة الرسائل الواردة (DM Policy):

• pairing (الافتراضي): يرسل النظام كود اقتران للمستخدمين الجدد، ولا يتم التفاعل إلا بعد موافقة المدير عبر openclaw pairing approve .
• allowlist: يقتصر التفاعل على الحسابات المسجلة في القائمة البيضاء allowFrom.
• open: متاح للجميع (موصى به لروبوتات الدعم العام فقط مع فرض وضع all).
• disabled: تعطيل الرسائل المباشرة واقتصار النظام على الإشعارات المجدولة.

---
name: github-pr-analyzer
description: فحص طلبات السحب في GitHub وتشغيل الاختبارات وصياغة تقرير المراجعة.
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["gh", "jq", "git"],
      "env": ["GITHUB_TOKEN"],
      "config": ["sandbox.enabled"]
    },
    "os": ["linux", "darwin"],
    "always": false,
    "primaryEnv": "GITHUB_TOKEN"
  }
}
---

# مهارة تحليل طلبات سحب GitHub

عند الاستدعاء من قبل المستخدم أو عبر خطاف ويب:
1. استخراج الفروقات عبر الأمر `gh pr diff <pr_number>`.
2. فحص الملفات المعدلة وقياس تغطية الاختبارات.
3. كتابة تقرير منظم بصيغة Markdown مع اقتباس سطور الأكواد البرمجية.

# استعراض المهارات المتاحة
openclaw skills list

# تثبيت مهارة موثقة من ClawHub
openclaw skills install web-researcher

# تثبيت مهارة مباشرة من مستودع GitHub
openclaw skills install git:github.com/openclaw-community/postgres-inspector@v1.4.0

# فحص التوقيع الرقمي والصلاحيات للمهارة
openclaw skills verify web-researcher

# تحديث كافة المهارات المثبتة
openclaw skills update --all

# التحقق من حالة الخادم والجلسات النشطة
openclaw gateway status

# مراقبة السجلات الحية أثناء التشغيل
openclaw logs --follow --lines 50

# التأكد من صحة إعدادات التكوين
openclaw config validate

# تكليف الوكيل بمهمة تتطلب تفكيراً استنتاجياً عميقاً
openclaw agent --message "قم بمراجعة أمنية شاملة لتبعيات المشروع الحالي" --thinking high

# إرسال إشعار مباشر إلى محادثة تيليجرام
openclaw message send --target "tg:987654321" --message "اكتملت خطة النشر بنجاح."