跳至主要内容
小龙虾小龙虾AI
🤖

Clawfinger

OpenClaw plugin that bridges to the Clawfinger voice gateway. Provides tools for live call takeover, TTS injection, outbound dialing, hangup, context/knowled...

下载222
星标0
版本0.1.3
开发工具
安全通过
💬Prompt

技能说明


name: clawfinger description: 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. metadata: openclaw: emoji: "\U0001F4DE" skillKey: clawfinger pluginId: clawfinger

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

ToolDescription
clawfinger_statusGateway health, active sessions, bridge status
clawfinger_sessionsList active call session IDs
clawfinger_call_stateFull call state: history, instructions, takeover status
clawfinger_dialDial outbound call via ADB
clawfinger_hangupForce hang up active call and end session
clawfinger_injectInject TTS message into a live call
clawfinger_takeoverTake over LLM control for a session
clawfinger_turn_waitWait for the next caller turn during takeover (returns transcript + request_id)
clawfinger_turn_replySend your reply text for a takeover turn (requires request_id)
clawfinger_releaseRelease LLM control back to local LLM
clawfinger_context_setInject knowledge into session LLM context
clawfinger_context_clearClear injected knowledge
clawfinger_instructions_setSet LLM system instructions (global/session/turn)
clawfinger_call_config_getRead call policy settings
clawfinger_call_config_setUpdate 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

如何使用「Clawfinger」?

  1. 打开小龙虾AI(Web 或 iOS App)
  2. 点击上方「立即使用」按钮,或在对话框中输入任务描述
  3. 小龙虾AI 会自动匹配并调用「Clawfinger」技能完成任务
  4. 结果即时呈现,支持继续对话优化

相关技能