Signal

​

नंबर मॉडल (इसे पहले पढ़ें)

• Gateway एक Signal डिवाइस से कनेक्ट होता है: signal-cli खाता।
• बॉट को आपके व्यक्तिगत Signal खाते पर चलाने से वह आपके अपने संदेशों को अनदेखा करता है (लूप सुरक्षा)।
• “मैं बॉट को संदेश भेजूँ और वह उत्तर दे,” इसके लिए एक अलग बॉट नंबर का उपयोग करें।

​

इंस्टॉल करें

openclaw plugins install @openclaw/signal

​

त्वरित सेटअप

openclaw plugins install @openclaw/signal

openclaw channels add

openclaw gateway call channels.status --params '{"probe":true}'

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      transport: {
        kind: "managed-native",
        cliPath: "signal-cli",
      },
      dmPolicy: "pairing",
      allowFrom: ["+15557654321"],
    },
  },
}

​

यह क्या है

• नियतात्मक रूटिंग: उत्तर हमेशा Signal पर वापस जाते हैं।
• DM, एजेंट का मुख्य सत्र साझा करते हैं; समूह पृथक रहते हैं (agent:<agentId>:signal:group:<groupId>)।
• डिफ़ॉल्ट रूप से, Signal /config set|unset द्वारा आरंभ किए गए कॉन्फ़िगरेशन अपडेट लिख सकता है (commands.config: true आवश्यक)। channels.signal.configWrites: false से इसे अक्षम करें।

​

सेटअप पथ A: मौजूदा Signal खाता लिंक करें (QR)

1. signal-cli (JVM या नेटिव बिल्ड) इंस्टॉल करें या openclaw channels add को आपके लिए इसे इंस्टॉल करने दें।
2. बॉट खाता लिंक करें: signal-cli link -n "OpenClaw", फिर Signal में QR स्कैन करें।
3. Signal कॉन्फ़िगर करें और Gateway शुरू करें।

​

सेटअप पथ B: समर्पित बॉट नंबर पंजीकृत करें (SMS, Linux)

1. ऐसा नंबर प्राप्त करें जो SMS प्राप्त कर सके (या लैंडलाइन के लिए वॉइस सत्यापन)। समर्पित बॉट नंबर खाता/सत्र टकराव से बचाता है।
2. Gateway होस्ट पर signal-cli इंस्टॉल करें:

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/AsamK/signal-cli/releases/latest | sed -e 's/^.*\/v//')
curl -L -O "https://github.com/AsamK/signal-cli/releases/download/v${VERSION}/signal-cli-${VERSION}-Linux-native.tar.gz"
sudo tar xf "signal-cli-${VERSION}-Linux-native.tar.gz" -C /opt
sudo ln -sf /opt/signal-cli /usr/local/bin/
signal-cli --version

3. नंबर पंजीकृत और सत्यापित करें:

signal-cli -a +<BOT_PHONE_NUMBER> register

1. https://signalcaptchas.org/registration/generate.html खोलें।
2. कैप्चा पूरा करें, “Open Signal” से signalcaptcha://... लिंक लक्ष्य कॉपी करें।
3. जहाँ संभव हो, ब्राउज़र सत्र के समान बाहरी IP से चलाएँ (कैप्चा टोकन शीघ्र समाप्त हो जाते हैं)।
4. तुरंत पंजीकृत और सत्यापित करें:

signal-cli -a +<BOT_PHONE_NUMBER> register --captcha '<SIGNALCAPTCHA_URL>'
signal-cli -a +<BOT_PHONE_NUMBER> verify <VERIFICATION_CODE>

4. OpenClaw कॉन्फ़िगर करें, Gateway पुनः आरंभ करें और चैनल सत्यापित करें:

# यदि आप Gateway को उपयोगकर्ता systemd सेवा के रूप में चलाते हैं:
systemctl --user restart openclaw-gateway.service

# फिर सत्यापित करें:
openclaw doctor
openclaw channels status --probe

5. अपने DM प्रेषक को पेयर करें:
   • बॉट नंबर पर कोई भी संदेश भेजें।
   • सर्वर पर स्वीकृत करें: openclaw pairing approve signal <PAIRING_CODE>।
   • “Unknown contact” से बचने के लिए बॉट नंबर को अपने फ़ोन में संपर्क के रूप में सहेजें।

• signal-cli README: https://github.com/AsamK/signal-cli
• कैप्चा प्रवाह: https://github.com/AsamK/signal-cli/wiki/Registration-with-captcha
• लिंकिंग प्रवाह: https://github.com/AsamK/signal-cli/wiki/Linking-other-devices-(Provisioning)

​

बाहरी नेटिव डेमन मोड

openclaw channels add --channel signal --signal-number +15551234567 \
  --http-url http://127.0.0.1:8080 --signal-transport external-native

{
  channels: {
    signal: {
      transport: {
        kind: "external-native",
        url: "http://127.0.0.1:8080",
      },
    },
  },
}

​

कंटेनर मोड (bbernhard/signal-cli-rest-api)

openclaw channels add --channel signal --signal-number +15551234567 \
  --http-url http://signal-cli:8080 --signal-transport container

• रीयल-टाइम संदेश प्राप्त करने के लिए कंटेनर को MODE=json-rpc के साथ चलना अनिवार्य है।
• OpenClaw कनेक्ट करने से पहले कंटेनर के भीतर अपना Signal खाता पंजीकृत या लिंक करें।

signal-cli:
  image: bbernhard/signal-cli-rest-api:latest
  environment:
    MODE: json-rpc
  ports:
    - "8080:8080"
  volumes:
    - signal-cli-data:/home/.local/share/signal-cli

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      transport: {
        kind: "container",
        url: "http://signal-cli:8080",
      },
    },
  },
}

• प्राप्त करने के लिए MODE=json-rpc का उपयोग करें। MODE=normal, /v1/about को स्वस्थ दिखा सकता है, लेकिन /v1/receive/{account} WebSocket अपग्रेड नहीं करेगा, इसलिए कंटेनर प्राप्ति स्ट्रीमिंग की जाँच विफल होगी।
• bbernhard REST API के लिए kind: "container" और नेटिव signal-cli JSON-RPC/SSE के लिए kind: "external-native" सेट करें।
• कंटेनर अटैचमेंट डाउनलोड, नेटिव मोड जैसी ही मीडिया बाइट सीमाओं का पालन करते हैं। जब सर्वर Content-Length भेजता है, तब अत्यधिक बड़े प्रत्युत्तर पूरी तरह बफ़र होने से पहले अस्वीकार कर दिए जाते हैं; अन्यथा स्ट्रीमिंग के दौरान अस्वीकार किए जाते हैं।

​

पहुँच नियंत्रण (DM + समूह)

• डिफ़ॉल्ट: channels.signal.dmPolicy = "pairing"।
• अज्ञात प्रेषकों को पेयरिंग कोड मिलता है; स्वीकृति मिलने तक संदेश अनदेखे किए जाते हैं (कोड 1 घंटे बाद समाप्त हो जाते हैं)।
• openclaw pairing list signal और openclaw pairing approve signal <CODE> के माध्यम से स्वीकृत करें।
• Signal DM के लिए पेयरिंग डिफ़ॉल्ट टोकन विनिमय है। विवरण: पेयरिंग
• केवल UUID वाले प्रेषक (sourceUuid से) channels.signal.allowFrom में uuid:<id> के रूप में संग्रहीत किए जाते हैं।

• channels.signal.groupPolicy = open | allowlist | disabled। जब allowlist सेट हो, तब
• channels.signal.groupAllowFrom नियंत्रित करता है कि कौन-से समूह या प्रेषक समूह उत्तरों को ट्रिगर कर सकते हैं; प्रविष्टियाँ Signal समूह ID (रॉ, group:<id>, या signal:group:<id>), प्रेषक के फ़ोन नंबर, uuid:<id> मान, या * हो सकती हैं।
• channels.signal.groups["<group-id>" | "*"], requireMention, tools, और toolsBySender के साथ समूह व्यवहार को ओवरराइड कर सकता है।
• बहु-अकाउंट सेटअप में प्रत्येक अकाउंट के ओवरराइड के लिए channels.signal.accounts.<id>.groups का उपयोग करें।
• groupAllowFrom के माध्यम से किसी Signal समूह को अनुमति-सूची में जोड़ना अपने आप उल्लेख गेटिंग को अक्षम नहीं करता। विशेष रूप से कॉन्फ़िगर की गई channels.signal.groups["<group-id>"] प्रविष्टि प्रत्येक समूह संदेश को संसाधित करती है, जब तक कि requireMention=true सेट न हो।
• requireMention=true के साथ, Signal के मूल @उल्लेख संरचित उल्लेख मेटाडेटा से बॉट अकाउंट के फ़ोन या accountUuid से मिलाए जाते हैं। कॉन्फ़िगर किए गए mentionPatterns सादे-पाठ फ़ॉलबैक बने रहते हैं।
• रनटाइम नोट: यदि channels.signal पूरी तरह अनुपस्थित है, तो रनटाइम समूह जाँच के लिए groupPolicy="allowlist" पर फ़ॉलबैक करता है (भले ही channels.defaults.groupPolicy सेट हो)।

{
  channels: {
    signal: {
      account: "+15551234567",
      accountUuid: "bot-signal-uuid",
      groupPolicy: "allowlist",
      groupAllowFrom: ["group:<signal-group-id>"],
      historyLimit: 8,
      groups: {
        "<signal-group-id>": { requireMention: true },
      },
    },
  },
  messages: {
    groupChat: {
      mentionPatterns: ["\\bopenclaw\\b"],
    },
  },
}

​

यह कैसे काम करता है (व्यवहार)

• मूल मोड: signal-cli डेमन के रूप में चलता है; Gateway SSE के माध्यम से इवेंट पढ़ता है।
• कंटेनर मोड: Gateway REST API के माध्यम से भेजता है और WebSocket के माध्यम से प्राप्त करता है।
• आने वाले संदेशों को साझा चैनल एनवेलप में सामान्यीकृत किया जाता है।
• उत्तर हमेशा उसी नंबर या समूह पर वापस भेजे जाते हैं।
• जब बैकएंड आने वाले संदेश का टाइमस्टैम्प और लेखक स्वीकार करता है, तब उसके उत्तरों में मूल Signal उद्धरण मेटाडेटा शामिल होता है; यदि उद्धरण मेटाडेटा अनुपस्थित हो या अस्वीकार कर दिया जाए, तो OpenClaw उत्तर को सामान्य संदेश के रूप में भेजता है।
• मूल उद्धरण के उपयोग को channels.signal.replyToMode = off | first | all | batched से, या प्रत्येक चैट प्रकार के ओवरराइड के लिए channels.signal.replyToModeByChatType.direct/group से कॉन्फ़िगर करें। channels.signal.accounts.<id> के अंतर्गत अकाउंट-स्तरीय मानों को प्राथमिकता मिलती है।

​

मीडिया + सीमाएँ

• आउटबाउंड पाठ को channels.signal.textChunkLimit के अनुसार खंडों में बाँटा जाता है (डिफ़ॉल्ट 4000)।
• वैकल्पिक नई-पंक्ति खंडीकरण: लंबाई के अनुसार खंडीकरण से पहले रिक्त पंक्तियों (अनुच्छेद सीमाओं) पर विभाजित करने के लिए channels.signal.streaming.chunkMode="newline" सेट करें।
• अटैचमेंट समर्थित हैं (signal-cli से प्राप्त base64)।
• जब contentType अनुपस्थित हो, तो वॉइस-नोट अटैचमेंट MIME फ़ॉलबैक के रूप में signal-cli फ़ाइल नाम का उपयोग करते हैं, ताकि ऑडियो ट्रांसक्रिप्शन फिर भी AAC वॉइस मेमो को वर्गीकृत कर सके।
• डिफ़ॉल्ट मीडिया सीमा: channels.signal.mediaMaxMb (डिफ़ॉल्ट 8)।
• किसी भी ट्रांसपोर्ट के लिए मीडिया डाउनलोड छोड़ने हेतु channels.signal.ignoreAttachments का उपयोग करें।
• समूह इतिहास संदर्भ channels.signal.historyLimit (या channels.signal.accounts.*.historyLimit) का उपयोग करता है और messages.groupChat.historyLimit पर फ़ॉलबैक करता है। अक्षम करने के लिए 0 सेट करें (डिफ़ॉल्ट 50)।

​

टाइपिंग + पठन रसीदें

• टाइपिंग संकेतक: OpenClaw signal-cli sendTyping के माध्यम से टाइपिंग संकेत भेजता है और उत्तर तैयार होते समय उन्हें रीफ़्रेश करता है।
• पठन रसीदें: जब channels.signal.sendReadReceipts सत्य हो, तब OpenClaw अनुमत DM के लिए पठन रसीदें अग्रेषित करता है।
• signal-cli समूहों के लिए पठन रसीदें उपलब्ध नहीं कराता।

​

जीवनचक्र स्थिति प्रतिक्रियाएँ

​

प्रतिक्रियाएँ (संदेश टूल)

• लक्ष्य: प्रेषक E.164 या UUID (पेयरिंग आउटपुट से uuid:<id> का उपयोग करें; केवल UUID भी काम करता है)।
• messageId उस संदेश का Signal टाइमस्टैम्प है जिस पर आप प्रतिक्रिया दे रहे हैं।
• समूह प्रतिक्रियाओं के लिए targetAuthor या targetAuthorUuid आवश्यक है।

message action=react channel=signal target=uuid:123e4567-e89b-12d3-a456-426614174000 messageId=1737630212345 emoji=🔥
message action=react channel=signal target=+15551234567 messageId=1737630212345 emoji=🔥 remove=true
message action=react channel=signal target=signal:group:<groupId> targetAuthor=uuid:<sender-uuid> messageId=1737630212345 emoji=✅

• channels.signal.actions.reactions: प्रतिक्रिया क्रियाएँ सक्षम/अक्षम करें (डिफ़ॉल्ट सत्य)।
• channels.signal.reactionLevel: off | ack | minimal | extensive (डिफ़ॉल्ट minimal)।
  • off/ack एजेंट प्रतिक्रियाएँ अक्षम करता है (संदेश टूल react त्रुटि देता है)।
  • minimal/extensive एजेंट प्रतिक्रियाएँ सक्षम करता है और मार्गदर्शन स्तर सेट करता है।
• प्रत्येक अकाउंट के ओवरराइड: channels.signal.accounts.<id>.actions.reactions, channels.signal.accounts.<id>.reactionLevel।

​

अनुमोदन प्रतिक्रियाएँ

• 👍 एक बार के लिए अनुमोदित करता है।
• 👎 अस्वीकार करता है।
• जब कोई अनुरोध स्थायी अनुमोदन प्रस्तुत करता है, तब /approve <id> allow-always का उपयोग करें।

​

प्रश्न प्रतिक्रियाएँ

​

वितरण लक्ष्य (CLI/Cron)

• DM: signal:+15551234567 (या केवल E.164)।
• UUID DM: uuid:<id> (या केवल UUID)।
• समूह: signal:group:<groupId>।
• उपयोगकर्ता नाम: username:<name> (यदि आपके Signal अकाउंट द्वारा समर्थित हो)।

​

उपनाम

{
  channels: {
    signal: {
      aliases: {
        me: "+15557654321",
        jane: "uuid:123e4567-e89b-12d3-a456-426614174000",
        ops: "group:<groupId>",
      },
      defaultTo: "signal:me",
    },
  },
}

openclaw message send --channel signal --target signal:ops --message "Deployment is complete"

{
  channels: {
    signal: {
      aliases: {
        me: "+15557654321",
      },
      accounts: {
        work: {
          aliases: {
            ops: "group:<workGroupId>",
          },
        },
      },
    },
  },
}

​

समस्या निवारण

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

openclaw pairing list signal

• डेमन पहुँच योग्य है लेकिन उत्तर नहीं मिल रहे: account, transport.kind, ट्रांसपोर्ट URL, और प्राप्ति मोड सत्यापित करें।
• DM अनदेखे किए गए: प्रेषक का पेयरिंग अनुमोदन लंबित है।
• समूह संदेश अनदेखे किए गए: समूह प्रेषक/उल्लेख गेटिंग वितरण को अवरुद्ध करती है।
• संपादन के बाद कॉन्फ़िगरेशन सत्यापन त्रुटियाँ: openclaw doctor --fix चलाएँ।
• निदान में Signal अनुपस्थित है: channels.signal.enabled: true की पुष्टि करें।

openclaw pairing list signal
pgrep -af signal-cli
openclaw logs --plain --limit 500 | grep -i "signal" | tail -20

​

सुरक्षा नोट्स

• signal-cli अकाउंट कुंजियाँ स्थानीय रूप से संग्रहीत करता है (आमतौर पर ~/.local/share/signal-cli/data/)।
• सर्वर माइग्रेशन या पुनर्निर्माण से पहले Signal अकाउंट स्थिति का बैकअप लें।
• channels.signal.dmPolicy: "pairing" बनाए रखें, जब तक आप स्पष्ट रूप से अधिक व्यापक DM पहुँच नहीं चाहते।
• SMS सत्यापन केवल पंजीकरण या पुनर्प्राप्ति प्रवाहों के लिए आवश्यक है, लेकिन नंबर/अकाउंट का नियंत्रण खोने से पुनः पंजीकरण जटिल हो सकता है।

​

कॉन्फ़िगरेशन संदर्भ (Signal)

• channels.signal.enabled: चैनल स्टार्टअप सक्षम/अक्षम करें।
• channels.signal.account: बॉट खाते के लिए E.164।
• channels.signal.accountUuid: मूल @mention पहचान और लूप सुरक्षा के लिए वैकल्पिक बॉट खाता UUID।
• channels.signal.transport: खाते के स्वामित्व वाला ट्रांसपोर्ट। प्रबंधित मूल डिफ़ॉल्ट के लिए इसे छोड़ दें।
• channels.signal.transport.kind: managed-native | external-native | container।
• channels.signal.transport.url: external-native और container के लिए आवश्यक; managed-native के लिए वैकल्पिक, जब उसका कनेक्शन एंडपॉइंट डेमन बाइंड से अलग हो।
• channels.signal.transport.cliPath: signal-cli का प्रबंधित-मूल पथ।
• channels.signal.transport.configPath: वैकल्पिक प्रबंधित-मूल signal-cli --config डायरेक्टरी।
• channels.signal.transport.httpHost, channels.signal.transport.httpPort: प्रबंधित-मूल डेमन बाइंड (डिफ़ॉल्ट 127.0.0.1:8080)।
• channels.signal.transport.startupTimeoutMs: प्रबंधित-मूल स्टार्टअप प्रतीक्षा, ms में (न्यूनतम 1000, अधिकतम 120000; डिफ़ॉल्ट 30000)।
• channels.signal.transport.receiveMode: प्रबंधित-मूल on-start | manual।
• channels.signal.ignoreAttachments: इस खाते के लिए आने वाले अटैचमेंट का डाउनलोड छोड़ें।
• channels.signal.transport.ignoreStories: प्रबंधित-मूल स्टोरी टॉगल।
• channels.signal.sendReadReceipts: पठन रसीदें अग्रेषित करें।
• channels.signal.dmPolicy: pairing | allowlist | open | disabled (डिफ़ॉल्ट: पेयरिंग)।
• channels.signal.allowFrom: DM अनुमति-सूची (E.164 या uuid:<id>)। open के लिए "*" आवश्यक है। Signal में उपयोगकर्ता नाम नहीं होते; फ़ोन/UUID ID का उपयोग करें।
• channels.signal.aliases: DM या समूह डिलीवरी लक्ष्यों के लिए OpenClaw-पक्ष के उपनाम।
• channels.signal.groupPolicy: open | allowlist | disabled (डिफ़ॉल्ट: अनुमति-सूची)।
• channels.signal.groupAllowFrom: समूह अनुमति-सूची; Signal समूह ID (अपरिष्कृत, group:<id>, या signal:group:<id>), प्रेषक के E.164 नंबर, या uuid:<id> मान स्वीकार करती है।
• channels.signal.groups: Signal समूह ID (या "*") द्वारा कुंजीबद्ध प्रति-समूह ओवरराइड। समर्थित फ़ील्ड: requireMention, tools, toolsBySender।
• channels.signal.accounts.<id>.groups: एकाधिक-खाता सेटअप के लिए channels.signal.groups का प्रति-खाता संस्करण।
• channels.signal.accounts.<id>.aliases: प्रति-खाता उपनाम, शीर्ष-स्तरीय उपनामों के साथ मर्ज किए जाते हैं।
• channels.signal.replyToMode: मूल उत्तर उद्धरण मोड, off | first | all | batched (डिफ़ॉल्ट: all)।
• channels.signal.replyToModeByChatType.direct, channels.signal.replyToModeByChatType.group: प्रति-चैट-प्रकार मूल उत्तर उद्धरण ओवरराइड।
• channels.signal.accounts.<id>.replyToMode, channels.signal.accounts.<id>.replyToModeByChatType.direct, channels.signal.accounts.<id>.replyToModeByChatType.group: प्रति-खाता उत्तर उद्धरण ओवरराइड।
• channels.signal.historyLimit: संदर्भ के रूप में शामिल किए जाने वाले समूह संदेशों की अधिकतम संख्या (0 अक्षम करता है)।
• channels.signal.dmHistoryLimit: उपयोगकर्ता टर्न में DM इतिहास सीमा। प्रति-उपयोगकर्ता ओवरराइड: channels.signal.dms["<phone_or_uuid>"].historyLimit।
• channels.signal.textChunkLimit: वर्णों में आउटबाउंड खंड आकार (डिफ़ॉल्ट 4000)।
• channels.signal.streaming.chunkMode: लंबाई के आधार पर खंडित करने से पहले रिक्त पंक्तियों (अनुच्छेद सीमाओं) पर विभाजित करने के लिए length (डिफ़ॉल्ट) या newline।
• channels.signal.mediaMaxMb: इनबाउंड/आउटबाउंड मीडिया सीमा, MB में (डिफ़ॉल्ट 8)।
• channels.signal.reactionLevel: off | ack | minimal | extensive (डिफ़ॉल्ट minimal)। प्रतिक्रियाएँ देखें।
• channels.signal.reactionNotifications: off | own | all | allowlist (डिफ़ॉल्ट own) - एजेंट को अन्य लोगों से आने वाली प्रतिक्रियाओं की सूचना कब दी जाती है।
• channels.signal.reactionAllowlist: वे प्रेषक जिनकी प्रतिक्रियाएँ reactionNotifications: "allowlist" होने पर एजेंट को सूचित करती हैं।
• channels.signal.streaming.block.enabled, channels.signal.streaming.block.coalesce: सभी चैनलों में साझा किए गए ब्लॉक-मोड स्ट्रीमिंग नियंत्रण। स्ट्रीमिंग देखें।

• agents.entries.*.groupChat.mentionPatterns (सादा-पाठ फ़ॉलबैक; बॉट खाते की पहचान कॉन्फ़िगर होने पर Signal के मूल @mentions की पहचान संरचित मेटाडेटा से की जाती है)।
• messages.groupChat.mentionPatterns (वैश्विक फ़ॉलबैक)।
• channels.signal.responsePrefix या खाता-स्तरीय responsePrefix।

​

संबंधित

• चैनल अवलोकन - सभी समर्थित चैनल
• पेयरिंग - DM प्रमाणीकरण और पेयरिंग प्रवाह
• समूह - समूह चैट व्यवहार और उल्लेख गेटिंग
• चैनल रूटिंग - संदेशों के लिए सत्र रूटिंग
• सुरक्षा - पहुँच मॉडल और सुदृढ़ीकरण