`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 setup
openclaw 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을 출력합니다.

openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123"        # 시험 실행
openclaw voicecall smoke --to "+15555550123" --yes  # 실제 알림 통화

외부 공급자(plivo, telnyx, twilio)를 사용하는 경우 setup과 smoke에는 publicUrl, 터널 또는 Tailscale 노출을 통해 제공되는 공개 Webhook URL이 필요합니다. 통신사에서 접근할 수 없으므로 local loopback 또는 비공개 serve 대체 경로는 거부됩니다.

통화 수명 주기

`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 notify

`start`

기본 플래그 구성이 다른 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 status
openclaw voicecall status --json
openclaw 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 serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off

신뢰하는 네트워크에만 Webhook 엔드포인트를 노출하세요. 가능하면 Funnel보다 Tailscale Serve를 사용하세요.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

음성 통화

`openclaw voicecall`

하위 명령

설정 및 스모크 테스트

`setup`

`smoke`

통화 수명 주기

`call`

`start`

`continue`

`speak`

`dtmf`

`end`

`status`

로그 및 메트릭

`tail`

`latency`

Webhook 노출

`expose`

관련 항목

​openclaw voicecall

​하위 명령

​설정 및 스모크 테스트

​setup

​smoke

​통화 수명 주기

​call

​start

​continue

​speak

​dtmf

​end

​status

​로그 및 메트릭

​tail

​latency

​Webhook 노출

​expose

​관련 항목

`openclaw voicecall`

하위 명령

설정 및 스모크 테스트

`setup`

`smoke`

통화 수명 주기

`call`

`start`

`continue`

`speak`

`dtmf`

`end`

`status`

로그 및 메트릭

`tail`

`latency`

Webhook 노출

`expose`

관련 항목