🚀 دمج OpenClaw / Clawdbot مع نماذج CodingPlanX المخصصة

سيرشدك هذا البرنامج التعليمي خلال تثبيت Clawdbot (OpenClaw) وتكوين بروكسي API مخصص، مما يسمح لك باستدعاء نماذج بمرونة مثل GPT-4o و Claude 3.5 و Gemini.

---

🛠️ الخطوة 1: تجهيز البيئة والتهيئة

قبل البدء، يرجى التأكد من تثبيت Node.js على نظامك.

1. تثبيت Clawdbot عالميًا

افتح الطرفية (CMD أو PowerShell) وقم بتشغيل الأمر التالي:

npm i -g clawdbot

2. تشغيل دليل التهيئة

قم بتنفيذ معالج الإعداد لإكمال التكوين الأساسي. اتبع المطالبات التي تظهر على الشاشة:

clawdbot onboard

[!IMPORTANT] ملاحظة لمستخدمي Windows: في بيئة Windows الأصلية، إذا طلب النظام أن openclaw غير معترف به كأمر داخلي، يرجى التأكد من استخدام أمر clawdbot بدلاً من ذلك.

---

⚙️ الخطوة 2: تعديل ملف التكوين الرئيسي clawdbot.json

في هذه الخطوة، سنقوم بتعديل ملف التكوين الرئيسي لتحديد عنوان API للبروكسي وتعيينات النماذج.

مسار الملف: C:\Users\your-username\.clawdbot\clawdbot.json (ملاحظة: استخدم البرنامج التعليمي الأصلي 'Administrator'. يرجى تغيير هذا إلى اسم مستخدم النظام الفعلي الخاص بك)

قم بتعديل أقسام agents و auth و models في الملف بناءً على المرجع التالي:

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\your-username\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

---

🔑 الخطوة 3: تكوين ملف المصادقة auth-profiles.json

في هذه الخطوة، تحتاج إلى إدخال مفاتيح API الفعلية التي تم الحصول عليها من منصة البروكسي.

مسار الملف: C:\Users\your-username\.clawdbot\agents\main\agent\auth-profiles.json

قم بتحديث حقول key ببيانات اعتماد API الخاصة بك:

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-real-gpt-key"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-real-claude-key"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-real-google-key"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

---

🚦 الخطوة 4: التحقق وبدء الخدمة

بمجرد التكوين، تحقق من الخدمة وقم بتشغيلها باستخدام الخطوات التالية.

1. تشغيل فحص الصحة (Health Check)

تحقق مما إذا كان بناء جملة التكوين الخاص بك واتصال الشبكة يعملان بشكل صحيح:

clawdbot doctor

2. بدء خدمة البوابة (Gateway Service)

قم بتشغيل خدمة البوابة لتمكين بروكسي الذكاء الاصطناعي:

clawdbot gateway

3. الوصول إلى وحدة تحكم الويب

1. افتح متصفحك وانتقل إلى: http://127.0.0.1:18789/
2. بيانات اعتماد تسجيل الدخول: استخدم الرمز (Token) الناتج في نهاية خطوة clawdbot onboard لتسجيل الدخول.
3. أنت الآن جاهز لتخصيص واستخدام وكيل الذكاء الاصطناعي (AI Agent) الخاص بك!

---

💡 تلميح: إذا قمت بتبديل مزودي البروكسي في أي وقت، فما عليك سوى تحديث baseUrl في clawdbot.json و key في auth-profiles.json.