CoreAPI × OpenClaw

تكوين
OpenClaw
عبر CoreAPI

استخدم CoreAPI كموفر نموذج مخصص لـ OpenClaw: واجهة برمجة تطبيقات واحدة، والعديد من نموذج بقائمة الأسعار الرسمية. يتبع هذا الدليل مسار الإعداد الحالي لـ OpenClaw (2026.3.8+) ويغطي التثبيت وتكوين الموفر والتحقق وتبديل النموذج.

دليل التكامل الحصول على مفتاح API لـ CoreAPI

~/.openclaw/openclaw.json

# نموذج فقط—تحقق من إصدار OpenClaw الخاص بك قبل الإنتاج
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "coreapi-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "coreapi-openai": {
        "baseUrl": "https://unixcore.io/v1",
        "apiKey": "${COREAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
      },
      "coreapi-claude": {
        "baseUrl": "https://unixcore.io",
        "apiKey": "${COREAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
      }
    }
  }
}

00 — ابدأ هنا

نطاق الدليل
والمتطلبات الأساسية

نظرة عامة على الدليل

تكوين OpenClaw مع CoreAPI

استخدم CoreAPI كموفر نموذج مخصص لـ OpenClaw للوصول إلى العديد من نموذج في واجهة برمجة تطبيقات واحدة بأسعار القائمة الرسمية. تتبع هذه الصفحة مسار الإعداد الحالي لـ OpenClaw (2026.3.8+).

وثائق OpenClaw تكوين البوابة

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

يتطلب Node.js >= 22 ومفتاح API لـ CoreAPI. لتثبيتات daemon، احفظ COREAPI_KEY في ~/.openclaw/.env حتى يتمكن openclaw.json من الرجوع إلى $COREAPI_KEY دون ترميز الأسرار بشكل ثابت.

وثائق CoreAPI

الأوامر السريعة

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

بعد الإضافة ~/.openclaw/.env أو تعديل تكوين المزود، أعد التشغيل مرة واحدة باستخدام openclaw gateway restart، ثم قم بتشغيل التشخيصات. استخدم مراجع provider/model الكاملة في جميع الأوامر والجلسات. للتحقق من انجراف الإصدار، راجع مرجع التكوين.

01 — ملاحظات إعداد المزود

لماذا مزودان
لمفتاح CoreAPI واحد

توجيه المزود بناءً على شكل API

يوجّه OpenClaw بحسب توافق API (وليس فقط تصنيف المورد)، لذا استخدم مزودين منفصلين لـ openai-completions و anthropic-messages.

مفتاح واحد، تكوين متعدد المزودين

احتفظ بـ COREAPI_KEY واحد وأعد استخدامه في كتل coreapi-openai و coreapi-claude. استخدم مراجع provider/model الصريحة في كل مكان.

التحقق من التدفق الحالي

شغّل الإعداد مرة واحدة، وأعد تشغيل البوابة بعد التغييرات، ثم تحقق باستخدام models status وقائمة models list محددة النطاق للمزود وتشخيصات doctor.

02 — ربطه بـ OpenClaw

التثبيت والإعداد والتكوين
والتحقق والتبديل

ملاحظات خاصة بالإصدار

يستخدم OpenClaw ~/.openclaw/openclaw.json كتكوين المصدر الذي تحرره. يتم تجسيد المزودين المخصصين في ملفات models.json لكل وكيل تحت ~/.openclaw/agents/<agentId>/. أعد التحقق من المفاتيح والسلوك بعد الترقيات باستخدام أدلة مرجع التكوين و متغيرات البيئة . تعامل مع عناوين URL الأساسية لـ CoreAPI كما هو محدد فقط في الوثائق الحية.

01 تثبيت أو تحديث OpenClaw

موصى به: curl -fsSL https://openclaw.ai/install.sh | bash. أو npm install -g openclaw@latest إذا كنت تحتفظ بتثبيت npm عالمي.

02 تشغيل الإعداد مرة واحدة

تشغيل: openclaw onboard --install-daemon. في Model/Auth اختر Skip للتثبيت الأساسي، احتفظ بمساحة العمل الافتراضية ما لم يكن ضرورياً، ودع المعالج ينهي daemon والفحص الصحي.

03 تخزين COREAPI_KEY

لتثبيتات daemon، أضف COREAPI_KEY إلى ~/.openclaw/.env ونفّذ chmod 600. استمر في استخدام سير عمل الأسرار shell/الخدمة إذا كان لديك واحد بالفعل.

04 إضافة مزودي {brand} في openclaw.json

أضف coreapi-openai (openai-completions) و coreapi-claude (anthropic-messages)، ثم اضبط primary على coreapi-claude/claude-sonnet-4-5-20250929.

05 إعادة التشغيل والتحقق

شغّل openclaw gateway restart، ثم openclaw models status و openclaw models list --provider coreapi-claude و openclaw doctor. لا تُتوقع أخطاء في مخطط التكوين/المصادقة لمزودي CoreAPI.

06 تبديل النماذج باستخدام provider/model

اضبط الافتراضي باستخدام openclaw models set coreapi-claude/claude-sonnet-4-5-20250929. في الدردشة، بدّل عبر /model coreapi-openai/deepseek-flash.

07 إعادة تثبيت نظيف اختياري

لإصلاح إعداد قديم تالف: أوقف البوابة، وأزل ~/.openclaw، وأعد تشغيل الإعداد، ثم أعد تطبيق تكوين CoreAPI. هذا يعيد ضبط التكوين المحلي والجلسات والسجلات وحالة المصادقة.

مقتطف التكوين (للدمج في openclaw.json)

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "coreapi-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "coreapi-openai": {
        "baseUrl": "https://unixcore.io/v1",
        "apiKey": "${COREAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
      },
      "coreapi-claude": {
        "baseUrl": "https://unixcore.io",
        "apiKey": "${COREAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
      }
    }
  }
}

الإعداد الأساسي لا يتطلب إنشاء auth-profiles.jsonيدوياً. استخدم ${COREAPI_KEY} في المزودين وحقن المتغير عبر ~/.openclaw/.envأو shell أو مدير الخدمات.

03 — أسعار مرجعية

الأسعار الحية على
موقع CoreAPI

يستخدم الجدول أدناه أرقامًا توضيحية لكل مليون رمز مميز. يتبع كتالوج النماذج والتسعير واتفاقيات مستوى الخدمة شروط CoreAPI الحالية. وثائق وكونسول CoreAPI يعرضه الآن.

عرض الأسعار الحالية تقدير التكلفة الشهرية

04 — الأسئلة الشائعة

تحقق من هذه
قبل التكامل

هل أحتاج auth-profiles.json لهذا الإعداد؟

لا للإعداد الأساسي. يمكن لـ OpenClaw حل apiKey المزود من models.providers.*.apiKey عبر $COREAPI_KEY. استخدم auth-profiles.json فقط للأسرار المخزنة لكل ملف تعريف أو الدوران.

لماذا توجد إدخالان لمزود واحد؟

يوجّه OpenClaw بحسب توافق تنسيق API. احتفظ بإدخالات منفصلة لـ openai-completions و anthropic-messages.

أين يتم تحرير التكوين وتجسيده فعلياً؟

حرّر ~/.openclaw/openclaw.json. يتم تجسيد المزودين المخصصين في models.json لكل وكيل تحت ~/.openclaw/agents/<agentId>/ بعد المزامنة/التحميل.

ما معرّفات النماذج المستخدمة في هذا الدليل؟

deepseek-flash و claude-sonnet-4-5-20250929. يمكنك إضافة أي نموذج من صفحة نماذج CoreAPI إلى كتلة المزود المقابلة.

روابط ذات صلة

تكوينOpenClawعبر CoreAPI

نطاق الدليلوالمتطلبات الأساسية