Claw Voice

You are connected to a live user session via voice. The user is speaking to you through a voice interface. Use the bundled

client.py

script to communicate with them in real time.

The script is located at

$skill_dir/client.py

Sending a message to the user

To say something to the user, run:

uv run python $skill_dir/client.py send "Hello! How can I help you today?"

The server echoes back a confirmation as JSON:

{"type": "echo", "content": "Hello! How can I help you today?"}

Receiving the next message from the user

To wait for the user to say something:

uv run python $skill_dir/client.py recv

This blocks until the user speaks, then prints their message as JSON and exits:

{"type": "message", "content": "What's the weather like?"}

Use

--timeout

to control how long to wait (default 30s):

uv run python $skill_dir/client.py recv --timeout 60

If the timeout expires with no message, it prints an error and exits with code 1.

Listening for multiple messages

To receive a stream of messages over a period of time:

uv run python $skill_dir/client.py listen --timeout 60

This prints each incoming message as a JSON line until the timeout expires:

{"type": "message", "content": "Tell me a joke"}
{"type": "message", "content": "Actually, make it about cats"}

Running as an agent bridge

The

agent

command creates a loop: it listens for user messages, forwards each one to

openclaw agent --agent main --message '<message>'

, captures the stdout, and sends it back to the user over the WebSocket.

uv run python $skill_dir/client.py agent

This runs indefinitely by default. Use

--timeout

to limit the session:

uv run python $skill_dir/client.py agent --timeout 300

The flow for each message:

User speaks -> server sends
```
{"type": "message", "content": "..."}
```
to the client

Client runs

openclaw agent --agent main --message '...'

and captures stdout

Client sends the agent's response back:

{"type": "message", "content": "<stdout>"}

Logs are printed to stderr-style output as

[user]

and

[agent]

prefixed lines.

Connection options

All commands accept

--url

to override the default WebSocket address:

uv run python $skill_dir/client.py --url ws://$host:$port/connect send "Hi"

Default URL:

ws://localhost:3111/connect

Message types reference

Messages you send (agent -> user)

Type	Fields	Description
`message`	`content` (string)	Text to speak/display to the user

Messages you receive (user -> agent)

Type	Fields	Description
`message`	`content` (string)	What the user said (transcribed text)
`echo`	`content` (string)	Server confirmation of your sent message — ignore these
`pong`		Connection health check response — ignore these

Behavior guidelines

Respond promptly to every
```
message
```
you receive from the user.
Keep responses conversational and concise — the user is speaking, not reading.
Send one message at a time. Do not batch multiple sends.
Ignore
```
echo
```
messages — they are confirmations, not user input.
Use
```
recv
```
for turn-based conversation. Use
```
listen
```
when you expect the user to say multiple things.

ClawVoice

AI Skill Market Insights

Be Part of the 2,086+ Developer Community

Claw Voice

Sending a message to the user

Receiving the next message from the user

Listening for multiple messages

Running as an agent bridge

Connection options

Message types reference

Messages you send (agent -> user)

Messages you receive (user -> agent)

Behavior guidelines

Quick Start

Manual Installation

TEAR & SHARE

Tags

README

OpenClaw WhatsApp

Gotify

Reflect Notes

Farcaster Agent

Channels

Learn

Compare

Company