Chuyển đến nội dung chính
Tất cả các endpoint API của Claw đều yêu cầu xác thực thông qua header Authorization: Bearer sk-.... Base URL: https://api.lemondata.cc/v1/claw

​
Liệt kê các Instance

GET /v1/claw/instances
Trả về tất cả các instance của tổ chức đã được xác thực. 
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"
    }
  ]
}

​
Các giá trị trạng thái Instance

Trạng tháiMô tả
PENDINGVừa được tạo, đang chờ cung cấp tài nguyên
PROVISIONINGContainer đang được triển khai
RUNNINGInstance đang hoạt động và ổn định
STOPPEDĐã dừng do hết hạn (dữ liệu được giữ lại trong 7 ngày)
FAILEDTriển khai thất bại (được tự động hoàn tiền)
DELETEDĐã bị xóa vĩnh viễn

​
Tạo Instance

POST /v1/claw/instances
Tạo một instance mới và tính phí $20 cho 30 ngày từ số dư tài khoản tổ chức của bạn.
​
subdomain
string
bắt buộc
Subdomain (3-32 ký tự, chữ cái viết thường và số + dấu gạch ngang). URL của Instance: https://claw-{subdomain}.lemondata.cc
​
defaultModel
string
Mô hình AI mặc định (ví dụ: 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
}
Số dư không đủ sẽ trả về 402 Payment Required. Hãy đảm bảo tổ chức của bạn có ít nhất $20 trước khi tạo instance.

​
Lấy thông tin Instance

GET /v1/claw/instances/:id
Trả về chi tiết của một instance cụ thể.

​
Cập nhật Instance

PATCH /v1/claw/instances/:id
Cập nhật cấu hình của instance.
​
defaultModel
string | null
Thay đổi mô hình AI mặc định
​
imConfig
object | null
Cập nhật cấu hình nền tảng IM (Telegram, Discord, v.v.)
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"}'

​
Xây dựng lại (Rebuild) Instance

POST /v1/claw/instances/:id/rebuild
Hủy và tạo lại container trong khi vẫn giữ lại dữ liệu (PVC). Giới hạn 10 lần rebuild mỗi ngày. Trả về 429 Too Many Requests nếu vượt quá giới hạn hàng ngày.

​
Gia hạn Instance

POST /v1/claw/instances/:id/renew
Kéo dài chu kỳ thanh toán thêm 30 ngày ($20). Nếu instance đã bị dừng do hết hạn, nó sẽ tự động khởi động lại. 
{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "status": "RUNNING",
  "paidUntil": "2026-04-09T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}

​
Kiểm tra sức khỏe (Health Check)

GET /v1/claw/health
Trả về trạng thái sức khỏe của dịch vụ Claw. Không yêu cầu xác thực. 
{"status": "ok", "timestamp": "2026-02-08T15:00:00.000Z"}