agent-takeover
by tracsystems
Web & Frontend DevelopmentBrief
How to perform a live agent takeover of the Clawfinger voice gateway — dial, inject greetings, handle turns.
Description
What This Skill Does
Lets an external agent take control of a live phone call handled by the Clawfinger voice gateway, respond to caller turns directly, and hand back to the local LLM when done. The agent connects over WebSocket, receives caller transcripts as turn.request events, and replies with text that the gateway converts to speech. REST endpoints cover auxiliary actions like dial, inject, and hangup, but takeover itself requires the WebSocket connection.
Replacing the local LLM mid-call in real time lets the agent deliver deterministic or specialized responses without changing any gateway configuration.
When to Use It
- Injecting a scripted greeting before the local LLM handles the caller
- Running a 3-turn canned-response test on a live outbound call
- Handing a call to a specialized agent for a focused task, then releasing it back
- Observing ASR transcripts and LLM replies on active calls without interfering
- Force-hanging up or ending sessions programmatically from an external script
Example Workflow
User asks: take over the next outbound call, say a custom greeting, handle 3 turns, then release
- 1
Connect to the agent WebSocket and send a dial command with the target number
- 2
Watch bus events for a session_id on turn.started after the callee picks up
- 3
Send inject with the greeting text, then send takeover for the discovered session_id
- 4
Receive turn.request events and echo back request_id with each reply text for 3 turns
- 5
Send release to hand the session back to the local LLM and confirm via release.ack
Caller hears the custom greeting and 3 agent-controlled responses, then the local LLM resumes on the next turn without interruption
Installation
clawhub install tracsystems/agent-takeoverRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.