مناوبة GitHub: ملخصات PR والمعالجة الآلية للمشكلات
💡 خلاصة بسطر واحد: أنشئ باستخدام OpenClaw خط مناوبة GitHub يعمل 7×24 — يستقبل Webhook الوارد الأحداث، وتحوّل خطافات الربط المهام، وينتج وكيل المناوبة الملخصات والردود.
حين تكثر طلبات PR في المستودع، يعجز الفحص اليدوي لملفات diff عن مواكبة ذلك؛ والأسئلة المتكررة في المشكلات تبقى دون رد في الوقت المناسب. تأخذك هذه الصفحة لبناء خط مناوبة OpenClaw GitHub: تمرّر أحداث المستودع إلى وكيل المناوبة عبر Webhook الوارد، فيولد تلقائيًا ملخص التغييرات لكل PR جديد، ويصنّف المشكلات الجديدة ويصيغ ردودًا عليها. قبل البدء، أكمل أولًا «دع Claw يكتب الكود: exec والتصحيحات والموافقات»، وتأكد أن وكيلك يكمل دورة مهام بشكل سليم. جميع الأمثلة مبنية على OpenClaw v2026.10.9.
ماذا ستستطيع فعله بعد الدرس
- فور دخول PR جديد إلى المستودع، ينتج وكيل المناوبة تلقائيًا ملخص تغييرات بتنسيق ثابت: ما الذي تغير، وأي الوحدات تأثر، وأين تكمن المخاطر.
- تصنيف تلقائي للمشكلات الجديدة: تحديد النوع، والتعرف على المشكلات المكررة، وصياغة رد جاهز للنشر مباشرة.
- استخدام curl للتحقق الدخاني محليًا من خط المناوبة بأكمله دون انتظار PR حقيقي.
- الأحداث غير المستهدفة (مثل push) تُرجع تلقائيًا 204 دون إيقاظ الوكيل أو استهلاك دورة محادثة.
لماذا OpenClaw وليس ذكاءً اصطناعيًا عبر الويب؟
| القدرة | ذكاء الويب | OpenClaw |
|---|---|---|
| استجابة 7×24 | ❌ إن لم تفتح الصفحة فلن يتحرك | ✅ يعمل Gateway باستمرار، والأحداث تُعالج فور وصولها |
| قراءة محتوى المستودع | ❌ لصق diff يدويًا، والنصوص الطويلة لا تتسع | ✅ يحمل الوكيل هوية GitHub ويجلب بنفسه diff الخاص بـ PR ونص المشكلة |
| قائم على الأحداث | ❌ نسخ الروابط يدويًا للسؤال | ✅ Webhook وارد + خطافات ربط، فتتحول الأحداث تلقائيًا إلى مهام |
| تتبع واستكشاف الأخطاء | ❌ بمجرد إغلاق المحادثة يضيع كل شيء | ✅ لكل طلب runId، ويمكن التحقق من حالة الإنجاز عبر السجلات |
| حدود الصلاحيات | ❌ لا يوجد | ✅ يحدد allowedAgentIds الوكلاء القابلين للإيقاظ، وتخضع عمليات الكتابة للموافقات كالمعتاد |
معضلتك الحالية
- تفتح المستودع صباحًا فتجد PR جديدة ومشكلات جديدة مصطفة، وفحص ملفات diff واحدًا واحدًا يستغرق الصباح كله.
- المشكلات المكررة تُطرح مرارًا، وتريد تصنيفها ووسمها أولًا، لكن الأمر نفسه مضنٍ للوقت.
- لصق diff يدويًا في ذكاء الويب؟ diff الطويل لا يُدرج كاملًا، ويفقد السياق، وتضطر للمراقبة بانتظار النتيجة.
متى تستخدم هذه الحيلة
- مستودع الفريق يشهد يوميًا PR ومشكلات جديدة، والمتابعة اليدوية لا تواكب الإيقاع.
- تريد ملخصات PR بتنسيق موحد لتسهيل تقرير أيها تُفحص أولًا.
- المشكلات تحتاج تصنيفًا أوليًا: التبويب، وتمييز المكرر، ومنح السائل ردًا مبدئيًا.
- لديك بالفعل جهاز يعمل 7×24 يشغّل Gateway، وقد نجحت في تشغيل exec والموافقات من الصفحة السابقة.
🎒 التحضير قبل البدء
- Gateway قيد التشغيل، مع وكيل قادر على إكمال دورة محادثة بشكل سليم — هذا هو المتطلب الرسمي لـ webhook.
- رمز مخصص طويل وعشوائي. تنص الوثائق الرسمية صراحة: لا تعيد استخدام رمز مصادقة Gateway أو كلمة المرور.
- صلاحيات مسؤول على مستودع GitHub لإضافة Webhook.
- مدخل HTTPS عام (وكيل عكسي موثوق): يجب أن تتمكن خوادم GitHub من الوصول إلى Gateway لديك، وهو أيضًا من يضيف ترويسة المصادقة (التفاصيل في الخطوة 4).
- هوية قراءة محتوى GitHub للوكيل: بدون إعداد
tools.githubيُستخدم التحليل الأصلي لـgh، أما هوية التنفيذ المشتركة فتُضبط عبرtools.github(التفاصيل في الخطوة 5).
نفّذ معي
الخطوة 1: تمكين Webhook الوارد وإضاءة خط مناوبة OpenClaw GitHub
لماذا نبدأ بهذه الخطوة: Webhook الوارد معطّل افتراضيًا، وبدون تمكينه لن تدخل أحداث GitHub إلى OpenClaw أصلًا.
أولًا ادمج كتلة إعدادات hooks في إعدادات Gateway. استبدل الرمز بقيمتك العشوائية الطويلة المخصصة، واستبدل main بمعرّف وكيل المناوبة:
{
hooks: {
enabled: true,
token: "<long-random-hook-token>",
path: "/hooks",
allowedAgentIds: ["main"],
allowRequestSessionKey: false,
},
}تحقق من الإعدادات، وأعد تشغيل الخدمة، وراقب السجلات:
openclaw config validate
openclaw gateway restart
openclaw logs --followإذا كنت تشغّل Gateway في المقدمة بدلًا من تثبيته كخدمة، فأوقف ذلك العمل يدويًا ثم أعد تشغيله.
يجب أن ترى: openclaw config validate ينجح، ولا توجد أخطاء متعلقة بالـ hooks في السجلات بعد إعادة التشغيل. وبالمناسبة توضّح موقع هذه المجموعة من نقاط النهاية: إنها تندرج ضمن دليل Automations (بدءًا من OpenClaw 2.0 أصبحت Automations هي التسمية الموحّدة)، والاتجاه هو «استدعاء OpenClaw من خدمات خارجية»، وهي ثلاثة أمور مختلفة عن hooks الأحداث الداخلية (معالج HOOK.md) وعن تسليم webhook الصادر من الأتمتة. إذا أعاد الرمز (token) استخدام مصادقة المفتاح المشترك لـ Gateway (gateway.auth.token / OPENCLAW_GATEWAY_TOKEN، أو gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD)، فسيُسجَّل في سجل الإقلاع تحذير غير قاتل، وسيُبلّغ openclaw security audit عن حالة critical. طريقة المعالجة: استخدم openclaw doctor --fix لتدوير الرمز المعاد استخدامه والمحفوظ، ثم حدّث جميع المرسلين الخارجيين.
الخطوة 2: اختبار دخاني محلي لوكيل المناوبة
لماذا الاختبار الدخاني: تحقق أولًا على جهازك المحلي من أن نقطة النهاية والرمز وقبول الوكيل تعمل جميعها بشكل سليم قبل السماح لحركة المرور الخارجية بالدخول، فإذا حدثت مشكلة سهُل تحديد موقعها.
افتح طرفية أخرى، وأرسل رسالة اختبار غير ضارة إلى /hooks/agent الخاص بـ Gateway المحلي:
curl --include http://127.0.0.1:18789/hooks/agent \
-H 'Authorization: Bearer <long-random-hook-token>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: webhook-smoke-001' \
--data '{"message":"Summarize this test event: the sample import completed.","name":"Webhook smoke test","agentId":"main","deliver":false}'يجب أن ترى: HTTP 200، ومتن الاستجابة هو:
{ "ok": true, "runId": "<hook-request-run-id>" }انتبه لمعنى 200: فهو يعني فقط أن الطلب حصل على قبول على مستوى الجلسة/العام، ولا يعني أن النموذج أكمل التشغيل أو أن الأداة نجحت أو أن الرسالة سُلّمت؛ وقد ينتظر الطلب الواحد ما يصل إلى 15 ثانية قبل قبوله. ابحث في openclaw logs --follow عن hook agent run completed وعن هذا الـ runId: status=ok بدون أخطاء تسليم يُسجَّل بمستوى info؛ والحالات غير ok (بما فيها التشغيلات المتخطاة) والأخطاء المُلقاة وأخطاء التسليم الصريحة تُسجَّل بمستوى warn — لكن التحذير status=ok المرفق بـ deliveryError يعني أن التنفيذ نجح لكن التسليم فشل.
في المثال، deliver: false قيمة معقولة للاختبار الدخاني: إعلان النجاح مُكتمَ، وحقول الهدف مُهمَلة، ونتيجة الاكتمال تُكتب في السجل فقط (النهايات غير ok ستظل تولّد أحداث فشل). عند الربط الرسمي بأحداث GitHub اختر حسب الحاجة: إذا أردت استلام إشعار اكتمال في المحادثة الرئيسية لوكيل المناوبة، استخدم الافتراضي deliver: true، الذي سينشر حدث نظام اكتمال في المحادثة الرئيسية للوكيل المستهدف؛ وإذا أردت الاكتفاء بالسجلات فأبقِ false.
الخطوة 3: تهيئة خطافات التعيين لتحويل payload الـ GitHub إلى مهمة للوكيل
لماذا لا يمكن تخطي هذه الخطوة: payload الخام الذي يدفعه GitHub لا يحتوي على حقل message، ولا يستطيع حمل ترويسة مصادقة Authorization: Bearer، لذا فإن توجيه الـ Webhook مباشرة إلى /hooks/agent سيفشل. الآلية الرسمية المخصصة للأحداث الخارجية هي خطافات التعيين: قم في hooks.mappings بتهيئة تحويل JS/TS موثوق لمسار مخصص، وهو الذي يترجم الـ payload إلى إجراء للوكيل.
أضف أولًا تعيينًا واحدًا في تهيئة الـ hooks (match.path: "gh" يطابق /hooks/gh):
{
hooks: {
enabled: true,
token: "<long-random-hook-token>",
path: "/hooks",
allowedAgentIds: ["main"],
allowRequestSessionKey: false,
mappings: [
{
id: "github",
match: { path: "gh" },
action: "agent",
agentId: "main",
transform: { module: "gh.mjs" },
},
],
},
}ثم اكتب الـ transform. الدليل الافتراضي هو ~/.openclaw/hooks/transforms (مفتاح التهيئة transformsDir)؛ الـ transform هو كود Gateway موثوق ويُخزَّن مؤقتًا، لذا يجب إعادة التشغيل بعد تعديله ليصبح ساري المفعول:
// ~/.openclaw/hooks/transforms/gh.mjs
export default function transform({ payload, headers }) {
const event = headers["x-github-event"] ?? headers["X-GitHub-Event"];
if (event === "pull_request" && payload.action === "opened") {
const pr = payload.pull_request;
return {
kind: "agent",
message:
`新 PR #${payload.number}:${pr.title}\n` +
`作者 ${pr.user.login},分支 ${pr.head.ref} → ${pr.base.ref}\n` +
`请拉取该 PR 的 diff,按「PR 改动摘要」规范输出。`,
};
}
if (event === "issues" && payload.action === "opened") {
return {
kind: "agent",
message:
`新 issue #${payload.number}:${payload.issue.title}\n` +
`正文:${payload.issue.body ?? "(空)"}\n` +
`请按「issue 分诊与回复起草」规范分类并起草回复。`,
};
}
// 非目标事件(如 push):返回 null,OpenClaw 回 204,不创建 run
return null;
}أسماء الحقول في الـ payload (action، number، pull_request وغيرها) تُعتمد وفق صيغة تسليم webhook الرسمية من GitHub، فقارنها مرة بالحدث المستلم فعليًا قبل التوصيل. إذا كان تنسيق الحدث بسيطًا، يمكنك أيضًا عدم كتابة JS واستخدام حقل القالب messageTemplate المدمج في التعيين لتجميع الرسالة؛ أما أحداث GitHub فتتطلب تفرّعًا حسب النوع وترشيحًا للأحداث غير المستهدفة، لذلك نستخدم هنا الـ transform.
تحقق من الصحة، وأعد التشغيل، ثم حاكِ محليًا النوعين من الأحداث بإطلاق واحد لكل منهما:
openclaw config validate
openclaw gateway restart# 模拟新 PR:期望 200 + runId
curl --include http://127.0.0.1:18789/hooks/gh \
-H 'Authorization: Bearer <long-random-hook-token>' \
-H 'Content-Type: application/json' \
-H 'X-GitHub-Event: pull_request' \
--data '{"action":"opened","number":42,"pull_request":{"title":"Add export button","user":{"login":"alice"},"head":{"ref":"feat/export"},"base":{"ref":"main"}}}'
# 模拟 push:期望 204
curl --include http://127.0.0.1:18789/hooks/gh \
-H 'Authorization: Bearer <long-random-hook-token>' \
-H 'Content-Type: application/json' \
-H 'X-GitHub-Event: push' \
--data '{"ref":"refs/heads/main"}'يجب أن ترى: حدث PR المحاكى يعيد HTTP 200 مع { "ok": true, "runId": "<hook-request-run-id>" }؛ وحدث push المحاكى يعيد HTTP 204 — الـ transform أعاد null، والتعيين لا يولّد إجراءً عمدًا، فلن يُنشأ حتى run.
💡 هذه هي القيمة الفريدة لـ OpenClaw
خطافات التعيين هي «طبقة ترجمة أحداث خارجية» عامة: اليوم نربط GitHub، وغدًا نستبدلها بمنصة استضافة أكواد أخرى أو بتنبيهات مراقبة، وكل ذلك مجرد استبدال ملف transform واحد. الـ payload لا يحتوي على message؟ ولّده داخل الـ transform. لا تريد أن تحرق الأحداث غير ذات الصلة جولة محادثة؟ أعِد null، وسيرد OpenClaw بـ 204. هذه قدرة توصيل على مستوى الأحداث لا يمكن لنسخة الويب من الذكاء الاصطناعي توفيرها.
الخطوة 4: تعليق Webhook في مستودع GitHub
لماذا نحتاج وسيطًا عكسيًا: تطلب الوثائق الرسمية إبقاء نقطة نهاية الـ hook خلف loopback أو tailnet أو وسيط عكسي موثوق، وأن تمر الاستدعاءات البعيدة عبر HTTPS. يقع GitHub على الشبكة العامة وGateway لديك على الشبكة الداخلية، ويقوم بينهما وسيط عكسي موثوق بإعادة التوجيه وإضافة ترويسة المصادقة.
أضف hook جديدًا في صفحة Webhooks ضمن إعدادات المستودع:
- Payload URL:
https://<你的公网域名>/hooks/gh— يعيد الوسيط العكسي التوجيه إلى Gateway ويضيف ترويسةAuthorization: Bearer <long-random-hook-token>. - Content type: اختر JSON. نقطة نهاية الـ hook في OpenClaw لا تقبل إلا POST بترويسة
Content-Type: application/json. - أحداث التفعيل: اترك تحديد فئتي Pull requests وIssues فقط، ولا تفعّل كل الأحداث — الأحداث غير المستهدفة سيحجبها الـ transform بـ 204 على أي حال، لكن لا داعي لترك GitHub يسلّمها عبثًا.
- Secret: مفتاح توقيع التسليم على جانب GitHub @@I18N_KEEP_000025@@.
على جانب الوسيط، اكشف فقط المسار الضروري ذاك، ولا تُعرِّض منفذ Gateway بأكمله عاريًا على الشبكة العامة.
يجب أن ترى: في سجلات تسليم Webhook لدى GitHub، الأحداث المستهدفة تعيد 200 والأحداث غير المستهدفة تعيد 204؛ ويظهر في openclaw logs --follow كل من hook agent run completed وrunId المقابل.
الخطوة 5: تهيئة هوية GitHub لوكيل المناوبة
لماذا نحتاج هذه الخطوة: payload الـ webhook لا يحمل سوى معلومات وصفية مثل العنوان والمؤلف؛ ولكي يكون التلخيص والفرز موثوقين، يجب أن يسحب الوكيل بنفسه diff الـ PR ونص الـ issue، وهذا يتطلب هوية GitHub.
الطريقة A (يُنصح بها أولًا لضمان التشغيل): لا تُهيئ شيئًا. هوية GitHub CLI تُحلّ أصلًا (native) افتراضيًا — متغيرات البيئة GH_TOKEN أو GITHUB_TOKEN لعملية Gateway لها الأولوية، ثم keyring/config للمستخدم المشغِّل عبر gh. يكفي إتمام gh auth login على الجهاز الذي يشغّل Gateway (أو تهيئة متغيرات البيئة لعملية Gateway).
الطريقة B (للمناوبة طويلة الأمد): قم بتهيئة tools.github كهوية تنفيذ مشتركة، مع استضافة الاعتمادات لدى Gateway. في Control UI ضمن Settings → Profile → GitHub connections، يختار المسؤول For the system لبدء الاتصال: افتح https://github.com/login/device، والصق الرمز المؤقت الذي يعرضه OpenClaw، ووافق على الأذونات الأربعة repo وworkflow وread:org وgist. بعد نجاح الاتصال، سيظهر في التهيئة مقطع كهذا:
{
tools: {
github: {
profileId: "ghp_0123456789abcdef0123456789abcdef",
kind: "oauth",
gitAuthor: { name: "Automation User", email: "automation@example.com" },
},
},
}ثلاثة حدود يجب معرفتها:
- رمز وصول OAuth تنتهي صلاحيته بعد نحو 8 ساعات، وسيقوم Gateway بتحديثه تلقائيًا قبل انتهاء الصلاحية؛ أما انتهاء صلاحية رمز التحديث فيظهر كـ Reconnect required.
- هوية App لـ
kind: "app-installation"تدعم القراءة في الجلسات الأمامية فقط؛ لتشغيل الوكيل للأدوات، اختر native أو OAuth. - عندما يحتاج وكيل معيّن إلى هوية مختلفة، قم بالتجاوز في
agents.entries.<id>.tools.github، وبدون تهيئة يرث هوية النظام؛ وإذا لم ترغب في استخدام OAuth، يمكنك أيضًا اختيار Use a PAT instead، مما يحفظ مسار إعداد الرموز الشخصية الدقيقة الوصول.
يجب أن ترى: وكيل المناوبة قادر في المحادثة على سحب diff الـ PR ونص الـ issue؛ وإذا كانت الهوية المُدارة مهيأة لكن الاعتمادات مفقودة أو منتهية الصلاحية، فسيُبلّغ حالة GitHub عن configured_unavailable، بدلًا من الرجوع بصمت إلى حساب الجهاز المحلي.
📋 الـ Prompt السحري
الـ transform مسؤول فقط عن ترجمة الحدث إلى رسالة واحدة؛ أما ما يفعله الوكيل بعد استلام الرسالة فيحدده الأمر الدائم الموجود في مساحة عمله. اكتب المقطعين التاليين في AGENTS.md لوكيل المناوبة (في التثبيت الشخصي يكون افتراضيًا في ~/.openclaw/workspace) — الأسماء المُشار إليها في الرسالة التي يولّدها الـ transform هي أسماء هذين المقطعين من المواصفات تحديدًا.
📝 ملخص تغييرات الـ PR
النتيجة المتوقعة: بعد دخول حدث PR جديد، ينتج الوكيل ملخصًا بتنسيق ثابت — ما الذي تغيّر، وأي الوحدات يتأثر، وأين تكمن المخاطر — فتستطيع تقرير أيها تفحص أولًا دون فتح الـ diff.
الدور: أنت الـ reviewer المناوب لهذا المستودع، وتنتج ملخصًا للتغييرات لكل PR جديد.
المهمة: اسحب diff الـ PR ووصفه، وأنتج الملخص وفق مواصفات الإخراج.
معلومات الإدخال:
### الحقول المطلوبة
- 【رقم الـ PR】
- 【عنوان الـ PR】
- 【المؤلف】
- 【الفروع (head → base)】
### الحقول الاختيارية
- 【وصف الـ PR?】
- 【issue المرتبط?】
مواصفات الإخراج:
- السطر الأول: جملة واحدة تلخّص ما يفعله هذا الـ PR.
- قائمة التغييرات: مجمّعة حسب الوحدة، كل عنصر في سطر واحد، مع تحديد جديد/معدّل/محذوف.
- نطاق التأثير: الوظائف أو الواجهات أو الإعدادات المتأثرة.
- المخاطر: الثغرات في الاختبار، التغييرات الكاسرة، الملفات التي تحتاج مراجعة بشرية دقيقة.
القيود:
✅ الاعتماد فقط على diff ووصف الـ PR، دون تخمين نوايا غير مكتوبة
✅ ألا يتجاوز الملخص 20 سطرًا
❌ عدم إعطاء استنتاجات مراجعة مثل «قابل للدمج»، فالقرار يبقى للبشر
❌ عدم تعديل الكود وعدم دفع الفروع📋 فرز المشكلات وصياغة الردود
التأثير المتوقع: تحديد نوع المشكلات الجديدة تلقائيًا، واكتشاف المشكلات المكررة، وصياغة رد جاهز للإرسال مباشرة.
الدور: أنت المسؤول المناوب للفرز في هذا المستودع، تفرز المشكلات الجديدة وتصيغ الردود.
المهمة: اقرأ عنوان المشكلة ونصها، حدّد نوعها، تحقق من التكرار، وصِغ مسودة رد.
معلومات الإدخال:
### الحقول المطلوبة
- 【رقم المشكلة】
- 【عنوان المشكلة】
### الحقول الاختيارية
- 【نص المشكلة؟】
- 【قائمة أرقام المشكلات المشابهة في المستودع؟】
مواصفات الإخراج:
- النوع: خطأ / طلب ميزة / توثيق / مشكلة استخدام / غير ذلك، اختر واحدًا من الخمسة.
- حكم التكرار: عند الاشتباه في التكرار أعطِ رقم المشكلة الموجودة؛ وإن لم تجد شيئًا فاكتب «لم يُكتشف تكرار».
- مسودة الرد: رد بالصينية جاهز للإرسال مباشرة — يؤكد الفهم ويحدد الخطوة التالية.
القيود:
✅ عند نقص المعلومات، اذكر في المسودة ما يحتاج صاحب السؤال إلى استكماله
✅ نبرة محددة ومؤدبة، دون تسرّع أو تجاهل
❌ عدم إغلاق المشكلة من تلقاء نفسك وعدم تعديل ملفات المستودع
❌ عدم الالتزام بمواعيد أو إصدارات للإصلاحنقاط التحقق ✅
معايير نجاح خط المناوبة بأكمله، راجعها بندًا بندًا:
openclaw config validateنجح، ولا توجد أخطاء hooks في السجلات بعد إعادة التشغيل.- اختبار curl في الخطوة 2 يعيد 200، ويظهر
runIdفي نص الاستجابة. - الخطوة 3: محاكاة
pull_requestتعيد 200، ومحاكاةpushتعيد 204 (دون إنشاء run). - الخطوة 4: يظهر 200/204 في سجل تسليمات Webhook على GitHub، ويمكن البحث عن
hook agent run completedفيopenclaw logs --follow. - الخطوة 5: يستطيع agent المناوبة جلب diff الـ PR ونص المشكلة في الجلسة.
- سجل الإكمال هو
status=ok؛ إذا رأيت warn معstatus=okوdeliveryError، فالتنفيذ نجح لكن التسليم فشل، فتحقق من وجهة التسليم.
تنبيهات المخاطر الشائعة
| الظاهرة | غالبًا السبب | كيفية المعالجة |
|---|---|---|
401 | hook token غير صحيح، أو الوكيل لا يعيد توجيه ترويسة المصادقة | تحقق من hook token المخصص (وليس auth الخاص بـ Gateway)؛ وتأكد من أن الوكيل يعيد توجيه ترويسة Authorization كما هي |
404 | hooks.enabled أو hooks.path أو مسار الربط غير مطابق | تأكد من أن match.path: "gh" يطابق /hooks/gh؛ ولا تسمِّ المسار المخصص agent أو wake، وأعطِ أولوية نقاط الاتصال المباشر |
204 | الربط لا يُنشئ أي إجراء عمدًا | ليس خطأً: إعادة transform لقيمة null أو fan-out فارغ يعطي 204 |
200 لكن لم تصل رسالة | deliver: false منع إعلان النجاح | راجع سجل الإكمال أولًا؛ ولتسليم الرسائل اضبط للربط قيمًا صريحة لـ channel وto |
500 | ألقى transform استثناءً | انظر hook mapping failed في السجلات، وأصلح transform ثم أعد التشغيل |
ثلاثة خطوط دفاع أمنية، لا تستغنِ عنها:
- token مخصص ومسار فرعي مخصص: يُفصل hook token عن مصادقة المفتاح المشترك لـ Gateway؛ واستخدام
/كمسار سيُرفض. - اكشف المسارات الضرورية فقط: ضع نقاط الاتصال خلف loopback أو tailnet أو وكيل عكسي موثوق، واستخدم HTTPS للاستدعاءات البعيدة.
- تعامل مع المحتوى الخارجي كبيانات: يُغلَّف الـ payload افتراضيًا بطبقة safety-wrap، لكن هذا التغليف لا يزيل وصول agent إلى الأدوات ومساحة العمل — استخدم agent مقيّدًا للمدخلات غير الموثوقة وأبقِ
allowUnsafeExternalContentمغلقًا.
خلاصة هذا الدرس
- تتكون خط المناوبة OpenClaw GitHub من أربعة عناصر: Webhook وارد يفتح الباب، وخطاف ربط يترجم، وagent مناوبة ينفذ العمل، وهوية GitHub تقرأ المستودع.
- ثلاثة أمور تستحق أن تأخذها معك:
hooks.mappingsيستطيع تحويل أي payload خارجي إلى إجراءات agent؛ وإعادة transform لقيمة null تستخدم 204 لصدّ الأحداث غير المستهدفة دون إنشاء run؛ وdeliverيحدد ما إذا كان حدث الإكمال سيُعاد إلى الجلسة الرئيسية. - خطوط الدفاع الأمنية ثلاثة: token مخصص، كشف المسارات الضرورية فقط، والتعامل مع المحتوى الخارجي كبيانات.
- ملخص الـ PR وفرز المشكلات ينتجان «مسودات وأحكامًا» فقط، والقرارات مثل الدمج والإغلاق تبقى للبشر — هذه مناوبة، لا تفويض سلطة.
استعراض الدرس التالي
بعد نجاح خط المناوبة ستتساءل غالبًا: مراجعة الـ PR وفرز المشكلات محشورتان في تعليمات agent واحد، فهل يمكن استقدام خبير لكل منهما؟ الدرس التالي«تعاون الوكلاء المتعددين: Gateway واحد يشغّل عدة خبراء» يشرح كيفية تشغيل عدة وكلاء معزولين بعضهم عن بعض داخل Gateway واحد — لكلٍّ منهم workspace وسجل جلسات مستقلان، مع استخدام bindings لتوجيه الرسائل المختلفة إلى الخبراء المختلفين، وتقسيم خط المناوبة اليوم إلى «خبير PR + خبير مشكلات».