OpenClaw Plugin: AnthroVision Bridge

This plugin gives OpenClaw two tools:

• anthrovision_bridge_submit_scan
• anthrovision_bridge_check_scan

It connects your OpenClaw assistant to the standalone bridge service in:

• /Users/danielryan/Projects/body-measurement-scanner/products/anthrovision-bridge

Install Locally

openclaw plugins install -l /Users/danielryan/Projects/body-measurement-scanner/products/openclaw-plugin-anthrovision-bridge
openclaw plugins list

Configure

Add plugin config to your OpenClaw config (or edit via UI if available):

{
  "plugins": {
    "entries": {
      "openclaw-plugin-anthrovision-bridge": {
        "enabled": true,
        "config": {
          "apiKey": "replace-with-api-key",
          "defaultGender": "male",
          "defaultHeightCm": 180.3
        }
      }
    }
  }
}

• apiKey is required.
• baseUrl is optional and defaults to https://anthrovision-bridge-production.up.railway.app.
• Backward compatibility: bridgeToken is still accepted if apiKey is not set.

After updating plugin config, restart OpenClaw gateway.

For local/self-hosted testing, set:

• "baseUrl": "http://localhost:8787"

User One-Time Setup (from npm)

A user needs one value from AnthroVision support:

1. apiKey (their personal access key)

Then they run:

openclaw plugins install openclaw-plugin-anthrovision-bridge
openclaw config set plugins.entries.openclaw-plugin-anthrovision-bridge.enabled true
openclaw config set plugins.entries.openclaw-plugin-anthrovision-bridge.config.apiKey "<their-personal-api-key>"
openclaw gateway restart

If they need a custom bridge deployment:

openclaw config set plugins.entries.openclaw-plugin-anthrovision-bridge.config.baseUrl https://your-bridge.example.com
openclaw gateway restart

In Telegram, they should send /reset once after install/restart.

Billing & Credits

• Billing is prepaid and enforced by the bridge.
• Each successful scan deducts 1 credit.
• If credits are exhausted, the bridge returns 402 Payment Required.
• The plugin maps billing/auth/rate-limit statuses to user-safe messages and returns telegram_reply plus dashboard_url (defaults to https://body-measurement-scanner.vercel.app/billing).
• Consent prompts can use Telegram inline button styles (primary|success|danger) when supported by your OpenClaw version/channel config.

Telegram Flow

1. User shares video + gender + height + phone model.
   • video_url should be a downloadable https:// URL.
   • OpenClaw inbound local paths are accepted only from ~/.openclaw/media/inbound and are sent as inline base64.
   • Private/local network URLs are blocked by default (localhost, 127.0.0.1, RFC1918 ranges).
2. Assistant uses anthrovision_bridge_submit_scan.
3. Assistant polls anthrovision_bridge_check_scan.
4. Assistant returns measurements in chat.
5. If Telegram inline buttons are enabled, consent and billing actions can be shown as styled buttons.
6. Typical processing time is about 1-4 minutes; the submit acknowledgement includes estimated wait.

Troubleshooting

• 401 or 403: API key is missing/invalid. Update apiKey in plugin config.
• 402: Credits are exhausted. Add credits, then retry.
• 429: Too many requests. Wait briefly and retry.
• Long processing times: if a scan takes a while, use the Support ID shown in bot replies to trace it in bridge logs.

If Telegram Says "I don't have tools ..."

Run:

openclaw gateway restart

Then in the Telegram chat with your bot, send:

/reset

This forces a fresh tool/session context so anthrovision_bridge_submit_scan and anthrovision_bridge_check_scan are available.

Share With Others

1. Move this plugin folder to its own repo.
2. Publish as npm package.
3. Users install with:
   • openclaw plugins install openclaw-plugin-anthrovision-bridge

Launch Checklist (v1)

1. Publish bridge service (Railway/Render) from:
   • /Users/danielryan/Projects/body-measurement-scanner/products/anthrovision-bridge
2. Set bridge production env vars:
   • SWAN_API_KEY
   • OPENCLAW_BRIDGE_PUBLIC_BASE_URL (your public bridge URL)
   • OPENCLAW_BRIDGE_TOKEN
   • SWAN_WEBHOOK_TOKEN
   • UPSTASH_REDIS_REST_URL
   • UPSTASH_REDIS_REST_TOKEN
   • Leave OPENCLAW_SWAN_CALLBACK_URL empty in production.
3. Publish plugin package from:
   • /Users/danielryan/Projects/body-measurement-scanner/products/openclaw-plugin-anthrovision-bridge
4. Install plugin on any OpenClaw instance:
   • openclaw plugins install openclaw-plugin-anthrovision-bridge
5. Add plugin config (apiKey, optional baseUrl), then restart gateway:
   • openclaw gateway restart