CLI commands
การโทรด้วยเสียง
openclaw voicecall
voicecall เป็นคำสั่งที่จัดเตรียมโดย Plugin คำสั่งนี้จะแสดงเฉพาะเมื่อ Plugin voice-call ถูกติดตั้งและเปิดใช้งานแล้วเท่านั้น
เมื่อ Gateway กำลังทำงาน คำสั่งปฏิบัติการ (call, start, continue, speak, dtmf, end, status) จะถูกกำหนดเส้นทางไปยังรันไทม์ voice-call ของ Gateway นั้น หากไม่สามารถเข้าถึง Gateway ได้ คำสั่งเหล่านี้จะถอยกลับไปใช้รันไทม์ CLI แบบสแตนด์อโลน
คำสั่งย่อย
openclaw voicecall setup [--json]openclaw voicecall smoke [-t <phone>] [--message <text>] [--mode <m>] [--yes] [--json]openclaw voicecall call -m <text> [-t <phone>] [--mode <m>]openclaw voicecall start --to <phone> [--message <text>] [--mode <m>]openclaw voicecall continue --call-id <id> --message <text>openclaw voicecall speak --call-id <id> --message <text>openclaw voicecall dtmf --call-id <id> --digits <digits>openclaw voicecall end --call-id <id>openclaw voicecall status [--call-id <id>] [--json]openclaw voicecall tail [--file <path>] [--since <n>] [--poll <ms>]openclaw voicecall latency [--file <path>] [--last <n>]openclaw voicecall expose [--mode <m>] [--path <p>] [--port <port>] [--serve-path <p>]| คำสั่งย่อย | คำอธิบาย |
|---|---|
setup |
แสดงการตรวจสอบความพร้อมของผู้ให้บริการและ Webhook |
smoke |
เรียกใช้การตรวจสอบความพร้อม; โทรทดสอบแบบสดเฉพาะเมื่อมี --yes |
call |
เริ่มการโทรเสียงออก |
start |
นามแฝงของ call โดยต้องระบุ --to และ --message เป็นตัวเลือก |
continue |
พูดข้อความและรอการตอบกลับถัดไป |
speak |
พูดข้อความโดยไม่รอการตอบกลับ |
dtmf |
ส่งตัวเลข DTMF ไปยังสายที่กำลังใช้งานอยู่ |
end |
วางสายที่กำลังใช้งานอยู่ |
status |
ตรวจสอบสายที่กำลังใช้งานอยู่ (หรือสายเดียวตาม --call-id) |
tail |
ติดตาม calls.jsonl (มีประโยชน์ระหว่างการทดสอบผู้ให้บริการ) |
latency |
สรุปเมตริกเวลาแฝงต่อรอบจาก calls.jsonl |
expose |
สลับ Tailscale serve/funnel สำหรับปลายทาง Webhook |
การตั้งค่าและ smoke
setup
โดยค่าเริ่มต้นจะแสดงการตรวจสอบความพร้อมในรูปแบบที่มนุษย์อ่านได้ ส่ง --json สำหรับสคริปต์
openclaw voicecall setupopenclaw voicecall setup --jsonsmoke
เรียกใช้การตรวจสอบความพร้อมเดียวกัน จะไม่ทำการโทรจริง เว้นแต่จะมีทั้ง --to และ --yes
| แฟล็ก | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|
-t, --to <phone> |
(ไม่มี) | หมายเลขโทรศัพท์ที่จะโทรสำหรับ smoke แบบสด |
--message <text> |
OpenClaw voice call smoke test. |
ข้อความที่จะพูดระหว่างการโทร smoke |
--mode <mode> |
notify |
โหมดการโทร: notify หรือ conversation |
--yes |
false |
ทำการโทรออกแบบสดจริง |
--json |
false |
พิมพ์ JSON ที่เครื่องอ่านได้ |
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123" # dry runopenclaw voicecall smoke --to "+15555550123" --yes # live notify callวงจรชีวิตการโทร
call
เริ่มการโทรเสียงออก
| แฟล็ก | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
-m, --message <text> |
ใช่ | (ไม่มี) | ข้อความที่จะพูดเมื่อเชื่อมต่อสายแล้ว |
-t, --to <phone> |
ไม่ | config toNumber |
หมายเลขโทรศัพท์รูปแบบ E.164 ที่จะโทร |
--mode <mode> |
ไม่ | conversation |
โหมดการโทร: notify (วางสายหลังข้อความ) หรือ conversation (คงสายไว้) |
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notifystart
นามแฝงของ call ที่มีรูปแบบแฟล็กเริ่มต้นต่างออกไป
| แฟล็ก | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
--to <phone> |
ใช่ | (ไม่มี) | หมายเลขโทรศัพท์ที่จะโทร |
--message <text> |
ไม่ | (ไม่มี) | ข้อความที่จะพูดเมื่อเชื่อมต่อสายแล้ว |
--mode <mode> |
ไม่ | conversation |
โหมดการโทร: notify หรือ conversation |
continue
พูดข้อความและรอการตอบกลับ
| แฟล็ก | จำเป็น | คำอธิบาย |
|---|---|---|
--call-id <id> |
ใช่ | ID การโทร |
--message <text> |
ใช่ | ข้อความที่จะพูด |
speak
พูดข้อความโดยไม่รอการตอบกลับ
| แฟล็ก | จำเป็น | คำอธิบาย |
|---|---|---|
--call-id <id> |
ใช่ | ID การโทร |
--message <text> |
ใช่ | ข้อความที่จะพูด |
dtmf
ส่งตัวเลข DTMF ไปยังสายที่กำลังใช้งานอยู่
| แฟล็ก | จำเป็น | คำอธิบาย |
|---|---|---|
--call-id <id> |
ใช่ | ID การโทร |
--digits <digits> |
ใช่ | ตัวเลข DTMF (เช่น ww123456# สำหรับการรอ) |
end
วางสายที่กำลังใช้งานอยู่
| แฟล็ก | จำเป็น | คำอธิบาย |
|---|---|---|
--call-id <id> |
ใช่ | ID การโทร |
status
ตรวจสอบสายที่กำลังใช้งานอยู่
| แฟล็ก | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|
--call-id <id> |
(ไม่มี) | จำกัดผลลัพธ์ให้เหลือสายเดียว |
--json |
false |
พิมพ์ JSON ที่เครื่องอ่านได้ |
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>บันทึกและเมตริก
tail
ติดตามบันทึก JSONL ของ voice-call พิมพ์ --since บรรทัดล่าสุดเมื่อเริ่มต้น จากนั้นสตรีมบรรทัดใหม่เมื่อมีการเขียน
| แฟล็ก | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|
--file <path> |
resolved from plugin store | เส้นทางไปยัง calls.jsonl |
--since <n> |
25 |
จำนวนบรรทัดที่จะพิมพ์ก่อนเริ่มติดตาม |
--poll <ms> |
250 (ขั้นต่ำ 50) |
ช่วงเวลาการตรวจสอบเป็นมิลลิวินาที |
latency
สรุปเมตริกเวลาแฝงต่อรอบและการรอฟังจาก calls.jsonl ผลลัพธ์เป็น JSON พร้อมสรุป recordsScanned, turnLatency และ listenWait
| แฟล็ก | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|
--file <path> |
resolved from plugin store | เส้นทางไปยัง calls.jsonl |
--last <n> |
200 (ขั้นต่ำ 1) |
จำนวนระเบียนล่าสุดที่จะวิเคราะห์ |
การเปิดเผย Webhook
expose
เปิด ปิด หรือเปลี่ยนการกำหนดค่า Tailscale serve/funnel สำหรับ Webhook เสียง
| แฟล็ก | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|
--mode <mode> |
funnel |
off, serve (tailnet) หรือ funnel (สาธารณะ) |
--path <path> |
config tailscale.path หรือ --serve-path |
เส้นทาง Tailscale ที่จะเปิดเผย |
--port <port> |
config serve.port หรือ 3334 |
พอร์ต Webhook ภายในเครื่อง |
--serve-path <path> |
config serve.path หรือ /voice/webhook |
เส้นทาง Webhook ภายในเครื่อง |
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off