التخطى الى المحتوى الأساسى
  1. التوثيق/

مهارة OpenClaw

ما هي مهارة OpenClaw؟
#

تتيح مهارة PocketHook الخاصة بـ OpenClaw لوكيل OpenClaw لديك تشغيل اختصارات iOS على جهازك. عندما تطلب من OpenClaw إنشاء ملاحظة أو إنشاء قائمة تشغيل أو تنفيذ أي أتمتة، يضمّن الوكيل في رده علامات يكتشفها PocketHook وينفذها.

إصدار مبكر. قد تحتاج هذه المهارة إلى ضبط إضافي ليناسب إعدادك. الاختصارات المضمّنة مجرد أمثلة — ستحتاج إلى تسجيل اختصاراتك الخاصة وتكييف المهارة بما يطابق طريقة استخدامك لـ PocketHook.

كيف تعمل
#

  1. ترسل رسالة من PocketHook، الذي يمررها إلى خادم OpenClaw الخاص بك
  2. يعالجها OpenClaw باستخدام نموذج اللغة LLM الخاص به ومهارة PocketHook
  3. يتضمن الرد علامات مضمّنة مثل [SHORTCUT:New Note] و[DATA:{...}]
  4. يكتشف PocketHook العلامات ويزيلها من الرسالة المعروضة وينفذ الاختصارات على جهازك

يتواصل PocketHook مع OpenClaw باستخدام تنسيق OpenAI Chat Completions مع الترويسة x-openclaw-agent-id: main.

الإعداد
#

1. تثبيت المهارة
#

git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/

يعيد OpenClaw تحميل المهارات فورًا — لا حاجة لإعادة التشغيل.

2. تكوين PocketHook
#

في PocketHook على جهاز iOS الخاص بك، انتقل إلى الإعدادات:

الإعدادالقيمة
عنوان URL للخادمعنوان URL لوكيل HTTP الخاص بـ OpenClaw لديك (HTTPS)
رمز المصادقةرمز مصادقة OpenClaw الخاص بك
وضع OpenClawON

للمهام في الخلفية (اختياري):

الإعدادالقيمة
المهام في الخلفيةON
عنوان URL للاستطلاعنقطة نهاية الاستطلاع الخاصة بك
رسالة الجلبfetchPendingTasks

اضغط اختبار الاتصال للتحقق.

العلامات المدعومة
#

العلامةالغرض
[SHORTCUT:name] أو [RUN:name]تشغيل اختصار iOS
[DATA:{...}]تمرير بيانات JSON إلى الاختصار السابق
[URL:https://...]فتح عنوان URL في المتصفح داخل التطبيق

توضع العلامات في نهاية الرد ويمكن دمجها:

Creating your note and opening the recipe.

[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]

تُنفَّذ الاختصارات المتعددة بالتتابع — ينتظر PocketHook اكتمال كل اختصار قبل تشغيل التالي.

تسجيل اختصاراتك
#

تأتي المهارة مع اختصارات كأمثلة (New Note وnewPlayList). لإضافة اختصاراتك الخاصة، عدّل SKILL.md في ثلاثة مواضع:

1. حقل description
#

أضف محفز اختصارك إلى قائمة Use when: حتى يفعّل OpenClaw المهارة:

description: >
  ...
  Use when: create a note, make a playlist, set a reminder, ...

2. جدول “When to Use”
#

اربط نية المستخدم بإجراء الاختصار:

| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |

3. قسم “User’s Shortcuts”
#

وثّق اسم الاختصار وتنسيق البيانات:

### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`

المهام في الخلفية
#

يدعم PocketHook الاستطلاع للأعمال غير المتزامنة:

  1. يرسل PocketHook طلب GET إلى عنوان URL للاستطلاع دوريًا
  2. إذا كانت الاستجابة true، يظهر إشعار
  3. عندما يفتح المستخدم PocketHook، يرسل fetchPendingTasks
  4. يرد OpenClaw بالنتائج المكتملة (بما في ذلك علامات الاختصارات)
  5. إذا لم تكن هناك نتائج معلقة، فليكن الرد false فقط

هذا يتيح لـ OpenClaw معالجة المهام الطويلة (البحث، إنشاء المشاريع، تحليل البيانات) في الخلفية وتسليم النتائج عند جاهزيتها.