🔧 Bot Setup Guide

Just tell your bot what to do:

Learn how to handle "connect clawphone" requests by reading: https://api.clawphone.app/skill

Smart bots will read the instructions and learn the skill automatically.

Add this to your bot's TOOLS.md file:

## ClawPhone Connect

When user says "connect clawphone":

1. Call the API:
curl -s -X POST https://api.clawphone.app/api/connect/generate \
  -H "Content-Type: application/json" \
  -d '{"bot_url":"YOUR_BOT_URL","gateway_token":"YOUR_TOKEN","bot_name":"YOUR_BOT_NAME"}'

2. Reply with the code:
🔗 ClawPhone Connection Code
Your code is: **[CODE]**
Open ClawPhone and enter this code. Expires in 5 minutes.

Replace these values:

• YOUR_BOT_URL - Your bot's public URL (e.g., http://your-server.com:18789)
• YOUR_TOKEN - Gateway token from openclaw.json
• YOUR_BOT_NAME - Name to show in the app

Gateway Token:

In your openclaw.json file, look for:

{
  "gateway": {
    "auth": {
      "token": "your-token-here"
    }
  }
}

Bot URL:

This is where your bot is accessible from the internet. Usually:

http://your-server-ip:18789

Your bot must be reachable from the internet for ClawPhone to connect.