--- read_when: - Bạn sử dụng Plugin voice-call và muốn mọi điểm vào CLI - Cần có các bảng cờ lệnh và giá trị mặc định cho setup, smoke, call, continue, speak, dtmf, end, status, tail, latency, expose và start summary: Tham chiếu CLI cho `openclaw voicecall` (giao diện lệnh Plugin gọi thoại) title: Cuộc gọi thoại x-i18n: generated_at: "2026-05-10T19:29:49Z" model: gpt-5.5 provider: openai source_hash: 24013c06bf3e688bd86caa407bf20dddabe0dff60a400ed4f23478de62308634 source_path: cli/voicecall.md workflow: 16 --- # `openclaw voicecall` `voicecall` là lệnh do Plugin cung cấp. Lệnh này chỉ xuất hiện khi Plugin cuộc gọi thoại được cài đặt và bật. Khi Gateway đang chạy, các lệnh vận hành (`call`, `start`, `continue`, `speak`, `dtmf`, `end`, `status`) được định tuyến đến runtime cuộc gọi thoại của Gateway đó. Nếu không thể kết nối đến Gateway nào, chúng sẽ chuyển sang runtime CLI độc lập. ## Lệnh con ```bash openclaw voicecall setup [--json] openclaw voicecall smoke [-t ] [--message ] [--mode ] [--yes] [--json] openclaw voicecall call -m [-t ] [--mode ] openclaw voicecall start --to [--message ] [--mode ] openclaw voicecall continue --call-id --message openclaw voicecall speak --call-id --message openclaw voicecall dtmf --call-id --digits openclaw voicecall end --call-id openclaw voicecall status [--call-id ] [--json] openclaw voicecall tail [--file ] [--since ] [--poll ] openclaw voicecall latency [--file ] [--last ] openclaw voicecall expose [--mode ] [--path

] [--port ] [--serve-path

] ``` | Lệnh con | Mô tả | | ---------- | ---------------------------------------------------------------- | | `setup` | Hiển thị các bước kiểm tra mức sẵn sàng của nhà cung cấp và Webhook. | | `smoke` | Chạy kiểm tra mức sẵn sàng; chỉ thực hiện cuộc gọi thử nghiệm trực tiếp với `--yes`. | | `call` | Khởi tạo cuộc gọi thoại đi. | | `start` | Bí danh cho `call` với `--to` bắt buộc và `--message` tùy chọn. | | `continue` | Phát một thông điệp và chờ phản hồi tiếp theo. | | `speak` | Phát một thông điệp mà không chờ phản hồi. | | `dtmf` | Gửi chữ số DTMF đến một cuộc gọi đang hoạt động. | | `end` | Gác máy một cuộc gọi đang hoạt động. | | `status` | Kiểm tra các cuộc gọi đang hoạt động (hoặc một cuộc gọi theo `--call-id`). | | `tail` | Theo dõi `calls.jsonl` (hữu ích trong khi kiểm thử nhà cung cấp). | | `latency` | Tóm tắt chỉ số độ trễ lượt từ `calls.jsonl`. | | `expose` | Bật/tắt Tailscale serve/funnel cho điểm cuối Webhook. | ## Thiết lập và smoke ### `setup` Mặc định in các bước kiểm tra mức sẵn sàng ở dạng người đọc được. Truyền `--json` cho script. ```bash openclaw voicecall setup openclaw voicecall setup --json ``` ### `smoke` Chạy cùng các bước kiểm tra mức sẵn sàng. Lệnh này sẽ không thực hiện cuộc gọi điện thoại thật trừ khi có cả `--to` và `--yes`. | Cờ | Mặc định | Mô tả | | ------------------ | --------------------------------- | ------------------------------------------ | | `-t, --to ` | (không có) | Số điện thoại để gọi cho smoke trực tiếp. | | `--message ` | `OpenClaw voice call smoke test.` | Thông điệp sẽ phát trong cuộc gọi smoke. | | `--mode ` | `notify` | Chế độ gọi: `notify` hoặc `conversation`. | | `--yes` | `false` | Thực sự thực hiện cuộc gọi đi trực tiếp. | | `--json` | `false` | In JSON cho máy đọc. | ```bash openclaw voicecall smoke openclaw voicecall smoke --to "+15555550123" # dry run openclaw voicecall smoke --to "+15555550123" --yes # live notify call ``` Đối với nhà cung cấp bên ngoài (`twilio`, `telnyx`, `plivo`), `setup` và `smoke` yêu cầu URL Webhook công khai từ `publicUrl`, tunnel, hoặc phơi bày qua Tailscale. Phương án dự phòng loopback hoặc serve riêng tư bị từ chối vì nhà mạng không thể truy cập. ## Vòng đời cuộc gọi ### `call` Khởi tạo cuộc gọi thoại đi. | Cờ | Bắt buộc | Mặc định | Mô tả | | ---------------------- | -------- | ----------------- | -------------------------------------------------------------------------- | | `-m, --message ` | có | (không có) | Thông điệp sẽ phát khi cuộc gọi kết nối. | | `-t, --to ` | không | config `toNumber` | Số điện thoại E.164 để gọi. | | `--mode ` | không | `conversation` | Chế độ gọi: `notify` (gác máy sau thông điệp) hoặc `conversation` (giữ mở). | ```bash openclaw voicecall call --to "+15555550123" --message "Hello" openclaw voicecall call -m "Heads up" --mode notify ``` ### `start` Bí danh cho `call` với dạng cờ mặc định khác. | Cờ | Bắt buộc | Mặc định | Mô tả | | ------------------ | -------- | -------------- | ------------------------------------------ | | `--to ` | có | (không có) | Số điện thoại để gọi. | | `--message ` | không | (không có) | Thông điệp sẽ phát khi cuộc gọi kết nối. | | `--mode ` | không | `conversation` | Chế độ gọi: `notify` hoặc `conversation`. | ### `continue` Phát một thông điệp và chờ phản hồi. | Cờ | Bắt buộc | Mô tả | | ------------------ | -------- | ---------------------- | | `--call-id ` | có | ID cuộc gọi. | | `--message ` | có | Thông điệp sẽ phát. | ### `speak` Phát một thông điệp mà không chờ phản hồi. | Cờ | Bắt buộc | Mô tả | | ------------------ | -------- | ---------------------- | | `--call-id ` | có | ID cuộc gọi. | | `--message ` | có | Thông điệp sẽ phát. | ### `dtmf` Gửi chữ số DTMF đến một cuộc gọi đang hoạt động. | Cờ | Bắt buộc | Mô tả | | ------------------- | -------- | ------------------------------------------------- | | `--call-id ` | có | ID cuộc gọi. | | `--digits ` | có | Chữ số DTMF (ví dụ `ww123456#` cho thời gian chờ). | ### `end` Gác máy một cuộc gọi đang hoạt động. | Cờ | Bắt buộc | Mô tả | | ---------------- | -------- | ------------ | | `--call-id ` | có | ID cuộc gọi. | ### `status` Kiểm tra các cuộc gọi đang hoạt động. | Cờ | Mặc định | Mô tả | | ---------------- | ---------- | -------------------------------------- | | `--call-id ` | (không có) | Giới hạn đầu ra ở một cuộc gọi. | | `--json` | `false` | In JSON cho máy đọc. | ```bash openclaw voicecall status openclaw voicecall status --json openclaw voicecall status --call-id ``` ## Nhật ký và chỉ số ### `tail` Theo dõi nhật ký JSONL cuộc gọi thoại. In `--since` dòng cuối cùng khi bắt đầu, sau đó stream các dòng mới khi chúng được ghi. | Cờ | Mặc định | Mô tả | | --------------- | -------------------------- | ---------------------------------- | | `--file ` | được phân giải từ kho Plugin | Đường dẫn đến `calls.jsonl`. | | `--since ` | `25` | Số dòng cần in trước khi theo dõi. | | `--poll ` | `250` (tối thiểu 50) | Khoảng thời gian poll tính bằng mili giây. | ### `latency` Tóm tắt chỉ số độ trễ lượt và thời gian chờ lắng nghe từ `calls.jsonl`. Đầu ra là JSON với các bản tóm tắt `recordsScanned`, `turnLatency`, và `listenWait`. | Cờ | Mặc định | Mô tả | | --------------- | -------------------------- | ------------------------------------ | | `--file ` | được phân giải từ kho Plugin | Đường dẫn đến `calls.jsonl`. | | `--last ` | `200` (tối thiểu 1) | Số bản ghi gần đây cần phân tích. | ## Phơi bày Webhook ### `expose` Bật, tắt, hoặc thay đổi cấu hình Tailscale serve/funnel cho Webhook thoại. | Cờ | Mặc định | Mô tả | | --------------------- | ----------------------------------------- | --------------------------------------------- | | `--mode ` | `funnel` | `off`, `serve` (tailnet), hoặc `funnel` (công khai). | | `--path ` | config `tailscale.path` hoặc `--serve-path` | Đường dẫn Tailscale cần phơi bày. | | `--port ` | config `serve.port` hoặc `3334` | Cổng Webhook cục bộ. | | `--serve-path ` | config `serve.path` hoặc `/voice/webhook` | Đường dẫn Webhook cục bộ. | ```bash openclaw voicecall expose --mode serve openclaw voicecall expose --mode funnel openclaw voicecall expose --mode off ``` Chỉ phơi bày điểm cuối Webhook cho các mạng bạn tin cậy. Ưu tiên Tailscale Serve hơn Funnel khi có thể. ## Liên quan - [Tham chiếu CLI](/vi/cli) - [Plugin cuộc gọi thoại](/vi/plugins/voice-call)