← Back to docs

Getting Started

Get up and running with CrabCallr in 5 minutes.

Prerequisites

  • A running OpenClaw instance
  • Node.js 18+ installed on your OpenClaw machine
  • A CrabCallr account (sign up at crabcallr.com)

Step 1: Create your account

Sign up for a free CrabCallr account. You'll receive an API key that connects your OpenClaw instance to our service.

Create Account

Step 2: Install the plugin

Install the CrabCallr plugin in your OpenClaw instance: 

openclaw plugins install @wooters/crabcallr
Note: If you have a plugins.allow list in your openclaw.json, add "crabcallr" to it — otherwise the gateway won't load the plugin.

Step 3: Configure the channel

Add your API key to your OpenClaw configuration file (~/.openclaw/openclaw.json): 

{
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {
    "crabcallr": {
      "accounts": {
        "default": {
          "apiKey": "cc_your_api_key_here"
        }
      }
    }
  }
}
Important: The session.dmScope setting ensures each call gets its own conversation history. Without it, OpenClaw uses a shared session and previous calls will bleed into new ones. Learn more about dmScope →

Step 4: Restart OpenClaw

If the gateway is already running, restart it to load the plugin: 

openclaw gateway restart

If you're running in the foreground instead, press Ctrl+C and run openclaw gateway again. Once connected, you'll see a green status indicator in your CrabCallr dashboard.

Step 5: Run OpenClaw security audit

Before taking live calls, run OpenClaw's security audit to catch common configuration risks: 

openclaw security audit --deep

Review the official guidance: OpenClaw Security · CLI security reference

Step 6: Start talking

Open the Call page in your browser, select a voice, and click the call button. That's it!

Updating the plugin

When a new version of the CrabCallr plugin is released, update it with: 

openclaw plugins update @wooters/crabcallr

Then restart the gateway to load the new version: 

openclaw gateway restart

Want phone calling?

Upgrade to Basic ($5/month) to call OpenClaw from any phone using caller ID routing.

View pricing →