CLI commands
음성 통화
openclaw voicecall
voicecall은 Plugin에서 제공하는 명령입니다. 음성 통화 Plugin이 설치되고 활성화된 경우에만 표시됩니다.
Gateway가 실행 중이면 운영 명령(call, start, continue, speak, dtmf, end, status)은 해당 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 |
--to가 필수이고 --message가 선택 사항인 call의 별칭입니다. |
continue |
메시지를 말하고 다음 응답을 기다립니다. |
speak |
응답을 기다리지 않고 메시지를 말합니다. |
dtmf |
진행 중인 통화에 DTMF 숫자를 전송합니다. |
end |
진행 중인 통화를 종료합니다. |
status |
진행 중인 통화 또는 --call-id로 지정한 통화 하나를 조회합니다. |
tail |
calls.jsonl을 실시간으로 추적합니다(공급자 테스트 중 유용). |
latency |
calls.jsonl의 턴 지연 시간 메트릭을 요약합니다. |
expose |
Webhook 엔드포인트의 Tailscale serve/funnel을 전환합니다. |
설정 및 스모크 테스트
setup
기본적으로 사람이 읽을 수 있는 준비 상태 검사 결과를 출력합니다. 스크립트에서는 --json을 전달하세요.
openclaw voicecall setupopenclaw voicecall setup --jsonsmoke
동일한 준비 상태 검사를 실행합니다. --to와 --yes를 모두 지정한 경우에만 실제 전화를 겁니다.
| 플래그 | 기본값 | 설명 |
|---|---|---|
-t, --to <phone> |
(없음) | 실제 스모크 테스트에서 전화할 번호입니다. |
--message <text> |
OpenClaw voice call smoke test. |
스모크 테스트 통화 중에 말할 메시지입니다. |
--mode <mode> |
notify |
통화 모드: notify 또는 conversation. |
--yes |
false |
실제 발신 통화를 겁니다. |
--json |
false |
기계가 읽을 수 있는 JSON을 출력합니다. |
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(연결 유지). |
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 로그를 실시간으로 추적합니다. 시작할 때 마지막 --since개 줄을 출력한 다음, 새 줄이 기록되는 대로 스트리밍합니다.
| 플래그 | 기본값 | 설명 |
|---|---|---|
--file <path> |
Plugin 저장소에서 결정 | calls.jsonl 경로입니다. |
--since <n> |
25 |
실시간 추적 전에 출력할 줄 수입니다. |
--poll <ms> |
250(최솟값 50) |
밀리초 단위 폴링 간격입니다. |
latency
calls.jsonl의 턴 지연 시간 및 수신 대기 메트릭을 요약합니다. 출력은 recordsScanned, turnLatency, listenWait 요약이 포함된 JSON입니다.
| 플래그 | 기본값 | 설명 |
|---|---|---|
--file <path> |
Plugin 저장소에서 결정 | calls.jsonl 경로입니다. |
--last <n> |
200(최솟값 1) |
분석할 최근 레코드 수입니다. |
Webhook 노출
expose
음성 Webhook의 Tailscale serve/funnel 구성을 활성화하거나 비활성화하거나 변경합니다.
| 플래그 | 기본값 | 설명 |
|---|---|---|
--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 경로입니다. |
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off관련 항목
Was this useful?
