इंस्टॉल करें
चैनल को कॉन्फ़िगर करने से पहले LINE इंस्टॉल करें:सेटअप
- एक LINE Developers खाता बनाएँ और Console खोलें: https://developers.line.biz/console/
- एक Provider बनाएँ (या चुनें) और एक Messaging API चैनल जोड़ें।
- चैनल सेटिंग से Channel access token और Channel secret कॉपी करें।
- Messaging API सेटिंग में Use webhook सक्षम करें।
- Webhook URL को अपने Gateway एंडपॉइंट पर सेट करें (HTTPS आवश्यक है):
200 लौटाने से पहले प्रत्येक इवेंट को टिकाऊ इनग्रेस क्यू में लिखता है;
एजेंट प्रोसेसिंग एसिंक्रोनस रूप से जारी रहती है। विफल डिलीवरी का क्यू से पुनः प्रयास किया जाता है,
जिसमें Gateway रीस्टार्ट के बाद के प्रयास भी शामिल हैं, और सीमित पुनः प्रयासों के बाद दोषपूर्ण इवेंट
विफल क्यू रिकॉर्ड बन जाते हैं। यदि टिकाऊ परसिस्टेंस विफल हो जाए, तो अनुरोध किसी ऐसे इवेंट की
पावती देने के बजाय 500 लौटाता है जो खो सकता है।
क्यू-से-एजेंट सीमा पर डिलीवरी कम-से-कम एक बार होती है: सक्रिय डिलीवरी के दौरान Gateway के
बंद होने या क्रैश होने से टर्न दोबारा चल सकता है। मैसेज इवेंट LINE मैसेज ID के आधार पर
डीडुप्लिकेट होते हैं; अन्य इवेंट प्रकार webhookEventId का उपयोग करते हैं। सुरक्षित रखे गए पूर्णता रिकॉर्ड
सामान्य डुप्लिकेट Webhook को रोकते हैं, लेकिन बाहरी साइड इफ़ेक्ट उत्पन्न करने वाले हैंडलर
फिर भी आइडेम्पोटेंट होने चाहिए।
यदि आपको कस्टम पाथ चाहिए, तो channels.line.webhookPath या
channels.line.accounts.<id>.webhookPath सेट करें और URL को उसी के अनुसार अपडेट करें।
सुरक्षा संबंधी टिप्पणियाँ:
- LINE हस्ताक्षर सत्यापन बॉडी पर निर्भर है (रॉ बॉडी पर HMAC), इसलिए OpenClaw सत्यापन से पहले 64 KB की सख्त प्री-ऑथ बॉडी सीमा और रीड टाइमआउट लागू करता है।
- OpenClaw सत्यापित रॉ अनुरोध बाइट से Webhook इवेंट प्रोसेस करता है। हस्ताक्षर-अखंडता की सुरक्षा के लिए अपस्ट्रीम मिडलवेयर द्वारा रूपांतरित
req.bodyमानों को अनदेखा किया जाता है।
कॉन्फ़िगर करें
न्यूनतम कॉन्फ़िग:LINE_CHANNEL_ACCESS_TOKENLINE_CHANNEL_SECRET
tokenFile और secretFile का नियमित फ़ाइलों की ओर संकेत करना आवश्यक है। सिमलिंक अस्वीकार किए जाते हैं।
इनलाइन कॉन्फ़िग मानों को फ़ाइलों पर प्राथमिकता मिलती है; डिफ़ॉल्ट खाते के लिए एनवायरनमेंट वेरिएबल अंतिम फ़ॉलबैक हैं।
एकाधिक खाते:
एक्सेस नियंत्रण
डायरेक्ट मैसेज में डिफ़ॉल्ट रूप से पेयरिंग होती है। अज्ञात प्रेषकों को एक पेयरिंग कोड मिलता है और स्वीकृत होने तक उनके मैसेज अनदेखे किए जाते हैं:channels.line.dmPolicy:pairing | allowlist | open | disabled(डिफ़ॉल्टpairing)channels.line.allowFrom: DM के लिए अनुमति-सूचीबद्ध LINE यूज़र ID;dmPolicy: "open"के लिए["*"]आवश्यक हैchannels.line.groupPolicy:allowlist | open | disabled(डिफ़ॉल्टallowlist)channels.line.groupAllowFrom: ग्रुप के लिए अनुमति-सूचीबद्ध LINE यूज़र ID; DM कीallowFromप्रविष्टियाँ ग्रुप प्रेषकों को प्रवेश नहीं देतीं- प्रति-ग्रुप ओवरराइड:
channels.line.groups.<groupId>.allowFrom(साथ मेंenabled,requireMention,systemPrompt,skills)। जबgroupPolicy: "allowlist"हो, तबgroupAllowFromया प्रति-ग्रुपallowFromसेट करें; खाली ग्रुप अनुमति सूची, DM खुले होने पर भी ग्रुप मैसेज ब्लॉक करती है। - स्थिर प्रेषक एक्सेस ग्रुप को
allowFrom,groupAllowFromऔर प्रति-ग्रुपallowFromसेaccessGroup:<name>के साथ संदर्भित किया जा सकता है; एक्सेस ग्रुप देखें। - रनटाइम टिप्पणी: यदि
channels.lineपूरी तरह अनुपस्थित है, तो रनटाइम ग्रुप जाँच के लिएgroupPolicy="allowlist"पर फ़ॉलबैक करता है (भले हीchannels.defaults.groupPolicyसेट हो)।
- यूज़र:
U+ 32 हेक्स वर्ण - ग्रुप:
C+ 32 हेक्स वर्ण - रूम:
R+ 32 हेक्स वर्ण
मैसेज व्यवहार
- टेक्स्ट को 5000 वर्णों के खंडों में बाँटा जाता है।
- Markdown फ़ॉर्मेटिंग हटा दी जाती है; जहाँ संभव हो, कोड ब्लॉक और टेबल को Flex कार्ड में बदला जाता है।
- स्ट्रीमिंग प्रतिक्रियाएँ बफ़र की जाती हैं; एजेंट के काम करते समय LINE को लोडिंग एनीमेशन के साथ पूर्ण खंड मिलते हैं।
- मीडिया डाउनलोड की सीमा
channels.line.mediaMaxMb(डिफ़ॉल्ट 10) द्वारा निर्धारित होती है। - इनबाउंड मीडिया को एजेंट को भेजने से पहले
~/.openclaw/media/inbound/के अंतर्गत सहेजा जाता है, जो अन्य चैनल Plugin द्वारा उपयोग किए जाने वाले साझा मीडिया स्टोर के अनुरूप है।
चैनल डेटा (रिच मैसेज)
क्विक रिप्लाई, लोकेशन, Flex कार्ड या टेम्पलेट मैसेज भेजने के लिएchannelData.line का उपयोग करें।
/card कमांड भी शामिल है:
ACP समर्थन
LINE, ACP (Agent Communication Protocol) वार्तालाप बाइंडिंग का समर्थन करता है:/acp spawn <agent> --bind hereचाइल्ड थ्रेड बनाए बिना वर्तमान LINE चैट को ACP सेशन से बाँधता है।- कॉन्फ़िगर की गई ACP बाइंडिंग और सक्रिय वार्तालाप-बद्ध ACP सेशन, LINE पर अन्य वार्तालाप चैनलों की तरह काम करते हैं।
आउटबाउंड मीडिया
LINE Plugin, एजेंट मैसेज टूल के माध्यम से इमेज, वीडियो और ऑडियो भेजता है:- इमेज: LINE इमेज मैसेज के रूप में भेजी जाती हैं; प्रीव्यू इमेज डिफ़ॉल्ट रूप से मीडिया URL होती है।
- वीडियो: प्रीव्यू इमेज आवश्यक है;
channelData.line.previewImageUrlको किसी इमेज URL पर सेट करें। - ऑडियो: LINE ऑडियो मैसेज के रूप में भेजा जाता है; जब तक
channelData.line.durationMsसेट न हो, अवधि डिफ़ॉल्ट रूप से 60 सेकंड होती है।
channelData.line.mediaKind से लिया जाता है, अन्यथा इसे
अन्य LINE विकल्पों या URL फ़ाइल सफ़िक्स से निर्धारित किया जाता है और इमेज को फ़ॉलबैक माना जाता है।
आउटबाउंड मीडिया URL सार्वजनिक HTTPS URL होने चाहिए और अधिकतम 2000 वर्ण लंबे हो सकते हैं। OpenClaw
URL को LINE को सौंपने से पहले लक्षित होस्टनेम को सत्यापित करता है और लूपबैक,
लिंक-लोकल तथा निजी-नेटवर्क लक्ष्यों को अस्वीकार करता है।
LINE-विशिष्ट विकल्पों के बिना सामान्य मीडिया प्रेषण इमेज रूट का उपयोग करता है।
समस्या निवारण
- Webhook सत्यापन विफल होता है: सुनिश्चित करें कि Webhook URL HTTPS है और
channelSecret, LINE console से मेल खाता है। - कोई इनबाउंड इवेंट नहीं: पुष्टि करें कि Webhook पाथ
channels.line.webhookPathसे मेल खाता है और Gateway तक LINE की पहुँच है। - मीडिया डाउनलोड त्रुटियाँ: यदि मीडिया डिफ़ॉल्ट सीमा से बड़ा है, तो
channels.line.mediaMaxMbबढ़ाएँ।
संबंधित
- चैनलों का अवलोकन — सभी समर्थित चैनल
- पेयरिंग — DM प्रमाणीकरण और पेयरिंग प्रवाह
- ग्रुप — ग्रुप चैट व्यवहार और मेंशन गेटिंग
- चैनल रूटिंग — मैसेज के लिए सेशन रूटिंग
- सुरक्षा — एक्सेस मॉडल और हार्डनिंग