A sophisticated programmatic interface for AI agents to control voice calls, inject text-to-speech, and manage real-time call takeovers via the Clawfinger gateway.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawfinger
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install clawfinger using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Clawfinger Voice Gateway?
Clawfinger is a specialized plugin for Openclaw Skills that establishes a persistent bridge between AI coding agents and the Clawfinger voice gateway. It enables developers to integrate cellular voice capabilities directly into their agentic workflows, allowing agents to act as real-time voice assistants. By connecting to an Android device via ADB and the PhoneBridge app, this skill provides the necessary tools to bridge the gap between Large Language Models and traditional telephony.
Through this integration, agents can monitor active call states, manage conversation history, and dynamically inject context to ensure the AI has the most relevant facts during a live discussion. It is a critical tool for developers building automated voice support systems, outbound notification agents, or interactive voice response (IVR) replacements that require the nuanced intelligence of modern AI models.
Clawfinger Voice Gateway Use Cases
- Automated outbound dialing for appointment confirmations or status updates via mobile networks.
- Real-time takeover of live customer calls by an AI agent to handle complex troubleshooting.
- Programmatic injection of text-to-speech messages into active phone conversations for notifications.
- Monitoring and logging conversation history from Android devices for data analysis and auditing.
- Remote management of call policies including greetings, auto-answer filters, and call duration limits.
How Clawfinger Voice Gateway Works
- The user launches the Clawfinger voice gateway locally and connects an Android phone running the PhoneBridge app.
- Openclaw Skills initialize the Clawfinger plugin using the configured gateway URL and authentication token.
- The agent uses the
clawfinger_dialtool to initiate a call or waits for the gateway to report an incoming session. - During a call, the agent can invoke
clawfinger_takeoverto intercept user input and provide custom responses instead of the gateway's default logic. - The agent loops through
clawfinger_turn_waitto receive live transcripts andclawfinger_turn_replyto speak back to the caller. - Upon completion, the agent executes
clawfinger_hangupor releases the session back to the gateway's automated handling.
Clawfinger Voice Gateway Setup
First, ensure the Clawfinger gateway is active and accessible. Install the required dependencies in the plugin directory:
npm install @sinclair/typebox
Configure the skill in your ~/.openclaw/openclaw.json file by adding the plugin path and gateway credentials:
{
"plugins": {
"load": { "paths": ["/path/to/gateway/openclaw/clawfinger"] },
"entries": {
"clawfinger": {
"enabled": true,
"config": {
"gatewayUrl": "http://127.0.0.1:8996",
"bearerToken": "your_token_here"
}
}
}
}
}
Clawfinger Voice Gateway Data Schema & Taxonomy
The skill manages call data through several structured components:
| Data Component | Description |
|---|---|
| Session State | Contains the unique Session ID (SID), conversation history, and active status. |
| Call Policy | Defines global behaviors like auto_answer, greetings, and max_duration. |
| Instruction Set | Categorized into Global, Session, or Turn-based prompts to guide LLM behavior. |
| Knowledge Context | Injected facts or documents that the voice assistant uses to provide accurate answers. |
| Takeover Metadata | Tracks request IDs for specific conversation turns during manual agent control. |
Clawfinger Voice Gateway Advanced Features
- Multi-scope instruction management allowing for temporary, session-wide, or permanent system prompt overrides.
- Low-latency WebSocket communication for seamless real-time interaction between the agent and the caller.
- Full call policy configuration enabling programmatic control over white-listing and automated responses.
- ADB reverse port forwarding support for stable connections to physical Android hardware.
- Granular session observation tools to query gateway health and active bridge statuses.
SKILL.md
Loading
Related Openclaw Skills
Agent Takeover
A protocol-level skill for hijacking live voice gateway turns to provide custom agent responses or human intervention.
Session Reset
A powerful utility for safely resetting, backing up, and restoring OpenClaw agent sessions to maintain optimal performance.
Ambit CLI
A CLI tool for deploying applications to secure, private Fly.io networks reachable only via Tailscale.
Advanced Calendar
An AI-powered scheduling system that manages events through natural language and provides persistent multi-channel notifications.
Intercom Vibe Competition
A developer competition to build original agent-native apps on the Intercom network for TNK rewards.
IntercomSwap
A high-security, operator-managed tool for executing P2P RFQ swaps between BTC Lightning and Solana USDT via Intercom sidechannels.
Featured*
