SMS

​

Başlamadan önce

• openclaw plugins install @openclaw/sms ile kurulmuş resmî SMS Plugin’i.
• SMS özellikli bir telefon numarasına veya Twilio Messaging Service’e sahip bir Twilio hesabı.
• Twilio Account SID ve Auth Token.
• OpenClaw Gateway’inize ulaşan herkese açık bir HTTPS URL’si.
• Bir gönderen ilkesi seçimi: özel kullanım için pairing (varsayılan), önceden onaylanmış telefon numaraları için allowlist veya yalnızca bilerek herkese açık SMS erişimi sağlamak için open.

​

Hızlı Kurulum

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>

​

Yapılandırma Örnekleri

​

Yapılandırma dosyası

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

​

Ortam değişkenleri

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 kimlik doğrulama belirteci

{
  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 göndereni

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

​

Varsayılan giden hedef

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

​

Erişim denetimi

• pairing (varsayılan): bilinmeyen gönderenler bir eşleştirme kodu alır; openclaw pairing approve sms <CODE> ile onaylayın.
• allowlist: yalnızca allowFrom içindeki gönderenler işlenir. Boş bir allowFrom her göndereni reddeder (Gateway bir başlangıç uyarısı günlüğe kaydeder).
• open: yapılandırma doğrulaması, allowFrom değerinin "*" içermesini gerektirir. Joker karakter olmadan yalnızca listelenen numaralar sohbet edebilir.
• disabled: gelen tüm DM’ler bırakılır.

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

​

SMS gönderme

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

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

​

Kurulumu Doğrulama

1. Gateway günlüğünde SMS Webhook yolunun gösterildiğini doğrulayın.
2. Twilio tarafında bir yoklama çalıştırın (yapılandırılmış Twilio Webhook URL’sini/yöntemini ve son gelen ileti hatalarını denetler):

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

3. Telefonunuzdan Twilio numarasına bir SMS gönderin.
4. openclaw pairing list sms komutunu çalıştırın.
5. Eşleştirme kodunu openclaw pairing approve sms <CODE> ile onaylayın.
6. Başka bir SMS gönderin ve aracının yanıt verdiğini doğrulayın.

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

​

macOS iMessage/SMS üzerinden uçtan uca test

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 güvenliği

• Yalnızca POST.
• SMS hesabı, Webhook yolu ve çözümlenmiş istemci adresi başına dakikada 300 istekten oluşan başarısız istek bütçesi. Tüm istekler bu bütçeye dâhildir ancak HTTP 429 yalnızca bir istek gövde ayrıştırma, Twilio doğrulaması veya AccountSid eşleştirmesinde başarısız olduktan sonra uygulanır.
• Bu denetimler geçildikten sonra SMS hesabı, Webhook yolu ve çözümlenmiş istemci adresi başına dakikada 30 kabul edilmiş geri çağırmadan oluşan işlenebilir geri çağırma hız sınırı (bunun üzerinde HTTP 429). İmza doğrulaması devre dışıysa bu 30/dakika sınırı, kimliği doğrulanmamış işleme üst sınırıdır.
• İstemci adresleri, paylaşılan Gateway güvenilir proxy kuralları üzerinden çözümlenir. gateway.trustedProxies, Twilio geri çağırmalarını ileten ters proxy’yi içeriyorsa OpenClaw bu sınırları iletilen istemci adresine göre belirler; aksi takdirde doğrudan soket adresine geri döner.
• Yükteki AccountSid, yapılandırılmış accountSid ile eşleşmelidir (aksi takdirde HTTP 403).
• Yeniden oynatılan MessageSid değerlerinin yinelenenleri 10 dakika boyunca ayıklanır.
• Her SMS hesabının yeniden oynatma önbelleği en fazla 10.000 etkin ileti SID’sini saklar. Tüm yuvalar etkin olduğunda, o hesaba yönelik yeni Webhook’lar en eski yuvanın süresi dolana kadar HTTP 429 ve bir Retry-After üst bilgisiyle kapalı biçimde başarısız olur.
• 32 KB üzerindeki istek gövdeleri reddedilir.

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

​

Çok hesaplı yapılandırma

{
  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"],
        },
      },
    },
  },
}

​

Sorun Giderme

​

Twilio 403 döndürüyor veya OpenClaw Webhook’u reddediyor

​

Eşleştirme isteği görünmüyor

• Twilio Messaging > A message comes in, publicWebhookUrl adresine yöneliyor.
• Yöntem POST.
• Tünel veya ters proxy tam webhookPath yolunu kullanıma açıyor; Tailscale Funnel için tailscale funnel status çalıştırın ve /webhooks/sms değerinin listelendiğini doğrulayın.
• publicWebhookUrl, Twilio’nun gönderdiği şema, ana bilgisayar, yol ve sorgu dizesinin aynısını kullanıyor; böylece imza doğrulaması imzalanmış URL’yi yeniden oluşturabiliyor.

​

Giden iletiler gönderilemiyor

​

İletiler geliyor ancak aracı yanıt vermiyor