SMS

OpenClaw สามารถรับและส่ง SMS ผ่านหมายเลขโทรศัพท์ Twilio หรือ Messaging Service ได้ Gateway จะลงทะเบียนเส้นทาง Webhook ขาเข้า ตรวจสอบลายเซ็นคำขอของ Twilio ตามค่าเริ่มต้น และส่งการตอบกลับผ่าน Messages API ของ Twilio

ก่อนเริ่มต้น

คุณต้องมี:

• Plugin SMS อย่างเป็นทางการที่ติดตั้งด้วย openclaw plugins install @openclaw/sms
• บัญชี Twilio พร้อมหมายเลขโทรศัพท์ที่รองรับ SMS หรือ Twilio Messaging Service
• Twilio Account SID และ Auth Token
• URL HTTPS สาธารณะที่เข้าถึง OpenClaw Gateway ของคุณ
• ตัวเลือกนโยบายผู้ส่ง: pairing สำหรับการใช้งานส่วนตัว, allowlist สำหรับหมายเลขโทรศัพท์ที่อนุมัติไว้ล่วงหน้า หรือ open เฉพาะสำหรับการเข้าถึง SMS สาธารณะโดยเจตนา

ใช้หมายเลข Twilio เดียวกันสำหรับทั้ง SMS และ Voice Call หากหมายเลขนั้นมีความสามารถทั้งสองอย่าง กำหนดค่า SMS webhook และ Voice webhook แยกกันใน Twilio; หน้านี้ครอบคลุมเฉพาะ SMS webhook เท่านั้น

การตั้งค่าอย่างรวดเร็ว

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-runopenclaw 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/smstailscale funnel status

openclaw gateway

openclaw pairing list smsopenclaw pairing approve sms <CODE>

ตัวอย่างการกำหนดค่า

ไฟล์กำหนดค่า

ใช้การตั้งค่าด้วยไฟล์กำหนดค่าเมื่อคุณต้องการให้คำนิยามช่องทางไปพร้อมกับการกำหนดค่า Gateway:

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

ตัวแปรสภาพแวดล้อม

ใช้การตั้งค่าด้วย env สำหรับการปรับใช้บัญชีเดียวที่ secret มาจากสภาพแวดล้อมของโฮสต์:

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"

จากนั้นเปิดใช้ช่องทางใน config:

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

TWILIO_SMS_FROM ได้รับการยอมรับเป็น alias สำหรับ TWILIO_PHONE_NUMBER ใช้ TWILIO_MESSAGING_SERVICE_SID แทนผู้ส่งแบบหมายเลขโทรศัพท์เมื่อ Twilio ควรเลือกผู้ส่งจาก Messaging Service

โทเค็น auth แบบ SecretRef

authToken สามารถเป็น SecretRef ได้ ใช้สิ่งนี้เมื่อ Gateway ควรแก้ค่า Twilio Auth Token จาก runtime secret ของ OpenClaw แทนการเก็บ config แบบข้อความธรรมดา:

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

ตัวแปรสภาพแวดล้อมหรือผู้ให้บริการ secret ที่อ้างถึงต้องมองเห็นได้สำหรับ runtime ของ Gateway รีสตาร์ตกระบวนการ Gateway ที่มีการจัดการหลังจากเปลี่ยนตัวแปรสภาพแวดล้อมของโฮสต์

หมายเลขส่วนตัวแบบ allowlist เท่านั้น

ใช้ allowlist เมื่อควรให้เฉพาะหมายเลขโทรศัพท์ที่รู้จักเท่านั้นที่คุยกับ agent ได้:

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

ผู้ส่ง Messaging Service

ใช้ messagingServiceSid แทน fromNumber เมื่อ Twilio ควรเลือกผู้ส่งผ่าน Messaging Service:

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

หากมีทั้ง fromNumber และ messagingServiceSid หลังจากแก้ค่าคอนฟิกและ env แล้ว จะใช้ fromNumber

เป้าหมายขาออกเริ่มต้น

ตั้งค่า defaultTo เมื่อการส่งโดยอัตโนมัติหรือการส่งที่ agent เริ่มต้นควรมีปลายทางเริ่มต้น หากโฟลว์การส่งละเว้นเป้าหมายที่ระบุชัดเจน:

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

การควบคุมการเข้าถึง

channels.sms.dmPolicy ควบคุมการเข้าถึง SMS โดยตรง:

• pairing (ค่าเริ่มต้น)
• allowlist (ต้องมีผู้ส่งอย่างน้อยหนึ่งรายใน allowFrom)
• open (ต้องให้ allowFrom รวม "*")
• disabled

รายการ allowFrom ควรเป็นหมายเลขโทรศัพท์ E.164 เช่น +15551234567 ระบบยอมรับและทำให้คำนำหน้า sms: เป็นมาตรฐาน สำหรับผู้ช่วยส่วนตัว ควรใช้ dmPolicy: "allowlist" พร้อมหมายเลขโทรศัพท์ที่ระบุชัดเจน

การส่ง SMS

เป้าหมาย SMS ขาออกใช้คำนำหน้าบริการ sms: โดยเลือกช่องทาง SMS:

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

เมื่อการเลือกช่องทางเป็นแบบโดยนัย twilio-sms:+15551234567 จะเลือกช่องทางนี้โดยไม่เข้าไปแทนที่คำนำหน้าบริการ sms: ที่ช่องทางเดิมเป็นเจ้าของและ iMessage ใช้อยู่

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

CLI ต้องมี --target ที่ระบุชัดเจน defaultTo ใช้สำหรับเส้นทางการส่งโดยอัตโนมัติและการส่งที่ agent เริ่มต้น ซึ่งสามารถแก้เป้าหมายจากคอนฟิกช่องทางได้

การตอบกลับของ agent จากการสนทนา SMS ขาเข้าจะถูกส่งกลับไปยังผู้ส่งโดยอัตโนมัติผ่านผู้ส่ง Twilio ที่กำหนดค่าไว้

เอาต์พุต SMS เป็นข้อความธรรมดา OpenClaw จะลบ markdown แปลง fenced code blocks ให้เป็นข้อความราบเดียว เก็บลิงก์ให้อ่านได้ และแบ่งคำตอบยาวๆ เป็นชิ้นก่อนส่งผ่าน Twilio

ตรวจสอบการตั้งค่า

หลังจาก Gateway เริ่มทำงาน:

1. ยืนยันว่า log ของ Gateway แสดงเส้นทาง Webhook ของ SMS
2. เรียกใช้การตรวจสอบฝั่ง Twilio:

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

3. ส่ง SMS ไปยังหมายเลข Twilio จากโทรศัพท์ของคุณ
4. เรียกใช้ openclaw pairing list sms
5. อนุมัติรหัสการจับคู่ด้วย openclaw pairing approve sms <CODE>
6. ส่ง SMS อีกครั้งและยืนยันว่า agent ตอบกลับ

สำหรับการทดสอบเฉพาะขาออก ให้ใช้:

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

การทดสอบตั้งแต่ต้นจนจบจาก macOS iMessage/SMS

บน Mac ที่สามารถส่ง SMS ของเครือข่ายมือถือผ่าน Messages ได้ คุณสามารถใช้ imsg เพื่อขับฝั่งผู้ส่งโดยไม่ต้องแตะโทรศัพท์ของคุณ:

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

ข้อความแรกควรสร้างคำขอจับคู่ ข้อความที่สองควรได้รับคำตอบจาก agent ผ่าน Twilio

ความปลอดภัยของ Webhook

โดยค่าเริ่มต้น OpenClaw จะตรวจสอบ X-Twilio-Signature โดยใช้ publicWebhookUrl และ authToken ให้ publicWebhookUrl ตรงกับ URL ที่กำหนดค่าใน Twilio แบบ byte-for-byte รวมถึง scheme, host, path และ query string

สำหรับการทดสอบ tunnel ภายในเครื่องเท่านั้น คุณสามารถตั้งค่า:

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

อย่าใช้การตรวจสอบ signature ที่ปิดใช้งานบน Gateway สาธารณะ

คอนฟิกหลายบัญชี

ใช้ accounts เมื่อคุณใช้งานหมายเลข Twilio มากกว่าหนึ่งหมายเลข:

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

แต่ละบัญชีควรใช้ webhookPath ที่แตกต่างกัน

การแก้ไขปัญหา

Twilio ส่งคืน 403 หรือ OpenClaw ปฏิเสธ Webhook

ตรวจสอบว่า publicWebhookUrl ตรงกับ URL ที่กำหนดค่าใน Twilio ทุกประการ รวมถึง scheme, host, path และ query string Twilio จะลงนามสตริง URL สาธารณะ ดังนั้นการ rewrite ของ proxy และชื่อโฮสต์ทางเลือกอาจทำให้การตรวจสอบ signature ล้มเหลว

ไม่พบคำขอจับคู่

ตรวจสอบ URL และเมธอดของ Webhook Messaging ของหมายเลข Twilio ต้องชี้ไปยัง URL Webhook ของ SMS และใช้ POST และยืนยันด้วยว่า Gateway เข้าถึงได้จากอินเทอร์เน็ตสาธารณะหรือผ่าน tunnel ของคุณ

หาก log ข้อความ Twilio แสดงข้อผิดพลาด 11200 หมายความว่า Twilio รับ SMS ขาเข้าแล้ว แต่ไม่สามารถเข้าถึง Webhook ของคุณได้ ตรวจสอบ:

• Twilio Messaging > A message comes in ชี้ไปที่ publicWebhookUrl
• เมธอดคือ POST
• tunnel หรือ reverse proxy เปิดเผย webhookPath ที่ตรงกันทุกประการ สำหรับ Tailscale Funnel ให้เรียกใช้ tailscale funnel status และยืนยันว่ามี /webhooks/sms อยู่ในรายการ
• publicWebhookUrl ใช้ scheme, host, path และ query string เดียวกับที่ Twilio ส่ง เพื่อให้การตรวจสอบ signature สามารถสร้าง URL ที่ถูกลงนามซ้ำได้

การส่งขาออกล้มเหลว

ยืนยันว่า accountSid, authToken และ fromNumber หรือ messagingServiceSid อย่างใดอย่างหนึ่งถูกแก้ค่าแล้ว หากคุณใช้บัญชี Twilio แบบทดลองใช้ อาจต้องยืนยันหมายเลขปลายทางใน Twilio ก่อนจึงจะส่ง SMS ขาออกได้

ข้อความมาถึงแต่ agent ไม่ตอบกลับ

ตรวจสอบ dmPolicy และ allowFrom เมื่อใช้นโยบายเริ่มต้น pairing ผู้ส่งต้องได้รับการอนุมัติก่อนจึงจะประมวลผลรอบการทำงานของเอเจนต์ตามปกติได้