agent-takeover

Route live Clawfinger gateway call turns to an external WebSocket agent.

3|1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/Trac-Systems/clawfinger-gateway --skill agent-takeover
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-takeover
Source: https://github.com/Trac-Systems/clawfinger-gateway/tree/main/skills/agent-takeover
Command: npx skills add https://github.com/Trac-Systems/clawfinger-gateway --skill agent-takeover

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

External agents can take control of live calls in the Clawfinger gateway, enabling guided interactions, greetings, and handbacks while the local LLM is paused.

Core Features & Use Cases

  • WebSocket-based takeover protocol: route turn generation to an external agent during a live call.
  • Full lifecycle control: dial, inject, takeover, release, and observe call state via REST and WS endpoints.
  • OpenClaw plugin support (optional) for streamlined tooling and testing.

Quick Start

Dial a test number, inject a greeting, take over for three turns, then release and verify the local LLM resumes.

Frequently Asked Questions about agent-takeover

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I take over a live call from a local LLM using a WebSocket agent?

Live call takeover routes turn generation from the local LLM to an external WebSocket agent via a connection to /api/agent/ws, pausing local generation while the external agent controls the conversation.

What is the WebSocket protocol sequence for dialing, injecting, and releasing a gateway call?

The takeover protocol defines JSON messages for dialing a number, injecting context or greetings, seizing turn generation, and releasing control so the local LLM resumes the live call.

Can I use REST endpoints instead of a WebSocket connection for live call takeover?

Yes, the gateway supports REST fallbacks for observing call state and managing dial, inject, takeover, and release sequences alongside the primary WebSocket protocol.

Do I need the OpenClaw plugin to facilitate external agent takeover?

No, the OpenClaw plugin is optional and provides streamlined tooling and testing, but the core takeover protocol functions directly through the WebSocket and REST endpoints.

When should I use external agent takeover instead of the local LLM for a live call?

External agent takeover is applicable when an agent must greet, inject context, or guide the conversation during a live call, then release control back to the local LLM.

Does the takeover protocol support observing live call state during an active session?

Yes, you can observe call state via REST and WebSocket endpoints during an active session, allowing the external agent to monitor the conversation before or after releasing control.