Skip to main content
AgentBridge lets a coding agent talk directly to one running LemonClaw instance by using the instance gateway token shown in the hosted dashboard.

​
Get The Access Pack

Open Dashboard > Claw, choose a running instance, click AgentBridge, then copy the full access pack from the modal. That pack already contains the runtime base URL, bearer token, session key convention, and the most important endpoints.

​
What The Token Can Do

The copied gateway token manages runtime only. It can read runtime status, send chat requests, stream SSE output, read thread history, stop a running thread, and fetch media returned by AgentBridge. It cannot renew, rebuild, restart from the hosted control plane, or access organization billing and admin routes.

​
Session Keys

Session keys always follow agentbridge:<client_id>:<workspace_id>:<thread_id>. Keep all three values stable for the same thread. If you switch to a different provider family, create a new thread_id instead of reusing the old one.

​
Core Runtime Endpoints

  • GET /api/status
  • GET /api/usage?session=<session_key>
  • POST /api/agentbridge/chat
  • POST /api/agentbridge/chat/stream
  • POST /api/agentbridge/uploads
  • GET /api/agentbridge/messages
  • GET /api/agentbridge/events/stream
  • POST /api/agentbridge/stop
  • GET /api/agentbridge/media
curl -N https://claw-demo.lemondata.cc/api/agentbridge/chat/stream \
  -H "Authorization: Bearer <gateway_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "codex",
    "workspace_id": "default",
    "thread_id": "demo-thread",
    "message": "Give me a short status update for this instance."
  }'

​
Prompt For Coding Agents

Give this short instruction together with the copied access pack:
Use /api/agentbridge/chat/stream first. Keep client_id, workspace_id, and thread_id stable for the same conversation. If you get provider_family_conflict, create a new thread_id instead of reusing the old one.

​
Common Errors

  • provider_family_conflict — the thread already has history on a different provider family; create a new thread_id.
  • Unauthorized — the bearer token is missing, expired, or invalid for this instance.
  • Instance not running — AgentBridge access packs are only issued for running instances.