REST API

HTTP endpoints for health checks, skill inspection, and message submission.

The DragonClaw gateway exposes a REST API on port 18789 by default.

In production behind Nginx, you can publish it under /api/.

Authentication

If DRAGONCLAW_GATEWAY_TOKEN is set, all endpoints except /health require a bearer token.

Authorization: Bearer your-token-here

Endpoints

GET /health

Health check. No auth required.

{
  "status": "ok",
  "version": "0.1.0",
  "uptime": 3600,
  "memory": "45MB",
  "skills": { "core": 7, "user": 2 },
  "connectors": ["telegram", "dingtalk"]
}

GET /skills

Lists loaded skills.

[
  {
    "slug": "binance-spot",
    "title": "Binance Spot Trading",
    "source": "core",
    "description": "Place, cancel, and query spot orders on Binance.",
    "requiresAuth": true
  }
]

POST /message

Send a message to the agent.

{
  "content": "BTC现在什么价格？",
  "channelId": "my-app-channel",
  "userId": "user-123"
}

Request rules

• content is required

• Max message size is 10,000 characters

• channelId is optional but recommended for session continuity

• userId is optional but useful for rate limits and memory

Error responses

{ "error": "Missing or invalid content field" }
{ "error": "Unauthorized" }
{ "error": "Payload too large" }
{ "error": "Rate limited", "retryAfterMs": 45000 }
{ "error": "Internal error" }