Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

دليل OPENCLAW

استخدم RunAPI في OpenClaw.

صِل OpenClaw بـ 250+ من نماذج الذكاء الاصطناعي عبر RunAPI. أنشئ الفيديو والصور والموسيقى والصوت مباشرة من وكيل OpenClaw باستخدام مفتاح API واحد.

احصل على مفتاح API مجاني عرض التوثيق

نسخ الموجه · مفتاح RunAPI واحد · روابط كتالوج النماذج

موجه الإعداد

Configure this OpenClaw workspace to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a model provider named runapi.
- Use baseUrl "https://runapi.ai/v1".
- Use api "openai-completions".
- Register provider-local model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

{
  agents: {
    defaults: {
      model: { primary: "runapi/gpt-5.5" },
      models: {
        "runapi/gpt-5.5": { alias: "RunAPI GPT 5.5" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      runapi: {
        baseUrl: "https://runapi.ai/v1",
        apiKey: "${RUNAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.5",
            name: "RunAPI GPT 5.5",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.5
openclaw

النماذج المتاحة عبر OpenClaw

HappyHorse/happyhorse-1.0-i2v

وصول إلى HappyHorse API لتوليد الفيديو من النص والصور وتحرير الفيديو بدقة 720p/1080p مع مقاطع موجّهة بالشخصيات.

Qwen 2/qwen-2-edit-image

وصول إلى Qwen 2 API لتحويل النص إلى صورة وتحرير الصور من عائلة النماذج المرئية لدى Alibaba.

Producer/fuzz-0.8

وصول إلى Producer API لتوليد موسيقى FUZZ من كلمات أغنية محددة مسبقًا أو موجزات إنتاج لمقطوعات موسيقية آلية.

ElevenLabs/text-to-dialogue-v3

تتيح ElevenLabs عبر RunAPI تحويل النص إلى كلام متعدد اللغات وإنشاء حوار بين عدة متحدثين.

Qwen/qwen3.5-122b-a10b

الوصول إلى Qwen API عبر RunAPI: نماذج اللغة مفتوحة الأوزان Qwen3.5 وQwen3.6 وQwen3-VL وQwen3-Coder-Next عبر Chat Completions المتوافقة مع OpenAI.

Qwen/qwen3.5-27b

الوصول إلى Qwen API عبر RunAPI: نماذج اللغة مفتوحة الأوزان Qwen3.5 وQwen3.6 وQwen3-VL وQwen3-Coder-Next عبر Chat Completions المتوافقة مع OpenAI.

آلية العمل

اتصل في 3 خطوات

إعداد

أضف مفتاح RunAPI API إلى إعدادات OpenClaw. يتيح مفتاح واحد الوصول إلى جميع النماذج.
اختيار النماذج

اختر النماذج التي يمكن لوكيلك استخدامها. صفِّ حسب النمط أو الجودة أو التكلفة.
توليد

يولّد وكيل OpenClaw الوسائط عبر واجهة RunAPI الموحّدة. تُسلَّم النتائج عبر webhook أو الاستعلام الدوري.

حالات الاستخدام

المحتوى المؤتمت

دع OpenClaw ينشئ فيديوهات تسويقية وصور منتجات ومحتوى صوتيًا تلقائيًا.

مسارات عمل متعددة الوسائط

اربط توليد الفيديو والصور والموسيقى في محادثة وكيل واحدة.

توجيه محسّن التكلفة

يمكن لـ OpenClaw مقارنة أسعار النماذج واختيار الخيار الأكثر توفيرًا.

أسئلة إعداد OpenClaw

هل يمكن لـ OpenClaw استخدام RunAPI كمزوّد نماذج مخصّص؟

نعم. يدعم OpenClaw المزوّدين المخصّصين المتوافقين مع OpenAI عبر models.providers. اضبط RunAPI باستخدام base URL ‏/v1، واجعل api بقيمة openai-completions، ثم اختر المرجع المسبوق بالمزوّد في agents.defaults.model.primary.

هل يجب أن يتضمن معرّف النموذج بادئة المزوّد داخل models.providers؟

لا. داخل models.providers.runapi.models، استخدم المعرّف المحلي للمزوّد مثل gpt-5.2. استخدم المرجع المسبوق بالمزوّد runapi/gpt-5.2 عند اختيار النموذج في الإعدادات الافتراضية أو الأوامر في OpenClaw.

أين يجب أن أُخزّن مفتاح API الخاص بـ RunAPI؟

خزّن المفتاح في RUNAPI_API_KEY واقرأه من إعدادات OpenClaw. هذا يبقي بيانات الاعتماد خارج نظام التحكم بالإصدارات ويجعل الإعداد نفسه صالحًا للاستخدام عبر الصدفة المحلية والخوادم والأتمتة.

هل يمكنني إبقاء نماذج OpenClaw الحالية كخيار احتياطي؟

نعم. أبقِ models.mode مضبوطًا على merge وأضِف RunAPI كمزوّد واحد. ستظل المزوّدات الحالية متاحة، ويمكنك إضافة بدائل احتياطية تحت agents.defaults.model.fallbacks عندما تريد سلوك الاسترجاع.

هل يستطيع OpenClaw إنشاء صور عبر RunAPI دون تثبيت مهارات إضافية؟

نعم. يقبل RUNAPI_API_KEY نفسه ونقطة النهاية /v1 التي أعددتها للدردشة طلبات إنشاء الصور أيضاً. حدد نموذجاً مثل flux-kontext-pro أو imagen-4، وسيستدعيه OpenClaw عبر موفر RunAPI الحالي دون مهارة GitHub أو مفتاح API منفصل. راجع صفحة إنشاء الصور في OpenClaw للدليل الكامل.

كيف يعرف وكيل OpenClaw أن مهمة الصور أو الفيديو جاهزة؟

مهام الصور والفيديو والموسيقى غير متزامنة. يعيد RunAPI معرّف مهمة في الاستدعاء الأول. يستعلم وكيل OpenClaw عن نقطة نهاية الحالة حتى تكتمل المهمة، ثم يتلقى رابط المخرجات. تتولى حزمة RunAPI SDK الاستعلام تلقائياً عند استخدامها.

طرق أخرى لتشغيل RunAPI من وكيل

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

Hermes Agent

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

مساعد الفريق

WorkBuddy

امنح مساعد مساحة العمل المشتركة الوصول إلى نماذج الفيديو والصور وLLM مع حدود إنفاق لكل مفتاح.

SDK أو MCP

ابنِ حلك الخاص

صِل أي وكيل بـ SDK الخاص بـ RunAPI أو بـ خادم MCP — الأدوات والاستطلاع وwebhooks مضمنة.

هل تبنون مع فريق؟

نساعدكم في إعداد المؤسسات والتكامل والأسئلة التقنية.

تواصل معنا