Clawfinger — OpenClaw Voice Gateway Plugin
Requires: Trac-Systems/clawfinger — the local voice gateway and Android phone app. Install and run the gateway before using this plugin.
OpenClaw plugin that gives agents full control over the Clawfinger local voice gateway and its active phone calls.
What It Does
- Call control: Dial outbound calls, hang up, inject spoken messages into live calls
- LLM takeover: Replace the gateway's local LLM with agent-driven responses in real time
- Context injection: Push knowledge into the LLM context so the phone assistant has facts you provide
- Instruction management: Set system prompts at global, session, or one-shot turn scope
- Call policy: Read and update greetings, auto-answer, caller filtering, max duration
- Observation: Query session state, conversation history, and gateway health
Dependencies
- Gateway: A running Clawfinger voice gateway (
app.py on 127.0.0.1:8996)
- Node:
@sinclair/typebox (install via npm install in plugin directory)
- Phone: Android phone with the PhoneBridge app, connected via ADB reverse port forwarding
Configuration
In ~/.openclaw/openclaw.json:
{
"plugins": {
"load": { "paths": ["/path/to/gateway/openclaw/clawfinger"] },
"entries": {
"clawfinger": {
"enabled": true,
"config": {
"gatewayUrl": "http://127.0.0.1:8996",
"bearerToken": "localdev"
}
}
}
}
}
Tools
| Tool |
Description |
clawfinger_status |
Gateway health, active sessions, bridge status |
clawfinger_sessions |
List active call session IDs |
clawfinger_call_state |
Full call state: history, instructions, takeover status |
clawfinger_dial |
Dial outbound call via ADB |
clawfinger_hangup |
Force hang up active call and end session |
clawfinger_inject |
Inject TTS message into a live call |
clawfinger_takeover |
Take over LLM control for a session |
clawfinger_turn_wait |
Wait for the next caller turn during takeover (returns transcript + request_id) |
clawfinger_turn_reply |
Send your reply text for a takeover turn (requires request_id) |
clawfinger_release |
Release LLM control back to local LLM |
clawfinger_context_set |
Inject knowledge into session LLM context |
clawfinger_context_clear |
Clear injected knowledge |
clawfinger_instructions_set |
Set LLM system instructions (global/session/turn) |
clawfinger_call_config_get |
Read call policy settings |
clawfinger_call_config_set |
Update call policy settings |
Slash Commands
/clawfinger status, /clawfinger dial <number>, /clawfinger hangup, /clawfinger inject <text>, /clawfinger takeover <sid>, /clawfinger release <sid>, /clawfinger end <sid>, /clawfinger context get|set|clear <sid>, /clawfinger config call|tts|llm, /clawfinger instructions <text>.
Related Skills
- agent-takeover: Full takeover lifecycle guide with timing model and test case
- voice-gateway: Gateway installation, API reference, and operations
1---2name: clawfinger3description: OpenClaw plugin that bridges to the Clawfinger voice gateway. Provides tools for live call takeover, TTS injection, outbound dialing, hangup, context/knowledge injection, instruction management, and call policy configuration — all over a persistent WebSocket connection.4---5
6# Clawfinger — OpenClaw Voice Gateway Plugin
7
8> **Requires**: [Trac-Systems/clawfinger](https://github.com/Trac-Systems/clawfinger) — the local voice gateway and Android phone app. Install and run the gateway before using this plugin.
9
10OpenClaw plugin that gives agents full control over the Clawfinger local voice gateway and its active phone calls.
11
12## What It Does
13
14- **Call control**: Dial outbound calls, hang up, inject spoken messages into live calls
15- **LLM takeover**: Replace the gateway's local LLM with agent-driven responses in real time
16- **Context injection**: Push knowledge into the LLM context so the phone assistant has facts you provide
17- **Instruction management**: Set system prompts at global, session, or one-shot turn scope
18- **Call policy**: Read and update greetings, auto-answer, caller filtering, max duration
19- **Observation**: Query session state, conversation history, and gateway health
20
21## Dependencies
22
23- **Gateway**: A running Clawfinger voice gateway (`app.py` on `127.0.0.1:8996`)
24- **Node**: `@sinclair/typebox` (install via `npm install` in plugin directory)
25- **Phone**: Android phone with the PhoneBridge app, connected via ADB reverse port forwarding
26
27## Configuration
28
29In `~/.openclaw/openclaw.json`:
30
31```json
32{
33 "plugins": {
34 "load": { "paths": ["/path/to/gateway/openclaw/clawfinger"] },
35 "entries": {
36 "clawfinger": {
37 "enabled": true,
38 "config": {
39 "gatewayUrl": "http://127.0.0.1:8996",
40 "bearerToken": "localdev"
41 }
42 }
43 }
44 }
45}
46```
47
48## Tools
49
50| Tool | Description |
51|------|-------------|
52| `clawfinger_status` | Gateway health, active sessions, bridge status |
53| `clawfinger_sessions` | List active call session IDs |
54| `clawfinger_call_state` | Full call state: history, instructions, takeover status |
55| `clawfinger_dial` | Dial outbound call via ADB |
56| `clawfinger_hangup` | Force hang up active call and end session |
57| `clawfinger_inject` | Inject TTS message into a live call |
58| `clawfinger_takeover` | Take over LLM control for a session |
59| `clawfinger_turn_wait` | Wait for the next caller turn during takeover (returns transcript + request_id) |
60| `clawfinger_turn_reply` | Send your reply text for a takeover turn (requires request_id) |
61| `clawfinger_release` | Release LLM control back to local LLM |
62| `clawfinger_context_set` | Inject knowledge into session LLM context |
63| `clawfinger_context_clear` | Clear injected knowledge |
64| `clawfinger_instructions_set` | Set LLM system instructions (global/session/turn) |
65| `clawfinger_call_config_get` | Read call policy settings |
66| `clawfinger_call_config_set` | Update call policy settings |
67
68## Slash Commands
69
70`/clawfinger status`, `/clawfinger dial <number>`, `/clawfinger hangup`, `/clawfinger inject <text>`, `/clawfinger takeover <sid>`, `/clawfinger release <sid>`, `/clawfinger end <sid>`, `/clawfinger context get|set|clear <sid>`, `/clawfinger config call|tts|llm`, `/clawfinger instructions <text>`.
71
72## Related Skills
73
74- **agent-takeover**: Full takeover lifecycle guide with timing model and test case
75- **voice-gateway**: Gateway installation, API reference, and operations
modbender