एसएमएस

​

शुरू करने से पहले

• आधिकारिक SMS Plugin, जिसे openclaw plugins install @openclaw/sms से इंस्टॉल किया गया हो।
• SMS-सक्षम फ़ोन नंबर या Twilio Messaging Service वाला Twilio खाता।
• Twilio Account SID और Auth Token।
• आपके OpenClaw Gateway तक पहुँचने वाला सार्वजनिक HTTPS URL।
• प्रेषक नीति का चयन: निजी उपयोग के लिए pairing (डिफ़ॉल्ट), पहले से स्वीकृत फ़ोन नंबरों के लिए allowlist, या केवल जानबूझकर सार्वजनिक SMS एक्सेस के लिए open।

​

त्वरित सेटअप

openclaw plugins install @openclaw/sms

{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: "twilio-auth-token",
      fromNumber: "+15551234567",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
      dmPolicy: "pairing",
    },
  },
}

openclaw config patch --file ./sms.patch.json5 --dry-run
openclaw config patch --file ./sms.patch.json5

https://gateway.example.com/webhooks/sms

tailscale funnel --bg --set-path /webhooks/sms http://127.0.0.1:<gateway-port>/webhooks/sms
tailscale funnel status

openclaw gateway

openclaw pairing list sms
openclaw pairing approve sms <CODE>

​

कॉन्फ़िगरेशन के उदाहरण

​

कॉन्फ़िगरेशन फ़ाइल

{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: "twilio-auth-token",
      fromNumber: "+15551234567",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
      dmPolicy: "pairing",
    },
  },
}

​

एनवायरनमेंट वेरिएबल

export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TWILIO_AUTH_TOKEN="<twilio-auth-token>"
export TWILIO_PHONE_NUMBER="+15551234567"
export SMS_PUBLIC_WEBHOOK_URL="https://gateway.example.com/webhooks/sms"

{
  channels: {
    sms: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}

​

SecretRef Auth Token

{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: { source: "env", provider: "default", id: "TWILIO_AUTH_TOKEN" },
      fromNumber: "+15551234567",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
      dmPolicy: "pairing",
    },
  },
}

​

Messaging Service प्रेषक

{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: "twilio-auth-token",
      messagingServiceSid: "MGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
      dmPolicy: "pairing",
    },
  },
}

​

डिफ़ॉल्ट आउटबाउंड लक्ष्य

{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: "twilio-auth-token",
      fromNumber: "+15551234567",
      defaultTo: "+15557654321",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
    },
  },
}

​

एक्सेस नियंत्रण

• pairing (डिफ़ॉल्ट): अज्ञात प्रेषकों को पेयरिंग कोड मिलता है; openclaw pairing approve sms <CODE> से स्वीकृति दें।
• allowlist: केवल allowFrom में मौजूद प्रेषकों को प्रोसेस किया जाता है। खाली allowFrom प्रत्येक प्रेषक को अस्वीकार करता है (Gateway स्टार्टअप चेतावनी लॉग करता है)।
• open: कॉन्फ़िगरेशन सत्यापन के लिए allowFrom में "*" शामिल होना आवश्यक है। वाइल्डकार्ड के बिना केवल सूचीबद्ध नंबर चैट कर सकते हैं।
• disabled: सभी इनबाउंड DM हटा दिए जाते हैं।

{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: "twilio-auth-token",
      fromNumber: "+15551234567",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
      dmPolicy: "allowlist",
      allowFrom: ["+15557654321"],
    },
  },
}

​

SMS भेजना

openclaw message send --channel sms --target sms:+15551234567 --message "hello"

openclaw message send --target twilio-sms:+15551234567 --message "hello"

​

सेटअप सत्यापित करें

1. पुष्टि करें कि Gateway लॉग में SMS Webhook रूट दिख रहा है।
2. Twilio की ओर से एक जाँच चलाएँ (यह कॉन्फ़िगर किए गए Twilio Webhook URL/विधि और हाल की इनबाउंड त्रुटियों की जाँच करती है):

openclaw channels capabilities --channel sms
openclaw channels status --channel sms --probe --json

3. अपने फ़ोन से Twilio नंबर पर एक SMS भेजें।
4. openclaw pairing list sms चलाएँ।
5. openclaw pairing approve sms <CODE> के साथ पेयरिंग कोड को स्वीकृत करें।
6. एक और SMS भेजें और पुष्टि करें कि एजेंट उत्तर देता है।

openclaw message send --channel sms --target sms:+15557654321 --message "OpenClaw SMS test"

​

macOS iMessage/SMS से शुरू से अंत तक परीक्षण

imsg send --to "+15551234567" --service sms --text "OpenClaw SMS E2E $(date -u +%Y%m%dT%H%M%SZ)" --json
openclaw pairing list sms
openclaw pairing approve sms <CODE>
imsg send --to "+15551234567" --service sms --text "reply exactly SMS pong" --json

​

Webhook सुरक्षा

• केवल POST।
• प्रति SMS अकाउंट, Webhook रूट और निर्धारित क्लाइंट पते पर प्रति मिनट 300 अनुरोधों का विफल-अनुरोध बजट। सभी अनुरोध इस बजट में गिने जाते हैं, लेकिन HTTP 429 केवल तब लागू होता है जब कोई अनुरोध बॉडी पार्सिंग, Twilio सत्यापन या AccountSid मिलान में विफल हो जाता है।
• इन जाँचों के सफल होने के बाद प्रति SMS अकाउंट, Webhook रूट और निर्धारित क्लाइंट पते पर प्रति मिनट 30 स्वीकृत कॉलबैक की प्रेषण-योग्य दर सीमा (इससे अधिक पर HTTP 429)। यदि हस्ताक्षर सत्यापन अक्षम है, तो यह 30/मिनट सीमा अप्रमाणित प्रेषण की अधिकतम सीमा है।
• क्लाइंट पतों को साझा Gateway विश्वसनीय-प्रॉक्सी नियमों के माध्यम से निर्धारित किया जाता है। यदि gateway.trustedProxies में वह रिवर्स प्रॉक्सी शामिल है जो Twilio कॉलबैक अग्रेषित करता है, तो OpenClaw इन सीमाओं के लिए अग्रेषित क्लाइंट पते का उपयोग करता है; अन्यथा यह सीधे सॉकेट पते का उपयोग करता है।
• पेलोड का AccountSid, कॉन्फ़िगर किए गए accountSid से मेल खाना चाहिए (अन्यथा HTTP 403)।
• दोबारा चलाए गए MessageSid मानों को 10 मिनट के लिए डीडुप्लिकेट किया जाता है।
• प्रत्येक SMS अकाउंट का रीप्ले कैश अधिकतम 10,000 सक्रिय संदेश SID रखता है। जब प्रत्येक स्लॉट सक्रिय हो, तब उस अकाउंट के नए Webhook HTTP 429 और Retry-After हेडर के साथ विफलता-सुरक्षित ढंग से अस्वीकार कर दिए जाते हैं, जब तक सबसे पुराना स्लॉट समाप्त नहीं हो जाता।
• 32 KB से बड़ी अनुरोध बॉडी अस्वीकार कर दी जाती हैं।

{
  channels: {
    sms: {
      dangerouslyDisableSignatureValidation: true,
    },
  },
}

​

मल्टी-अकाउंट कॉन्फ़िगरेशन

{
  channels: {
    sms: {
      accounts: {
        support: {
          enabled: true,
          accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          authToken: "twilio-auth-token",
          fromNumber: "+15551234567",
          publicWebhookUrl: "https://gateway.example.com/webhooks/sms/support",
          webhookPath: "/webhooks/sms/support",
          dmPolicy: "allowlist",
          allowFrom: ["+15557654321"],
        },
      },
    },
  },
}

​

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

​

Twilio 403 लौटाता है या OpenClaw Webhook को अस्वीकार करता है

​

कोई पेयरिंग अनुरोध दिखाई नहीं देता

• Twilio में Messaging > A message comes in, publicWebhookUrl की ओर इंगित करता है।
• विधि POST है।
• टनल या रिवर्स प्रॉक्सी ठीक उसी webhookPath को एक्सपोज़ करता है; Tailscale Funnel के लिए, tailscale funnel status चलाएँ और पुष्टि करें कि /webhooks/sms सूचीबद्ध है।
• publicWebhookUrl उसी स्कीम, होस्ट, पाथ और क्वेरी स्ट्रिंग का उपयोग करता है जिसे Twilio भेजता है, ताकि हस्ताक्षर सत्यापन हस्ताक्षरित URL को पुनः बना सके।

​

आउटबाउंड प्रेषण विफल होते हैं

​

संदेश पहुँचते हैं लेकिन एजेंट उत्तर नहीं देता