إذا كنت ترغب في جعل OpenClaw قادراً على استدعاء أقوى نموذج لتوليد الصور من OpenAI وهو gpt-image-2 مباشرة، فما هي أول خطوة ستخطر ببالك؟ أغلب المطورين سيفكرون فوراً في فتح محرر الأكواد، وكتابة سكربت Python باستخدام requests.post(...) ثم تغليفه كدالة أداة (Tool function) وتزويد الوكيل (Agent) بها.
هذا المسار ليس مستحيلاً، لكنه سيوقعك في أربع مشكلات فورية:
- الحاجة للتعامل مع رفع الصور المرجعية بصيغة
multipart/form-data. - كتابة منطق خاص لإدارة إعادة المحاولة (Retry)، والمهلة الزمنية (Timeout)، وتجاوز حدود الاستخدام (429 Rate Limiting).
- كتابة حزمة برمجية منفصلة لكل سيناريو (تحويل النص إلى صورة، تحويل صورة إلى صورة، الأقنعة Mask، التوليد الجماعي).
- الاضطرار لإعادة التكامل في كل مرة تغير فيها عميل OpenClaw (أو عند استخدام Claude Code أو Cursor).
في عام 2026، تغيرت الإجابة: لا تكتب الكود، فقط قم بتثبيت Skill (مهارة).
يدعم OpenClaw نظاماً بيئياً متكاملاً للمهارات (Skills) — حيث يضم سجل ClawHub حالياً أكثر من 5700 مهارة ساهم بها المجتمع. في هذا المقال، سنشارك معكم مهارتي gpt-image-2 الرسميتين اللتين قدمهما فريق APIYI إلى مستودع expert-skills-hub:
apiyi-gpt-image-2-gen(للتحويل المباشر / تحكم دقيق، موصى به)apiyi-gpt-image-2-all-gen(للتحويل العكسي / وضع اقتصادي)
تثبيت المهارة لا يتطلب سوى أمر واحد، وإعداد مفتاح API لا يحتاج إلا لسطر export واحد. بعد ذلك، يمكنك ببساطة أن تطلب من OpenClaw: "ساعدني في رسم صورة تجارية لكوب سيراميك بدقة 4K"، وسيقوم الوكيل تلقائياً باختيار المهارة المناسبة، وتعبئة المعاملات، وحفظ الملفات.
بعد متابعة هذا الدليل حول دمج gpt-image-2 في OpenClaw، ستحصل على:
- مقارنة واضحة بين "كتابة الكود" و"تثبيت المهارة"، لتفهم لماذا يعد الخيار الثاني أفضل.
- مهارتان رسميتان جاهزتان للاستخدام، تغطيان سيناريوهات المخرجات عالية الجودة والإنتاج الاقتصادي الجماعي.
- مثال مصغر يعمل في 5 خطوات (نسخة لكل من Node.js و Python).
- ثلاثة أوامر عملية (ملصق 4K / دمج صور مرجعية متعددة / توليد جماعي للرسومات الأولية).
- طريقة إعادة استخدام نفس المهارة في Claude Code و Cursor.
一、为什么 Skills 是 OpenClaw 接入 gpt-image-2 的最优解
1.1 OpenClaw 的 Skills 体系：给 Agent 开外挂的标准方式
OpenClaw 是一个跨平台开源 AI 助手（GitHub 仓库 github.com/openclaw/openclaw），它的设计目标不是“又一个聊天框”，而是“给 Agent 提供一套可组合的工具箱”。这套工具箱的基本单元就叫 Skill。
一个 Skill 本质上是：
skill-package/
├── SKILL.md # 告诉 Agent 这个 Skill 是做什么的
├── scripts/
│ ├── generate_image.js # Node.js 运行时
│ └── generate_image.py # Python 运行时
└── requirements.txt / package.json
当你说“帮我画一张咖啡杯”，OpenClaw 会：
- 扫描所有已安装 Skill 的
SKILL.md摘要 - 判断“图像生成”最匹配
apiyi-gpt-image-2-gen - 从你的自然语言里抽取参数（尺寸、质量、输出格式）
- 调用对应的
generate_image.js/py - 把生成的图片路径返回给你
整个过程你不写代码、不配路由、不调 SDK，这是 OpenClaw 生态相对传统“写插件”模式的核心优势。
1.2 写代码 vs 装 Skill：一张表看清楚
| 对比维度 | 手写 HTTP 代码 | 安装官方 Skill |
|---|---|---|
| 起步成本 | 30 分钟起步 | 1 行命令，30 秒 |
| HTTP 细节 | 自己处理 multipart、重试、超时 | Skill 内部已封装 |
| 参考图上传 | 自己做 base64 编码 | 直接传文件路径 |
| 多运行时 | 要么 Node 要么 Python | Node.js + Python 都有 |
| Agent 感知 | 要自己写工具描述 | SKILL.md 自带 |
| 跨客户端 | 换一次环境重集成 | Claude Code / Cursor / OpenClaw 通吃 |
| 升级路径 | 自己追 OpenAI API 更新 | npx skills update 一键 |
| 线路切换 | 改代码 | 改环境变量 |
换句话说，写代码是让你自己变成一个永远在维护的 glue 工人，而装 Skill 是把维护工作交给专门的 Skill 作者。
1.3 两个 Skill 的分工：先选对工具再出图
APIYI 团队向 expert-skills-hub 仓库贡献了两个针对 gpt-image-2 的 Skill，它们面向完全不同的场景：
| Skill 名 | 模型别名 | 定位 | 价格模式 | 最佳场景 |
|---|---|---|---|---|
apiyi-gpt-image-2-gen |
gpt-image-2 |
正转 / 精细控制 | 按 token 计费 | 海报、商拍、封面、4K 出图 |
apiyi-gpt-image-2-all-gen |
gpt-image-2-all |
反转 / 经济模式 | 固定 $0.03/图 | 批量概念稿、中文 prompt、草图探索 |
两个 Skill 共享同一个 APIYI_API_KEY，后端统一走 APIYI 网关。你可以同时装两个，让 OpenClaw Agent 根据场景自动选：生成海报走正转，跑 100 张变体走反转。
1.4 底层后端：APIYI apiyi.com 三线路
两个 Skill 的 HTTP 请求默认打到 api.apiyi.com，这是 APIYI 的主站。
🎯 线路建议：我们建议在生产环境中把 OpenClaw 的
APIYI_BASE_URL切到 APIYI apiyi.com 的高并发线路vip.apiyi.com，特别是批量跑图时。主站api.apiyi.com适合日常单图调用，VIP 线路vip.apiyi.com适合批量/夜间队列，b.apiyi.com则作为备用 fallback 自动生效。三条线路共用一把 Key，只需改一个环境变量就能切换。
ثانياً: إتمام ربط OpenClaw بـ gpt-image-2 في 5 دقائق
2.1 فحص المتطلبات الأساسية
قبل البدء في ربط OpenClaw بـ gpt-image-2، تأكد من جاهزية بيئة العمل:
| العنصر | المتطلبات | أمر التحقق |
|---|---|---|
| OpenClaw مثبت | أحدث إصدار | openclaw --version |
| Node.js | 18+ | node --version |
| Python | 3.10+ (اختياري) | python3 --version |
| npx | يأتي مع Node | npx --version |
| الشبكة | الوصول لـ github.com و api.apiyi.com | curl -I api.apiyi.com |
| مفتاح APIYI | من لوحة تحكم api.apiyi.com |
يبدأ بـ sk- |
⚠️ ملاحظة: إذا لم تجد أمر
npx skillsفي إصدار OpenClaw الخاص بك، يرجى التحديث إلى أحدث إصدار عبر (openclaw update). تُعد Skills CLI قدرة أساسية في نظام OpenClaw 2026، وقد لا تتوفر في الإصدارات القديمة.
2.2 الخطوة 1: تثبيت المهارة (Skill) بأمر واحد
افتح الطرفية (Terminal) وقم بتثبيت المهارة المناسبة حسب سيناريو استخدامك. نوصي بتثبيت كلتيهما:
# التوجيه العادي (موصى به للاستخدام اليومي)
npx skills add https://github.com/wuchubuzai2018/expert-skills-hub \
--skill apiyi-gpt-image-2-gen
# التوجيه المتقدم (مناسب للطلبات الجماعية/الموجهات باللغة الصينية)
npx skills add https://github.com/wuchubuzai2018/expert-skills-hub \
--skill apiyi-gpt-image-2-all-gen
بعد اكتمال الأمر، سيتم وضع المهارة في دليل المهارات الافتراضي لـ OpenClaw (عادةً ~/.openclaw/skills/). يمكنك التأكد من ذلك باستخدام الأمر التالي:
npx skills list
# المخرجات المتوقعة:
# - apiyi-gpt-image-2-gen ✓ تم التثبيت
# - apiyi-gpt-image-2-all-gen ✓ تم التثبيت
2.3 الخطوة 2: إعداد مفتاح API
يتطلب ربط OpenClaw بـ gpt-image-2 متغير بيئة واحداً فقط:
# macOS / Linux
export APIYI_API_KEY="sk-your-key-here"
# Windows PowerShell
$env:APIYI_API_KEY = "sk-your-key-here"
يُفضل إضافة هذا السطر إلى ملف ~/.zshrc أو ~/.bashrc لجعله دائماً.
🎯 خطوات الحصول على المفتاح: قم بزيارة APIYI عبر
apiyi.com، وبعد التسجيل توجه إلى لوحة التحكم ← API Keys ← إنشاء مفتاح جديد. نوصي بتفعيل ميزة "حد الاستخدام" وتعيين حد يومي للمفتاح المستخدم في OpenClaw (مثلاً 50 يوان) لتجنب الاستهلاك المفرط نتيجة خطأ في الوكيل.
خيار تبديل المسارات الثلاثة، إذا كنت بحاجة إلى معدل استدعاء عالٍ في السيناريوهات الجماعية:
export APIYI_BASE_URL="https://vip.apiyi.com/v1" # مسار VIP
# أو
export APIYI_BASE_URL="https://b.apiyi.com/v1" # مسار احتياطي
في حال عدم التعيين، سيتم استخدام https://api.apiyi.com/v1 افتراضياً.
2.4 الخطوة 3: توليد أول صورة (Node.js)
يأتي تثبيت المهارة مرفقاً بنصوص برمجية تجريبية. إليك أبسط أمر للتحقق:
cd ~/.openclaw/skills/apiyi-gpt-image-2-gen
node scripts/generate_image.js \
-p "A minimalist poster with the text 'HELLO 2026' centered" \
-s "1024x1024" \
-q "medium" \
-o "png" \
-f "./hello_2026.png"
بعد حوالي 20-40 ثانية، ستظهر لك رسالة في الطرفية:
✔ Image generated: ./hello_2026.png (1024x1024, png, 312 KB)
افتح ملف hello_2026.png؛ يجب أن ترى ملصقاً بسيطاً بوضوح مع نص "HELLO 2026" في المنتصف. ظهور النص بوضوح يعني أن المسار بالكامل (OpenClaw Skill → APIYI api.apiyi.com → OpenAI gpt-image-2) يعمل بشكل صحيح.
2.5 الخطوة 4: توليد أول صورة (نسخة Python)
إذا كان مشروعك يعتمد على بيئة Python، فإن المهارة نفسها تتضمن نصاً برمجياً لـ Python:
cd ~/.openclaw/skills/apiyi-gpt-image-2-gen
python3 scripts/generate_image.py \
-p "A minimalist poster with the text 'HELLO 2026' centered" \
-s "1024x1024" \
-q "medium" \
-o "png" \
-f "./hello_2026.png"
المعاملات متطابقة تماماً مع نسخة Node.js، وهي خمسة خيارات قصيرة -p/-s/-q/-o/-f أو ما يقابلها من خيارات طويلة (--prompt/--size/--quality/--output-format/--filename).
💡 لا حاجة لتبديل بيئة التشغيل: وجود النصين البرمجيين في حزمة المهارة الواحدة يعني أنه يمكنك استخدام Node (مناسب للواجهات الأمامية) و Python (مناسب لعلوم البيانات) في نفس المشروع، حيث تعتبر مهارة ربط OpenClaw بـ gpt-image-2 مواطناً من الدرجة الأولى لكلا الطرفين.
2.6 الخطوة 5: الاستدعاء باللغة الطبيعية داخل OpenClaw
الاستخدام عبر سطر الأوامر (CLI) هو فقط للتحقق من جاهزية المهارة. الاستخدام الحقيقي هو جعل OpenClaw يستدعي المهارة ذاتياً. بعد تشغيل OpenClaw، يمكنك إعطاء الأمر مباشرة باللغة الطبيعية:
المستخدم: ساعدني في رسم صورة منتج لكوب شاي سيراميك بدقة 4K باستخدام gpt-image-2،
إضاءة صباحية ناعمة، خلفية سادة، بصيغة PNG، واحفظها في ./output/tea_cup.png
OpenClaw: حسناً، سأستخدم مهارة apiyi-gpt-image-2-gen لمعالجة هذا الطلب.
المعاملات: size=3840x2160, quality=high, output-format=png
جاري التوليد...
✔ تم الإنجاز: ./output/tea_cup.png (3840x2160, 2.4 MB)
ستقوم طبقة الاستدلال في OpenClaw بما يلي:
- تحديد نوع المهمة = توليد صور.
- مقارنة ملف
SKILL.mdللمهارات المتاحة، واختيارapiyi-gpt-image-2-gen(لأن المستخدم طلب 4K + PNG). - ترجمة "4K" إلى
3840x2160ودمج "إضاءة صباحية ناعمة" في الموجه (prompt). - تنفيذ
generate_image.jsوإرجاع مسار الملف.
خلال العملية برمتها، لم تكتب سوى جملة واحدة، دون الحاجة لأي كود Python أو Node. هذه هي القيمة الجوهرية لربط OpenClaw بـ gpt-image-2 عبر مسار المهارات.
ثالثاً. دليل المعاملات السريع لاستدعاء gpt-image-2 عبر OpenClaw
3.1 مهارة التحويل المباشر (正转): apiyi-gpt-image-2-gen
هذا هو النمط المخصص للتحكم الدقيق، ونوصي باستخدامه كخيار افتراضي. إليك جدول المعاملات الكامل:
| الخيار | الخيار الطويل | نطاق القيم | الافتراضي | الوصف |
|---|---|---|---|---|
-p |
--prompt |
نص | مطلوب | وصف الصورة، يُفضل دمج كلمات مفتاحية بالإنجليزية والصينية |
-s |
--size |
WIDTHxHEIGHT |
1024x1024 |
أي مضاعفات للرقم 16، بحد أقصى 3840x3840 |
-q |
--quality |
low/medium/high/auto | auto |
اختر high للملصقات، و low للمسودات |
-o |
--output-format |
png/jpeg/webp | png |
يجب استخدام png للخلفيات الشفافة |
-c |
--output-compression |
0-100 | 85 |
فعال فقط مع jpeg/webp |
-i |
--input-image |
مسار (قابل للتكرار) | لا يوجد | حتى 5 صور مرجعية |
-m |
--mask |
مسار | لا يوجد | قناع أبيض وأسود، الأبيض = منطقة التعديل |
-f |
--filename |
مسار | ./output.png |
ملف الإخراج |
دليل سريع لأحجام الاستخدام الشائعة:
| الاستخدام | الحجم الموصى به |
|---|---|
| ستوري WeChat | 1080x1080 |
| صور Xiaohongshu الرأسية | 1080x1440 |
| غلاف Bilibili | 1920x1080 |
| ترويسة المدونة | 1600x900 |
| ملصق 4K | 3840x2160 |
| لافتة (Banner) طولية | 2400x800 |
| خلفية هاتف | 1170x2532 |
3.2 مهارة التحويل العكسي (反转): apiyi-gpt-image-2-all-gen
هذا هو النمط الاقتصادي للطلبات الجماعية، بتكلفة تقريبية 0.03 دولار لكل صورة. المعاملات أكثر بساطة:
| الخيار | الخيار الطويل | نطاق القيم | الوصف |
|---|---|---|---|
-p |
--prompt |
نص | الوصف، اكتب الحجم/النسبة مباشرة داخل النص |
-r |
--response-format |
url / b64_json | url لرابط CDN لمدة 24 ساعة، أو b64_json لترميز Base64 |
-i |
--input-image |
مسار (قابل للتكرار) | حتى 5 صور مرجعية |
-f |
--filename |
مسار | ملف الإخراج (يتم التنزيل تلقائياً في وضع url) |
مهارة التحويل العكسي لا تعرض -s/-q/-o، لأن النموذج الأساسي حواري، ويجب تحديد الأبعاد عبر الموجه (prompt):
# مثال صحيح
-p "توليد خلفية أفقية بنسبة 16:9، مشهد ليلي لمدينة خيال علمي، أضواء نيون"
# مثال خاطئ (نمط التحويل العكسي لا يدعم -s)
-p "مشهد ليلي لمدينة خيال علمي" -s "1920x1080" # ❌
3.3 ثلاثة أوامر عملية
التطبيق 1: ملصق فيلم 4K (تحويل مباشر)
node scripts/generate_image.js \
-p "ملصق سينمائي لرواية الخيال العلمي 'NEON HORIZON'، \
سماء متدرجة باللونين الأزرق الداكن والأرجواني، صورة ظلية وحيدة على جرف، \
عنوان بخط عريض في المنتصف بالأعلى، شعار فرعي خفيف في الأسفل، \
تأثير حبيبات فيلم 35mm" \
-s "3840x5760" \
-q "high" \
-o "png" \
-f "./poster_neon_horizon.png"
- نسبة 2:3 عمودية بدقة 4K
- جودة high تضمن حدة النصوص
- يستغرق التوليد من 3 إلى 5 دقائق (يعتمد الوقت على الجودة)
التطبيق 2: إعادة رسم جزئي باستخدام القناع (تحويل مباشر + صورة + قناع)
node scripts/generate_image.js \
-p "استبدال الخلفية بسطح رخامي أبيض فاخر، \
ضوء نافذة طبيعي وناعم من اليسار، \
الحفاظ على ثبات بكسلات المنتج" \
-i "./coffee_cup.png" \
-m "./coffee_cup_mask.png" \
-s "2048x2048" \
-q "high" \
-f "./coffee_cup_marble.png"
- البكسلات البيضاء = الخلفية المراد تغييرها
- البكسلات السوداء = المنتج (ثبات البكسلات)
- نموذج gpt-image-2 لن يفسد شكل المنتج
التطبيق 3: مسودات مفاهيمية جماعية (تحويل عكسي + حلقة تكرار)
# 100 مفهوم لتصاميم ملابس، بتكلفة 0.03 دولار للصورة، التكلفة الإجمالية حوالي 3 دولارات
for i in $(seq 1 100); do
node scripts/generate_image.js \
-p "تصميم شخصية سايبر بانك رقم #${i}، زي هانفو مطور، ألوان نيون، رسم كامل للجسم" \
-r "url" \
-f "./concepts/concept_${i}.png"
done
- مهارة التحويل العكسي تدعم الموجه الصيني بشكل أكثر استقراراً
- في وضع
-r urlيقوم السكريبت بالتنزيل محلياً تلقائياً - للسيناريوهات الجماعية يُنصح بتغيير الرابط إلى
APIYI_BASE_URL=https://vip.apiyi.com/v1
رابعاً. تكاملات متقدمة لـ OpenClaw مع gpt-image-2
4.1 دع الوكيل (Agent) يختار المهارة بنفسه
بعد تثبيت مهارتي التحويل المباشر والعكسي، سيقوم OpenClaw بالاختيار تلقائياً بناءً على لغتك. لمساعدة الوكيل على الاختيار بدقة، يمكنك تضمين إشارات في الموجه:
| ما تقوله | ميل الوكيل للاختيار |
|---|---|
| "جودة عالية"، "4K"، "ملصق"، "تصوير تجاري" | التحويل المباشر apiyi-gpt-image-2-gen |
| "مسودة"، "جماعي"، "مفهوم"، "صيني" | التحويل العكسي apiyi-gpt-image-2-all-gen |
| "أخرج 10 صور للتجربة" | التحويل العكسي (اقتصادي) |
| "استخدم القناع لتغيير الخلفية" | التحويل المباشر (العكسي لا يدعم القناع) |
| "تكلفة ثابتة 0.03 دولار" | التحويل العكسي |
🎯 نصيحة للموجه: عند كتابة مصطلحات مثل "تحكم دقيق" أو "كميات اقتصادية" داخل الكلمات المفتاحية، سيقوم OpenClaw باختيار المهارة الصحيحة بنسبة 100%.
4.2 سلسلة المهارات: توليد صورة ← OCR ← ترجمة
بما أن الوكيل يمكنه ترتيب المهارات بحرية، يمكنك ربط OpenClaw مع gpt-image-2 في خط إنتاج متعدد الخطوات. مثال: "توليد ملصق بشعار إنجليزي، ثم ترجمة الشعار إلى اليابانية":
المستخدم: قم بتوليد ملصق بسيط بشعار "Less is more"،
ثم قم بتوليد نسخة بنفس التكوين ولكن بشعار باليابانية
OpenClaw:
الخطوة 1: apiyi-gpt-image-2-gen (نسخة إنجليزية)
→ ./en_poster.png
الخطوة 2: apiyi-gpt-image-2-gen (نسخة يابانية، باستخدام en_poster.png كصورة مرجعية)
-i ./en_poster.png
-p "نفس التكوين، استبدل النص بـ 'より少なく、より豊かに'"
→ ./jp_poster.png
هذه هي أقوى ميزات بيئة المهارات: المهارة الواحدة تقوم بمهمة واحدة، والوكيل يتولى ربطها في سير عمل معقد.
4.3 تغليف المهارات داخل CI/CD
سكربتات المهارات هي في جوهرها CLI قياسية، مما يعني أنها تعمل بسلاسة داخل CI/CD:
# .github/workflows/generate-og-image.yml
name: Generate OG image on release
on:
release:
types: [published]
jobs:
og-image:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: '20' }
- run: npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill apiyi-gpt-image-2-gen
- env:
APIYI_API_KEY: ${{ secrets.APIYI_API_KEY }}
run: |
node ~/.openclaw/skills/apiyi-gpt-image-2-gen/scripts/generate_image.js \
-p "صورة غلاف الإصدار ${{ github.event.release.tag_name }}" \
-s "1200x630" \
-q "high" \
-f "./og-image.png"
- uses: actions/upload-artifact@v4
with: { name: og-image, path: ./og-image.png }
يتم توليد صورة OG تلقائياً مع كل إصدار، حيث يتشارك الوكيل و CI في نفس تعريف المهارة.
4.4 إعادة الاستخدام في Claude Code و Cursor
على الرغم من تركيزنا على OpenClaw، إلا أن المهارات apiyi-gpt-image-2-gen / apiyi-gpt-image-2-all-gen تتبع معايير المهارات العامة بالكامل، لذا:
| العميل | هل يدعم؟ | ملاحظات |
|---|---|---|
| OpenClaw | ✅ | السيناريو الرئيسي لهذا المقال |
| Claude Code | ✅ | ضعها في ~/.claude/skills/ |
| Cursor | ✅ | عبر ملف القواعد (Rules) |
| Windsurf | ✅ | متوافق مع معايير المهارات |
| وكيل مخصص (LangChain إلخ) | ⚠️ | يتطلب طبقة مهايئ (Tool Adapter) |
"تثبيت مرة واحدة، استخدام في عدة عملاء" يتيح لقدرات توليد الصور الخاصة بك الانتقال معك بين أدواتك المفضلة دون الحاجة لإعادة كتابة الأوامر.
5. الأسئلة الشائعة حول دمج OpenClaw مع gpt-image-2
س1: يظهر خطأ "command not found" عند تنفيذ npx skills add؟
تأكد من تحديث OpenClaw إلى أحدث إصدار (openclaw update)، حيث أن الإصدارات القديمة لا تحتوي على Skills CLI. إذا استمرت المشكلة، يمكنك استنساخ المستودع يدويًا إلى المجلد ~/.openclaw/skills/ كحل بديل.
س2: تظهر رسالة "APIYI_API_KEY is not set" عند تشغيل السكريبت؟
اتبع هذه الخطوات الثلاث للتحقق:
- نفذ
echo $APIYI_API_KEYللتأكد من تصدير المتغير بنجاح. - تأكد من أن المفتاح يبدأ بالبادئة
sk-. - إذا قمت بإضافته للتو إلى
~/.zshrc، افتح نافذة طرفية (Terminal) جديدة لتفعيل التغييرات.
س3: كيف يمكنني التحويل إلى مسار vip.apiyi.com عالي التوافر؟
هناك طريقتان:
# الطريقة 1: متغير بيئة عام
export APIYI_BASE_URL="https://vip.apiyi.com/v1"
# الطريقة 2: بادئة للاستدعاء الفردي
APIYI_BASE_URL="https://vip.apiyi.com/v1" node scripts/generate_image.js ...
ينطبق الأمر نفسه على النطاق الاحتياطي: b.apiyi.com. تشترك النطاقات الثلاثة في نفس المفتاح، لذا عند حدوث تذبذب في الموقع الرئيسي، فإن التحويل اليدوي إلى VIP عادة ما يحل المشكلة فورًا. يمكنك أيضًا الرجوع إلى دليل تبديل المسارات في وثائق APIYI الرسمية docs.apiyi.com.
س4: كيف أختار بين "التحويل المباشر" (正转) و"التحويل العكسي" (反转)؟
استخدم جدول القرار التالي:
| إذا كنت تحتاج إلى… | اختر |
|---|---|
تحكم دقيق في الدقة (مثل 1920x1080) |
التحويل المباشر |
| استخدام Mask لإعادة الرسم الجزئي | التحويل المباشر |
| ملصقات عالية الجودة بدقة 4K فما فوق | التحويل المباشر |
| معالجة دفعات كبيرة (أكثر من 50 صورة) | التحويل العكسي |
| توجيه (Prompt) باللغة الصينية بشكل أساسي | التحويل العكسي |
| تكلفة متوقعة ($0.03/صورة) | التحويل العكسي |
أفضل ممارسة: ثبّت كليهما، واترك وكيل OpenClaw يختار تلقائيًا بناءً على لغتك الطبيعية.
س5: هل يمكن استخدامه في Claude Code؟
نعم. قم بإنشاء رابط رمزي (Symbolic Link) أو انسخ حزمة Skill من ~/.openclaw/skills/ إلى ~/.claude/skills/؛ وسيقوم Claude Code تلقائيًا بالتعرف على SKILL.md وتسجيله كأداة قابلة للاستدعاء. سيتم استخدام نفس APIYI_API_KEY.
س6: هل الـ Skill آمن؟
يجب توخي الحذر في بيئة Skills المجتمعية. في فبراير 2026، تم اكتشاف 341 Skill ضارًا يتم توزيع برمجيات خبيثة عبر ClawHub. نصيحتنا:
- ثبّت فقط الـ Skills القادمة من مستودعات موثوقة (المصدر
wuchubuzai2018/expert-skills-hubالمذكور هنا هو المصدر الرسمي لـ APIYI). - بعد التثبيت، راجع
SKILL.mdومحتوى السكريبتات، مع الانتباه بشكل خاص لأوامرcurl | bashأو الكود الذي يتصل بنطاقات غير معروفة. - استخدم
npx skills inspect <skill-name>لمعرفة العناوين التي سيصل إليها الـ Skill.
جميع طلبات الـ Skills الرسمية من APIYI تتصل فقط بـ *.apiyi.com ويمكن تدقيقها بأمان.
س7: ماذا أفعل إذا كان توليد صور 4K بطيئًا؟
- هذا أمر طبيعي؛ حيث يستغرق
quality=highمع3840x2160حوالي 3–5 دقائق. - أضف حماية من انتهاء الوقت (Timeout) في السكريبت (استخدم
timeout 360 node ...في Bash). - إذا كنت بحاجة لمعاينة سريعة، استخدم
size=2048x1152 quality=mediumللحصول على مسودة، ثم ارفع الجودة إلى 4K بعد التأكد من النتيجة.
س8: كيف أراقب التكاليف؟
قم بتفعيل "تنبيهات الميزانية اليومية" و"الإحصائيات حسب المفتاح" في لوحة تحكم APIYI apiyi.com. خصص ميزانية للمفتاح الخاص بـ OpenClaw، مما يتيح لك مراقبة الاستهلاك وإيقاف الخدمة فورًا في حالة حدوث أي استهلاك غير متوقع.
6. خلاصة دمج OpenClaw مع gpt-image-2
بالنظر إلى الوراء، نجد أن المسار الأمثل في عام 2026 لدمج OpenClaw مع gpt-image-2 قد تحول من "كتابة الكود" إلى "تثبيت الـ Skill". والسبب بسيط:
- أسرع: أمران فقط
npx skills add+export KEYلإتمام المهمة في 30 ثانية. - أكثر استقرارًا: تفاصيل HTTP، استراتيجيات إعادة المحاولة، والتحقق من المعلمات كلها مغلفة داخل الـ Skill.
- أوسع نطاقًا: نفس الـ Skill يعمل عبر OpenClaw / Claude Code / Cursor.
- أكثر ذكاءً: الوكيل يفهم
SKILL.mdويمكنه تحديد متى وكيف يستخدم الأداة.
إن الـ Skills التي قدمتها APIYI، وهما apiyi-gpt-image-2-gen (للتحكم الدقيق) و apiyi-gpt-image-2-all-gen (للاقتصاد والكميات)، تغطيان تمامًا أكثر سيناريوهين شيوعًا. تثبيتهما معًا هو نقطة البداية الأكثر راحة؛ سواء كنت تحتاج لملصقات 4K أو 100 مسودة تصميم، سيختار وكيل OpenClaw الأداة المناسبة تلقائيًا.
🎯 نصيحة للتنفيذ: ابدأ بطلب مفتاح تجريبي من APIYI
apiyi.com(يُنصح بوضع حد يومي 20–50 يوان)، ونفذ المثال البسيط المذكور في الفقرة 2. بعد التأكد من عمل الرابط، جرب أوامر الفقرة 3 لإنشاء ملصقات 4K وإعادة الرسم بـ Mask. عند حدوث تذبذب في الشبكة، يمكنك دائمًا تحويلAPIYI_BASE_URLإلىvip.apiyi.comأوb.apiyi.com. لمزيد من التكوينات المعقدة، راجع قسم Skills في وثائق APIYIdocs.apiyi.com.
بهذا، أصبحت تمتلك حلاً كاملاً وقابلاً لإعادة الاستخدام لدمج OpenClaw مع gpt-image-2. الشيء الوحيد المتبقي هو حذف مهمة "كتابة أداة لاستدعاء الصور" من قائمة مهامك للأبد، ودع الـ Skills تتولى الأمر.
المؤلف: فريق APIYI التقني
موارد ذات صلة:
- مستودع Skills: github.com/wuchubuzai2018/expert-skills-hub
- الصفحة الرئيسية لـ OpenClaw: github.com/openclaw/openclaw
- موقع APIYI الرسمي: apiyi.com
- وثائق APIYI: docs.apiyi.com
- موقع APIYI الرئيسي: api.apiyi.com (احتياطي vip.apiyi.com / b.apiyi.com)
