Saltar al contenido principal
Todos los puntos de enlace (endpoints) de la API de Claw requieren autenticación a través del encabezado Authorization: Bearer sk-.... URL base: https://api.lemondata.cc/v1/claw

​
Listar instancias

GET /v1/claw/instances
Devuelve todas las instancias de la organización autenticada. 
curl https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key"

{
  "instances": [
    {
      "id": "cm5abc123",
      "subdomain": "mybot",
      "url": "https://claw-mybot.lemondata.cc",
      "defaultModel": "claude-opus-4-6",
      "hasIMConfig": true,
      "status": "RUNNING",
      "paidUntil": "2026-03-10T00:00:00.000Z",
      "canRebuild": true,
      "totalPaid": 20,
      "createdAt": "2026-02-08T00:00:00.000Z"
    }
  ]
}

​
Valores de estado de la instancia

EstadoDescripción
PENDINGRecién creada, esperando provisión
PROVISIONINGEl contenedor se está desplegando
RUNNINGLa instancia está activa y saludable
STOPPEDDetenida por expiración (datos retenidos por 7 días)
FAILEDError en el despliegue (reembolsado automáticamente)
DELETEDEliminada permanentemente

​
Crear instancia

POST /v1/claw/instances
Crea una nueva instancia y cobra $20 por 30 días del saldo de su organización.
​
subdomain
string
requerido
Subdominio (3-32 caracteres, alfanuméricos en minúsculas + guiones). URL de la instancia: https://claw-{subdomain}.lemondata.cc
​
defaultModel
string
Modelo de IA predeterminado (por ejemplo, claude-opus-4-6, gpt-5.2, gemini-3-pro-preview, minimax-m2.5, kimi-k2.5)
curl -X POST https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"subdomain": "mybot", "defaultModel": "claude-opus-4-6"}'

{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "url": "https://claw-mybot.lemondata.cc",
  "status": "PENDING",
  "paidUntil": "2026-03-10T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}
Un saldo insuficiente devuelve 402 Payment Required. Asegúrese de que su organización tenga al menos $20 antes de crear una instancia.

​
Obtener instancia

GET /v1/claw/instances/:id
Devuelve los detalles de una instancia específica.

​
Actualizar instancia

PATCH /v1/claw/instances/:id
Actualizar la configuración de la instancia.
​
defaultModel
string | null
Cambiar el modelo de IA predeterminado
​
imConfig
object | null
Actualizar la configuración de la plataforma de mensajería instantánea (IM) (Telegram, Discord, etc.)
curl -X PATCH https://api.lemondata.cc/v1/claw/instances/cm5abc123 \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"defaultModel": "claude-sonnet-4-5"}'

​
Reconstruir instancia

POST /v1/claw/instances/:id/rebuild
Destruye y recrea el contenedor preservando los datos (PVC). Limitado a 10 reconstrucciones por día. Devuelve 429 Too Many Requests si se supera el límite diario.

​
Renovar instancia

POST /v1/claw/instances/:id/renew
Extiende el período de facturación por 30 días ($20). Si la instancia se detuvo debido a la expiración, se reiniciará automáticamente. 
{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "status": "RUNNING",
  "paidUntil": "2026-04-09T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}

​
Health Check

GET /v1/claw/health
Devuelve el estado de salud del servicio Claw. No se requiere autenticación. 
{"status": "ok", "timestamp": "2026-02-08T15:00:00.000Z"}