OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

การโทรด้วยเสียง

openclaw voicecall

voicecall เป็นคำสั่งที่ Plugin จัดเตรียมให้ โดยจะปรากฏเฉพาะเมื่อติดตั้งและเปิดใช้งาน Plugin การโทรด้วยเสียงแล้วเท่านั้น

เมื่อ Gateway ทำงานอยู่ คำสั่งควบคุมการทำงาน (call, start, continue, speak, dtmf, end, status) จะส่งต่อไปยังรันไทม์การโทรด้วยเสียงของ Gateway นั้น หากไม่สามารถเข้าถึง Gateway ได้ คำสั่งเหล่านี้จะใช้รันไทม์ CLI แบบสแตนด์อโลนแทน

คำสั่งย่อย

bash
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

การตั้งค่าและการทดสอบเบื้องต้น

setup

โดยค่าเริ่มต้นจะแสดงผลการตรวจสอบความพร้อมในรูปแบบที่มนุษย์อ่านได้ ระบุ --json เพื่อใช้กับสคริปต์

bash
openclaw voicecall setupopenclaw voicecall setup --json

smoke

เรียกใช้การตรวจสอบความพร้อมแบบเดียวกัน โดยจะโทรศัพท์จริงเฉพาะเมื่อระบุทั้ง --to และ --yes

แฟล็ก ค่าเริ่มต้น คำอธิบาย
-t, --to <phone> (ไม่มี) หมายเลขโทรศัพท์ที่จะโทรเพื่อทดสอบจริง
--message <text> OpenClaw voice call smoke test. ข้อความที่จะพูดระหว่างการโทรทดสอบ
--mode <mode> notify โหมดการโทร: notify หรือ conversation
--yes false โทรออกจริง
--json false แสดง JSON ที่เครื่องอ่านได้
bash
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # การทดลองทำงานopenclaw voicecall smoke --to "+15555550123" --yes  # การโทรแจ้งเตือนจริง

วงจรการทำงานของสาย

call

เริ่มการโทรออกด้วยเสียง

แฟล็ก จำเป็น ค่าเริ่มต้น คำอธิบาย
-m, --message <text> ใช่ (ไม่มี) ข้อความที่จะพูดเมื่อเชื่อมต่อสาย
-t, --to <phone> ไม่ การกำหนดค่า toNumber หมายเลขโทรศัพท์รูปแบบ E.164 ที่จะโทร
--mode <mode> ไม่ conversation โหมดการโทร: notify (วางสายหลังพูดข้อความ) หรือ conversation (คงสายไว้)
bash
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notify

start

นามแฝงของ call ที่ใช้รูปแบบแฟล็กเริ่มต้นแตกต่างกัน

แฟล็ก จำเป็น ค่าเริ่มต้น คำอธิบาย
--to <phone> ใช่ (ไม่มี) หมายเลขโทรศัพท์ที่จะโทร
--message <text> ไม่ (ไม่มี) ข้อความที่จะพูดเมื่อเชื่อมต่อสาย
--mode <mode> ไม่ conversation โหมดการโทร: notify หรือ conversation

continue

พูดข้อความและรอการตอบกลับ

แฟล็ก จำเป็น คำอธิบาย
--call-id <id> ใช่ รหัสสาย
--message <text> ใช่ ข้อความที่จะพูด

speak

พูดข้อความโดยไม่รอการตอบกลับ

แฟล็ก จำเป็น คำอธิบาย
--call-id <id> ใช่ รหัสสาย
--message <text> ใช่ ข้อความที่จะพูด

dtmf

ส่งตัวเลข DTMF ไปยังสายที่กำลังใช้งาน

แฟล็ก จำเป็น คำอธิบาย
--call-id <id> ใช่ รหัสสาย
--digits <digits> ใช่ ตัวเลข DTMF (ตัวอย่างเช่น ww123456# สำหรับการรอ)

end

วางสายที่กำลังใช้งาน

แฟล็ก จำเป็น คำอธิบาย
--call-id <id> ใช่ รหัสสาย

status

ตรวจสอบสายที่กำลังใช้งาน

แฟล็ก ค่าเริ่มต้น คำอธิบาย
--call-id <id> (ไม่มี) จำกัดผลลัพธ์ให้แสดงเพียงสายเดียว
--json false แสดง JSON ที่เครื่องอ่านได้
bash
openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

บันทึกและเมตริก

tail

ติดตามบันทึก JSONL ของการโทรด้วยเสียงแบบต่อเนื่อง เมื่อเริ่มต้นจะแสดง --since บรรทัดล่าสุด จากนั้นจะแสดงบรรทัดใหม่ต่อเนื่องเมื่อมีการเขียนข้อมูล

แฟล็ก ค่าเริ่มต้น คำอธิบาย
--file <path> คำนวณจากที่เก็บข้อมูลของ Plugin พาธไปยัง calls.jsonl
--since <n> 25 จำนวนบรรทัดที่จะแสดงก่อนเริ่มติดตาม
--poll <ms> 250 (ขั้นต่ำ 50) ช่วงเวลาการตรวจสอบเป็นมิลลิวินาที

latency

สรุปเมตริกเวลาแฝงของรอบสนทนาและเวลารอฟังจาก calls.jsonl ผลลัพธ์เป็น JSON ซึ่งประกอบด้วยสรุป recordsScanned, turnLatency และ listenWait

แฟล็ก ค่าเริ่มต้น คำอธิบาย
--file <path> คำนวณจากที่เก็บข้อมูลของ Plugin พาธไปยัง calls.jsonl
--last <n> 200 (ขั้นต่ำ 1) จำนวนระเบียนล่าสุดที่จะวิเคราะห์

การเปิดเผย Webhook

expose

เปิด ปิด หรือเปลี่ยนการกำหนดค่า Tailscale Serve/Funnel สำหรับ Webhook เสียง

แฟล็ก ค่าเริ่มต้น คำอธิบาย
--mode <mode> funnel off, serve (tailnet) หรือ funnel (สาธารณะ)
--path <path> การกำหนดค่า tailscale.path หรือ --serve-path พาธ Tailscale ที่จะเปิดให้เข้าถึง
--port <port> การกำหนดค่า serve.port หรือ 3334 พอร์ต Webhook ภายในเครื่อง
--serve-path <path> การกำหนดค่า serve.path หรือ /voice/webhook พาธ Webhook ภายในเครื่อง
bash
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off

เนื้อหาที่เกี่ยวข้อง

Was this useful?
On this page

On this page