Skip to content

GitHub ड्यूटी: PR सारांश और issue स्वचालित प्रोसेसिंग ​

💡 एक लाइन में सारांश: OpenClaw से एक 7×24 GitHub ड्यूटी लाइन बनाएँ — इनबाउंड Webhook इवेंट्स लेता है, मैपिंग हुक उन्हें कार्यों में बदलता है, ड्यूटी agent सारांश और उत्तर देता है।

रिपॉजिटरी में PR बढ़ने पर मैन्युअल रूप से diff देखना मुश्किल हो जाता है; issue में दोहराए गए सवालों का समय पर उत्तर भी नहीं मिलता। यह पेज आपको एक OpenClaw GitHub ड्यूटी लाइन बनाने में मदद करता है: इनबाउंड Webhook से रिपॉजिटरी इवेंट्स ड्यूटी agent तक पहुँचते हैं, नया PR आते ही स्वचालित बदलाव-सारांश बनता है, नया issue स्वचालित रूप से ट्राइएज होकर उत्तर का ड्राफ्ट तैयार होता है। शुरू करने से पहले 《Claw से कोड लिखवाना: exec, पैच और अनुमोदन》 पूरा कर लें, और पुष्टि करें कि आपका agent कार्य का एक चक्र सामान्य रूप से पूरा कर सकता है। सभी उदाहरण OpenClaw v2026.10.9 पर आधारित हैं।

सीखने के बाद आप क्या कर सकते हैं ​

  • नया PR रिपॉजिटरी में आते ही ड्यूटी agent स्वचालित रूप से निश्चित फ़ॉर्मेट में बदलाव-सारांश बनाता है: क्या बदला, कौन से मॉड्यूल प्रभावित हुए, जोखिम कहाँ है।
  • नए issue स्वचालित ट्राइएज: प्रकार की पहचान, दोहराए गए प्रश्नों की पहचान, और सीधे भेजने योग्य उत्तर का ड्राफ्ट।
  • curl से पूरी ड्यूटी लाइन का लोकल स्मोक सत्यापन, असली PR का इंतज़ार किए बिना।
  • गैर-लक्ष्य इवेंट्स (जैसे push) स्वचालित रूप से 204 लौटाते हैं, agent नहीं जागता, एक चक्र की बातचीत बर्बाद नहीं होती।

वेब-आधारित AI के बजाय OpenClaw ही क्यों? ​

क्षमतावेब-आधारित AIOpenClaw
7×24 प्रतिक्रिया❌ आप पेज नहीं खोलेंगे, तो वह हिलेगा नहीं✅ Gateway स्थायी रूप से चलता है, इवेंट आते ही प्रोसेस होते हैं
रिपॉजिटरी सामग्री पढ़ना❌ diff मैन्युअल रूप से पेस्ट करें, लंबा हो तो समा नहीं पाता✅ agent के पास GitHub पहचान है, वह खुद PR diff और issue मुख्य भाग खींचता है
इवेंट-संचालित❌ लिंक मैन्युअल रूप से कॉपी करके पूछें✅ इनबाउंड Webhook + मैपिंग हुक, इवेंट स्वचालित रूप से कार्य बन जाते हैं
ट्रेस करके समस्या खोजना❌ बातचीत बंद करते ही वापस नहीं मिलती✅ हर अनुरोध का runId है, लॉग्स से पूर्णता स्थिति देखी जा सकती है
अनुमति सीमाएँ❌ कोई नहीं✅ allowedAgentIds जागने योग्य agent सीमित करता है, लेखन कार्यों पर अनुमोदन यथावत

आपकी वर्तमान दुविधा ​

  • सुबह रिपॉजिटरी खोलते ही नए PR और नए issue कतार में लगे मिलते हैं, एक-एक करके diff देखने में पूरी सुबह चली जाती है।
  • दोहराए गए issue बार-बार आते हैं, आप पहले ट्राइएज करके टैग लगाना चाहते हैं, लेकिन यह काम अपने आप में ही बहुत समय लेता है।
  • diff मैन्युअल रूप से वेब-आधारित AI को पेस्ट करें? लंबा diff पूरा नहीं समाता, संदर्भ खो जाता है, और परिणाम का इंतज़ार भी करना पड़ता है।

यह तरीका कब अपनाएँ ​

  • टीम रिपॉजिटरी में रोज़ नए PR और issue आते हैं, मैन्युअल ड्यूटी गति के साथ नहीं चल पाती।
  • आपको एकसमान फ़ॉर्मेट वाले PR सारांश चाहिए, ताकि तुरंत तय किया जा सके कि पहले कौन सा देखें।
  • issue को प्रारंभिक ट्राइएज चाहिए: वर्गीकरण, दोहराव पहचान, और पूछने वाले को एक ड्राफ्ट उत्तर।
  • आपके पास Gateway चलाने वाली एक 7×24 मशीन पहले से है, और आपने पिछले पेज के exec और अनुमोदन सफलतापूर्वक चला लिए हैं।

🎒 शुरू करने से पहले की तैयारी ​

  • एक चलता हुआ Gateway, और agent जो सामान्य रूप से बातचीत का एक चक्र पूरा कर सके — यह webhook के लिए आधिकारिक पूर्व-शर्त है।
  • एक लंबा रैंडम समर्पित token। आधिकारिक रूप से स्पष्ट कहा गया है: Gateway प्रमाणीकरण token या पासवर्ड का पुनः उपयोग न करें।
  • GitHub रिपॉजिटरी का एडमिन अनुमति, Webhook जोड़ने के लिए।
  • एक सार्वजनिक HTTPS प्रवेश (भरोसेमंद रिवर्स प्रॉक्सी): GitHub के सर्वर आपके Gateway तक पहुँच सकें, प्रमाणीकरण हेडर भी यही जोड़े (चरण 4 में विस्तार से)।
  • agent की GitHub सामग्री पढ़ने की पहचान: tools.github न कॉन्फ़िगर करने पर gh नेटिव रेज़ॉल्यूशन चलता है, साझा निष्पादन पहचान के लिए tools.github कॉन्फ़िगर करें (चरण 5 में विस्तार से)।

मेरे साथ करें ​

चरण 1: इनबाउंड Webhook चालू करें, OpenClaw GitHub ड्यूटी लाइन जगाएँ ​

यह चरण पहले क्यों: इनबाउंड Webhook डिफ़ॉल्ट रूप से बंद रहता है, इसे न चालू करें तो GitHub के इवेंट्स OpenClaw तक पहुँच ही नहीं पाते।

पहले hooks कॉन्फ़िगरेशन ब्लॉक को Gateway कॉन्फ़िगरेशन में मर्ज करें। token को अपने समर्पित लंबे रैंडम मान से बदलें, main को ड्यूटी agent के id से बदलें:

json5
{
  hooks: {
    enabled: true,
    token: "<long-random-hook-token>",
    path: "/hooks",
    allowedAgentIds: ["main"],
    allowRequestSessionKey: false,
  },
}

कॉन्फ़िगरेशन सत्यापित करें, सेवा रीस्टार्ट करें, लॉग्स पर नज़र रखें:

bash
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 से पर्सिस्ट किया गया रीयूज़्ड token रोटेट करें, फिर सभी बाहरी सेंडर्स को अपडेट करें।

चरण 2: ऑन-कॉल agent का लोकल स्मोक टेस्ट ​

स्मोक टेस्ट क्यों: पहले अपनी मशीन पर वेरिफाई करें कि एंडपॉइंट, token और agent एक्सेप्टेंस सब सही हैं, उसके बाद ही बाहरी ट्रैफिक अंदर आने दें, ताकि समस्या होने पर पता लगाना आसान हो।

एक और टर्मिनल खोलें, और अपने लोकल Gateway के /hooks/agent पर एक हानिरहित टेस्ट मैसेज भेजें:

bash
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, रिस्पॉन्स बॉडी है:

json
{ "ok": true, "runId": "<hook-request-run-id>" }

200 का मतलब नोट करें: यह केवल यह दर्शाता है कि रिक्वेस्ट को सेशन/ग्लोबल एक्सेप्टेंस मिल गई है; इसका मतलब यह नहीं कि मॉडल पूरा चला, टूल सफल रहा या मैसेज डिलीवर हो गया; एक रिक्वेस्ट को एक्सेप्ट होने में अधिकतम 15 सेकंड तक इंतज़ार करना पड़ सकता है। openclaw logs --follow में hook agent run completed और इस runId को सर्च करें: status=ok और बिना डिलीवरी एरर के info लेवल पर लॉग होता है; नॉन-ok स्टेटस (स्किप किए गए run सहित), थ्रो की गई एरर और स्पष्ट डिलीवरी एरर warn लेवल पर लॉग होते हैं——लेकिन status=ok के साथ deliveryError वाली चेतावनी का मतलब है कि एग्जीक्यूशन सफल रहा लेकिन डिलीवरी विफल रही।

उदाहरण में deliver: false स्मोक टेस्ट के लिए एक उचित मान है: सक्सेस अनाउंसमेंट दबा दिया जाता है, टारगेट फील्ड को इग्नोर किया जाता है, कम्प्लीशन रिजल्ट केवल लॉग में जाता है (नॉन-ok परिणाम अब भी फेलियर इवेंट पैदा करेगा)। GitHub इवेंट्स को औपचारिक रूप से जोड़ते समय आवश्यकतानुसार चुनें: अगर आप ऑन-कॉल agent के मुख्य सेशन में कम्प्लीशन नोटिफिकेशन पाना चाहते हैं, तो डिफ़ॉल्ट deliver: true का उपयोग करें, यह टारगेट agent के मुख्य सेशन में एक कम्प्लीशन सिस्टम इवेंट भेजेगा; अगर केवल लॉग देखना है तो false पर रखें।

चरण 3: मैपिंग हुक कॉन्फ़िगर करें, GitHub payload को agent टास्क में बदलें ​

यह चरण क्यों नहीं छोड़ सकते: GitHub से आने वाले रॉ payload में message फील्ड नहीं होता, और यह Authorization: Bearer ऑथेंटिकेशन हेडर भी नहीं ला सकता, Webhook को सीधे /hooks/agent पर पॉइंट करना विफल होगा। बाहरी इवेंट्स के लिए ऑफिशियल मैकेनिज्म मैपिंग हुक है: hooks.mappings में एक कस्टम पाथ के लिए एक ट्रस्टेड JS/TS transform कॉन्फ़िगर करें, जो payload को agent एक्शन में अनुवादित करता है।

पहले hooks कॉन्फ़िगरेशन में एक मैपिंग जोड़ें (match.path: "gh" मैच करता है /hooks/gh):

json5
{
  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 कोड है और कैश हो जाता है, बदलने के बाद रीस्टार्ट करना ज़रूरी है:

js
// ~/.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 आदि) GitHub के ऑफिशियल webhook डिलीवरी फॉर्मेट के अनुसार हैं, वायरिंग से पहले वास्तव में प्राप्त इवेंट से एक बार मिलान कर लें। अगर इवेंट फॉर्मेट सरल है, तो JS लिखे बिना भी मैपिंग के messageTemplate टेम्प्लेट फील्ड से message बना सकते हैं; GitHub इवेंट्स को टाइप के अनुसार ब्रांच करना होता है और नॉन-टारगेट इवेंट्स को भी फ़िल्टर करना होता है, इसलिए यहाँ transform का उपयोग किया गया है।

वैलिडेट करें, रीस्टार्ट करें, फिर लोकल पर दोनों इवेंट्स का सिम्युलेशन एक-एक बार चलाएँ:

bash
openclaw config validate
openclaw gateway restart
bash
# 模拟新 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 रिटर्न किया, मैपिंग जानबूझकर कोई एक्शन नहीं पैदा करती, रन तक नहीं बनता।

💡 यही OpenClaw का अनूठा मूल्य है

मैपिंग हुक एक सामान्य-उद्देश्य「बाहरी इवेंट ट्रांसलेशन लेयर」है: आज GitHub जोड़ा, कल कोई और कोड होस्टिंग प्लेटफ़ॉर्म या मॉनिटरिंग अलर्ट जोड़ना हो, तो बस एक transform फ़ाइल बदलने की बात है। payload में message नहीं है? transform में जनरेट करें। अनसंबंधित इवेंट्स को एक राउंड बर्न न करने देना चाहते हैं? null रिटर्न करें, OpenClaw 204 देता है। यह वह इवेंट-लेवल वायरिंग क्षमता है जो वेब-आधारित AI नहीं दे सकता।

चरण 4: GitHub रिपॉज़िटरी पर Webhook लगाएँ ​

रिवर्स प्रॉक्सी क्यों: ऑफिशियल आवश्यकता है कि hook एंडपॉइंट loopback, tailnet या ट्रस्टेड रिवर्स प्रॉक्सी के पीछे रहे, और रिमोट कॉल HTTPS पर जाएँ। GitHub पब्लिक नेटवर्क पर है, आपका Gateway आंतरिक नेटवर्क पर, बीच में ट्रस्टेड रिवर्स प्रॉक्सी फॉरवर्ड करता है और ऑथेंटिकेशन हेडर जोड़ता है।

रिपॉज़िटरी सेटिंग्स के Webhooks पेज पर एक नया hook जोड़ें:

  • Payload URL: https://<你的公网域名>/hooks/gh——रिवर्स प्रॉक्सी द्वारा Gateway पर फॉरवर्ड किया जाता है, और Authorization: Bearer <long-random-hook-token> रिक्वेस्ट हेडर जोड़ा जाता है।
  • Content type: JSON चुनें। OpenClaw का hook एंडपॉइंट केवल Content-Type: application/json वाले POST स्वीकार करता है।
  • ट्रिगर इवेंट्स: केवल Pull requests और Issues दो श्रेणियाँ चुनें, पूरे इवेंट सेट मत खोलें——नॉन-टारगेट इवेंट्स transform द्वारा 204 से रोक दिए जाएँगे, लेकिन GitHub को बेकार एक राउंड डिलीवर करवाने की ज़रूरत नहीं है।
  • Secret: GitHub की ओर से डिलीवरी साइनिंग की @@I18N_KEEP_000025@@।

प्रॉक्सी की ओर से केवल ज़रूरी पाथ ही एक्सपोज़ करें, पूरा Gateway पोर्ट पब्लिक नेटवर्क पर मत खोलें।

आपको यह दिखना चाहिए: GitHub के Webhook डिलीवरी रिकॉर्ड में, टारगेट इवेंट पर 200 और नॉन-टारगेट इवेंट पर 204; openclaw logs --follow में hook agent run completed और संबंधित runId दिखेंगे।

चरण 5: ऑन-कॉल agent के लिए GitHub पहचान कॉन्फ़िगर करें ​

यह चरण क्यों ज़रूरी है: webhook payload में केवल टाइटल, ऑथर जैसी मेटा-जानकारी होती है; समरी और ट्राइएज भरोसेमंद हों, इसके लिए agent को खुद PR diff और issue बॉडी खींचनी होगी, और इसके लिए एक GitHub पहचान चाहिए।

तरीका A (पहले चलाने की सिफारिश): कुछ भी कॉन्फ़िगर न करें। GitHub CLI पहचान डिफ़ॉल्ट रूप से नेटिव रेज़ॉल्व होती है——Gateway प्रोसेस के GH_TOKEN या GITHUB_TOKEN एनवायरनमेंट वेरिएबल को प्राथमिकता, उसके बाद रनिंग यूज़र का gh keyring/config। Gateway चलाने वाली मशीन पर gh auth login पूरा करें (या 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 चार अनुमतियाँ स्वीकृत करें। कनेक्शन सफल होने पर, कॉन्फ़िगरेशन में ऐसा एक सेक्शन दिखेगा:

json5
{
  tools: {
    github: {
      profileId: "ghp_0123456789abcdef0123456789abcdef",
      kind: "oauth",
      gitAuthor: { name: "Automation User", email: "automation@example.com" },
    },
  },
}

तीन सीमाएँ जानना ज़रूरी है:

  • OAuth access token लगभग 8 घंटे में एक्सपायर होता है, Gateway इसे एक्सपायर होने से पहले ऑटो-रिफ्रेश कर देगा; रिफ्रेश टोकन अमान्य होने पर Reconnect required दिखेगा।
  • kind: "app-installation" की App पहचान केवल फ़ोरग्राउंड सेशन रीडिंग सपोर्ट करती है; agent को टूल चलाने देने के लिए native या OAuth चुनें।
  • किसी agent को अलग पहचान चाहिए हो, तो agents.entries.<id>.tools.github में ओवरराइड करें, न कॉन्फ़िगर करने पर सिस्टम पहचान इनहेरिट होती है; OAuth नहीं चाहते तो Use a PAT instead भी चुन सकते हैं, जो फ़ाइन-ग्रेन्ड पर्सनल एक्सेस टोकन का सेटिंग रास्ता बनाए रखता है।

आपको यह दिखना चाहिए: ऑन-कॉल agent सेशन में PR diff और issue बॉडी खींच सकता है; अगर मैनेज्ड पहचान कॉन्फ़िगर की गई है लेकिन क्रेडेंशियल गायब या अमान्य हैं, तो GitHub स्टेटस configured_unavailable रिपोर्ट करेगा, चुपचाप लोकल अकाउंट पर वापस नहीं गिरेगा।

📋 मैजिकल Prompt ​

transform केवल इवेंट को एक message में अनुवादित करने के लिए ज़िम्मेदार है; message मिलने के बाद agent क्या करेगा, यह उसके वर्कस्पेस की स्थायी निर्देशों से तय होता है। नीचे के दो सेक्शन ऑन-कॉल agent के AGENTS.md में लिखें (पर्सनल इंस्टॉल में डिफ़ॉल्ट ~/.openclaw/workspace पर)——transform द्वारा जनरेट किए गए message में रेफ़रेंस किए गए नाम ठीक इन्हीं दो स्पेसिफिकेशन के हैं।

📝 PR बदलाव सारांश ​

अपेक्षित परिणाम: नए PR इवेंट आने के बाद, agent निश्चित फॉर्मेट में सारांश देता है——क्या बदला, कौन से मॉड्यूल प्रभावित हुए, जोखिम कहाँ है; आपको diff खोले बिना ही तय करना होगा कि पहले कौन सा देखें।

text
भूमिका: आप इस रिपॉज़िटरी के ऑन-कॉल reviewer हैं, नए खुले PR के लिए बदलाव सारांश तैयार करते हैं।
कार्य: PR का diff और डिस्क्रिप्शन खींचें, और आउटपुट स्पेसिफिकेशन के अनुसार सारांश तैयार करें।
इनपुट जानकारी:
### अनिवार्य फील्ड
- 【PR नंबर】
- 【PR टाइटल】
- 【ऑथर】
- 【ब्रांच (head → base)】
### वैकल्पिक फील्ड
- 【PR डिस्क्रिप्शन?】
- 【संबंधित issue?】
आउटपुट स्पेसिफिकेशन:
- पहली पंक्ति: एक वाक्य में बताएँ कि यह PR क्या करता है।
- बदलावों की सूची: मॉड्यूल के अनुसार समूहबद्ध, प्रत्येक आइटम एक पंक्ति में, नया/संशोधित/हटाया गया चिह्नित करें।
- प्रभाव क्षेत्र: प्रभावित होने वाली कार्यक्षमताएँ, इंटरफ़ेस या कॉन्फ़िगरेशन।
- जोखिम: परीक्षण के कमियाँ, ब्रेकिंग बदलाव, ऐसी फ़ाइलें जिन पर मानव का विशेष ध्यान देना ज़रूरी है।
बाध्यकारी शर्तें:
✅ केवल diff और PR विवरण के आधार पर, जो लिखा नहीं गया है उसका इरादा अनुमान न लगाएँ
✅ सारांश 20 पंक्तियों से अधिक न हो
❌ «मर्ज किया जा सकता है» जैसा समीक्षा निष्कर्ष न दें, निर्णय मनुष्य पर छोड़ें
❌ कोड संशोधित न करें, ब्रांच पुश न करें

📋 issue ट्राइएज और उत्तर का ड्राफ़्ट ​

अपेक्षित परिणाम: नए issue का प्रकार स्वतः निर्धारित हो, डुप्लिकेट पहचाने जाएँ, और एक ऐसा उत्तर ड्राफ़्ट हो जिसे सीधे भेजा जा सके।

text
भूमिका: आप इस रिपॉज़िटरी के ऑन-ड्यूटी triager हैं, जो नए issue का ट्राइएज करता है और उत्तर का ड्राफ़्ट तैयार करता है।
कार्य: issue का शीर्षक और मुख्य पाठ पढ़ें, प्रकार निर्धारित करें, डुप्लिकेट खोजें, उत्तर का ड्राफ़्ट तैयार करें।
इनपुट जानकारी:
### अनिवार्य फील्ड
- 【issue संख्या】
- 【issue शीर्षक】
### वैकल्पिक फील्ड
- 【issue मुख्य पाठ?】
- 【रिपॉज़िटरी के भीतर समान issue की संख्याओं की सूची?】
आउटपुट स्पेसिफिकेशन:
- प्रकार: bug / फ़ीचर अनुरोध / दस्तावेज़ / उपयोग संबंधी प्रश्न / अन्य, इन पाँच में से एक चुनें।
- डुप्लिकेट निर्धारण: संदिग्ध डुप्लिकेट होने पर मौजूदा issue की संख्या दें; खोज न मिले तो «कोई डुप्लिकेट नहीं मिला» लिखें।
- उत्तर ड्राफ़्ट: एक सीधे भेजा जा सकने वाला चीनी उत्तर — समझ की पुष्टि करें, अगला कदम बताएँ।
बाध्यकारी शर्तें:
✅ जानकारी अपर्याप्त होने पर, ड्राफ़्ट में वे बातें सूचीबद्ध करें जो प्रश्नकर्ता को जोड़नी चाहिए
✅ स्वर स्पष्ट और विनम्र हो, लापरवाही न हो
❌ issue स्वयं बंद न करें, रिपॉज़िटरी की फ़ाइलें न बदलें
❌ सुधार का समय या संस्करण का वादा न करें

चेकपॉइंट ✅ ​

पूरी ऑन-ड्यूटी लाइन चलने का मानक, प्रत्येक से मिलान करें:

  • openclaw config validate पास हो, पुनरारंभ के बाद लॉग में hooks की कोई त्रुटि नहीं।
  • चरण 2 का curl स्मोक टेस्ट 200 लौटाता है, प्रतिक्रिया बॉडी में runId होता है।
  • चरण 3: सिम्युलेटेड pull_request 200 लौटाता है, सिम्युलेटेड push 204 लौटाता है (कोई run नहीं बनता)।
  • चरण 4: GitHub के Webhook डिलीवरी रिकॉर्ड में 200/204 दिखाई देता है, openclaw logs --follow में hook agent run completed खोजा जा सकता है।
  • चरण 5: ऑन-ड्यूटी agent सत्र में PR diff और issue का मुख्य पाठ खींच सकता है।
  • पूर्णता लॉग status=ok है; यदि status=ok के साथ deliveryError वाला warn दिखे, तो निष्पादन सफल था लेकिन डिलीवरी विफल — डिलीवरी लक्ष्य की जाँच करें।

आम ग़लतियों की चेतावनी ​

लक्षणअक्सर कारणकैसे संभालें
401hook token ग़लत है, या प्रॉक्सी प्रमाणीकरण हेडर फॉरवर्ड नहीं करतासमर्पित hook token की जाँच करें (Gateway auth नहीं); देखें कि प्रॉक्सी Authorization हेडर जस-का-तस फॉरवर्ड करता है या नहीं
404hooks.enabled, hooks.path या मैपिंग पथ मेल नहीं खातेपुष्टि करें कि match.path: "gh" से /hooks/gh मेल खाता है; कस्टम पथ का नाम agent या wake न रखें, सीधे कनेक्शन वाले एंडपॉइंट को प्राथमिकता
204मैपिंग जानबूझकर कोई क्रिया नहीं करतीयह त्रुटि नहीं है: transform का null लौटना या खाली fan-out, दोनों 204
200 लेकिन संदेश प्राप्त नहीं हुआdeliver: false ने सफलता की घोषणा को रोकापहले पूर्णता लॉग देखें; डिलीवरी चाहिए तो मैपिंग को स्पष्ट channel और to दें
500transform ने अपवाद फेंकालॉग में hook mapping failed देखें, transform ठीक करके पुनरारंभ करें

तीन सुरक्षा की न्यूनतम सीमाएँ, इन्हें न छोड़ें:

  • समर्पित token, समर्पित उप-पथ: hook token और Gateway के साझा रहस्य प्रमाणीकरण अलग रखें; / पथ के रूप में अस्वीकार कर दिया जाएगा।
  • केवल आवश्यक पथ ही उजागर करें: एंडपॉइंट को loopback, tailnet या विश्वसनीय रिवर्स प्रॉक्सी के पीछे रखें, दूरस्थ कॉल HTTPS पर चलाएँ।
  • बाहरी सामग्री को डेटा मानें: payload डिफ़ॉल्ट रूप से safety-wrapped होता है, लेकिन यह रैपर agent के टूल और वर्कस्पेस एक्सेस नहीं हटाता — अविश्वसनीय इनपुट के लिए प्रतिबंधित agent उपयोग करें, allowUnsafeExternalContent बंद रखें।

इस पाठ का सार ​

  • एक OpenClaw GitHub ऑन-ड्यूटी लाइन चार चीज़ों से बनती है: इनबाउंड Webhook दरवाज़ा खोलता है, मैपिंग hook अनुवाद करता है, ऑन-ड्यूटी agent काम करता है, GitHub पहचान रिपॉज़िटरी पढ़ती है।
  • तीन बातें साथ ले जाने लायक हैं: hooks.mappings किसी भी बाहरी payload को agent क्रिया में बदल सकता है; transform का null लौटना 204 से ग़ैर-लक्ष्य इवेंट रोकता है, कोई run नहीं बनता; deliver तय करता है कि पूर्णता इवेंट मुख्य सत्र में वापस भेजा जाए या नहीं।
  • सुरक्षा की तीन न्यूनतम सीमाएँ: समर्पित token, केवल आवश्यक पथ उजागर करें, बाहरी सामग्री को डेटा मानें।
  • PR सारांश और issue ट्राइएज दोनों केवल «ड्राफ़्ट और निर्णय» उत्पन्न करते हैं, मर्ज या बंद करने जैसे निर्णय मनुष्य पर छोड़ें — यह ड्यूटी है, अधिकार हस्तांतरण नहीं।

अगले पाठ की झलक ​

ऑन-ड्यूटी लाइन चलने के बाद आपको संभवतः लगेगा: PR समीक्षा और issue ट्राइएज एक ही agent के निर्देशों में भरे हुए हैं, क्या हर एक के लिए एक विशेषज्ञ नियुक्त किया जा सकता है? अगला पाठ《मल्टी-Agent सहयोग: एक Gateway पर कई विशेषज्ञ》 बताता है कि एक ही Gateway में एक-दूसरे से पृथक कई agent कैसे चलाएँ — प्रत्येक का अपना स्वतंत्र workspace और सत्र इतिहास, bindings से अलग-अलग संदेश अलग-अलग विशेषज्ञों को रूट करें, और आज की ऑन-ड्यूटी लाइन को «PR विशेषज्ञ + issue विशेषज्ञ» में विभाजित करें।

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.