أدوات البرمجة
إعداد مزود TokenLab
ربط مثيل OpenClaw المستضاف ذاتياً بـ TokenLab
دع الوكيل الخاص بي يقوم بهذا الإعداد
انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/ar/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.هذا الدليل مخصص لـ OpenClaw المستضاف ذاتياً. إضافة TokenLab هي أسرع طريقة للإعداد؛ يتوفر التكوين اليدوي عندما تحتاج إلى تنسيق API محدد.
تثبيت الإضافة
اختياري: قم بتثبيت إضافة المزود المنشورة 0.1.3. قم بتوفير TOKENLAB_API_KEY من خلال بيئة Gateway الموضحة أدناه واستخدم اختيار النموذج الخاص بالجلسة فقط. يغير معالج إعداد الإضافة النموذج الافتراضي، لذا لا يقوم هذا الدليل بتشغيل openclaw onboard. احتفظ بإدخالات الإضافة والأذونات الحالية. تحقق من الإضافة المثبتة وقائمة النماذج قبل إجراء طلب.
راجع الإمكانيات التي يطلبها المثبت واتبع مطالبات التأكيد الخاصة بالعميل. لا تمنح أذونات غير ذات صلة أو تغير أذونات الإضافات الموجودة.
openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab/model tokenlab/claude-sonnet-5 -s
/model default -sتكوين المزودين يدوياً
استخدم models.providers فقط عندما يحتاج OpenClaw إلى تنسيقات Responses أو Claude Messages أو Gemini أو MiniMax بشكل منفصل. بالنسبة للدردشة العادية، يكفي إدخال tokenlab.
| المزود | OpenClaw api | الأفضل لـ | baseUrl |
|---|---|---|---|
tokenlab | openai-completions | GPT و DeepSeek و Qwen ومعظم المكالمات المتوافقة مع OpenAI | https://api.tokenlab.sh/v1 |
tokenlab-responses | openai-responses | سير عمل OpenAI Responses التي تتوقع دلالات /v1/responses | https://api.tokenlab.sh/v1 |
tokenlab-claude | anthropic-messages | واجهة برمجة تطبيقات Claude Messages الأصلية | https://api.tokenlab.sh |
tokenlab-gemini | google-generative-ai | تنسيق واجهة برمجة تطبيقات Gemini الأصلي | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | نماذج MiniMax عبر تنسيق Messages | https://api.tokenlab.sh |
استخدم اللاحقة /v1 فقط مع openai-completions و openai-responses.
يجب أن تستخدم المزودات الأصلية مثل anthropic-messages و google-generative-ai الرابط https://api.tokenlab.sh بدون /v1، وإلا فقد يقوم OpenClaw بإنشاء مسار مزود خاطئ.
المتطلبات الأساسية
- مثيل OpenClaw مستضاف ذاتياً
- بالنسبة لـ OpenClaw 2026.9.4، استخدم Node.js
>=24.16.0 <25 || >=26.1.0(متطلبات الإصدار). بالنسبة لإصدارات OpenClaw الأخرى، تحقق من متطلبات ذلك الإصدار. - مفتاح API لـ TokenLab — احصل عليه من هنا
التكوين
قم بتحرير ملف تكوين OpenClaw الخاص بك:
- مستضاف ذاتياً:
~/.openclaw/openclaw.json
أضف مزودي TokenLab تحت models.providers:
استخدم نفس الملف الشخصي و OPENCLAW_STATE_DIR و OPENCLAW_CONFIG_PATH مثل Gateway قيد التشغيل. قم بعمل نسخة احتياطية من التكوين النشط قبل الدمج. ضع TOKENLAB_API_KEY في ملف .env العالمي الموثوق به لهذا المثيل أو بيئة الخدمة؛ قد لا يصل تصدير الجهاز الطرفي أو ملف .env الخاص بالمشروع وحده إلى Gateway الذي يعمل في الخلفية. راجع معالجة البيئة.
قم بعمل نسخة احتياطية من التكوين النشط. أضف إدخال TokenLab فقط وحافظ على المزودين الحاليين والحسابات واختيار النموذج الافتراضي والأذونات. إذا كان الاسم مستخدماً بالفعل، فاختر اسماً آخر وقم بتحديث الأوامر. لإلغاء الإعداد، قم بإزالة الإدخال الذي أضفته فقط أو استعد النسخة الاحتياطية السابقة.
{
models: {
mode: "merge",
providers: {
tokenlab: {
api: "openai-completions",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
{ id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" },
{ id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
]
},
"tokenlab-responses": {
api: "openai-responses",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
{ id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
]
},
"tokenlab-claude": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "claude-sonnet-5", name: "Claude Sonnet 5" },
{ id: "claude-opus-5", name: "Claude Opus 5" }
]
},
"tokenlab-gemini": {
api: "google-generative-ai",
baseUrl: "https://api.tokenlab.sh",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "gemini-3.6-flash", name: "Gemini 3.6 Flash" },
{ id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
]
},
"tokenlab-minimax": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "minimax-m3", name: "MiniMax M3" }
]
}
}
}
}يستخدم جميع المزودين الخمسة نفس مفتاح API. تحتاج فقط إلى حساب TokenLab واحد.
تعرض مصفوفات models أعلاه أمثلة شائعة فقط. أضف المزيد من معرفات النماذج لكل مزود حسب الحاجة.
استخدام النماذج
لا يزال OpenClaw يشير إلى النماذج بتنسيق provider/model:
بالنسبة لـ OpenClaw 2026.9.4، اختر النموذج للجلسة الحالية فقط باستخدام -s. حافظ على agents.defaults.model وإعدادات الوكيل الافتراضية والأذونات دون تغيير. استخدم /model default -s لإعادة هذه الجلسة إلى وضعها الافتراضي المكون.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sأمثلة على النماذج
| المزود | مرجع النموذج | الوصف |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | متوافق مع OpenAI (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | Responses API |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | MiniMax عبر Messages |
تصفح جميع النماذج المتاحة على tokenlab.sh/models.
متى تستخدم أي مزود
tokenlab: الخيار الافتراضي لمعظم حالات استخدام الوكيل والدردشة العامة.tokenlab-responses: استخدمه عندما يعتمد سير عمل OpenClaw الخاص بك صراحةً على دلالات OpenAI Responses.tokenlab-claude: استخدمه عندما تريد سلوك Claude Messages الأصلي.tokenlab-gemini: استخدمه عندما تريد تنسيق طلب/استجابة Gemini الأصلي أو عمليات تكامل موجودة بأسلوب Gemini.tokenlab-minimax: استخدمه عندما تريد نماذج MiniMax عبر تنسيق Messages.
إذا كنت لا تحتاج إلى سلوك Gemini الأصلي، فلا يزال بإمكانك استدعاء نماذج Gemini من خلال tokenlab/gemini-* بالتنسيق المتوافق مع OpenAI.
أخطاء شائعة
التحقق من الإعداد
أعد تشغيل ذلك المثيل، ثم افحص النموذج والمزود المختارين. models status بدون --probe لا يجري اختبار استدعاء للنموذج. يمكن أن يستهلك --probe المباشر أو رسالة الدردشة رموزاً (tokens). تحقق من رد حقيقي مقابل طلب TokenLab المطابق قبل إعلان أن الإعداد يعمل. للاستعادة، اختر النموذج السابق وقم بإزالة إدخالات TokenLab التي أضفتها فقط.
openclaw gateway restart
openclaw models statusإنشاء الصور والفيديو في نفس الوكيل
يمكن لـ OpenClaw أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab.
openclaw mcp add tokenlab \
--command npx \
--arg -y \
--arg @tokenlabai/mcp-server@0.6.48 \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlabاحتفظ بعلامات الاقتباس المفردة. يقوم OpenClaw بعد ذلك بتخزين مرجع للمتغير، وليس المفتاح، ويقرأ TOKENLAB_API_KEY من البيئة التي يعمل فيها عند بدء تشغيل الخادم. يسرد الفحص (probe) أدوات TokenLab. ثم جرب:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.يعيد create_video معرف مهمة. يستدعي الوكيل get_task_status حتى يصبح الفيديو جاهزاً.
الخطوات التالية
بمجرد توصيل OpenClaw، تساعدك هذه الأدلة على استخدام TokenLab بشكل أكثر فعالية:
- تنسيقات API — فهم الاختلافات بين مسارات OpenAI و Responses و Anthropic و Gemini
- توافق IDE / SDK — تعرف على متى يكون
/v1/responsesهو الخيار الأفضل - معالجة الأخطاء — تعلم أنماط الفشل الشائعة وأنماط الاسترداد
- نظرة عامة على النماذج — تصفح معرفات النماذج قبل ربطها بالوكلاء