跳轉到主要內容
所有 Claw API 端點皆需要透過 Authorization: Bearer sk-... 標頭進行身分驗證。 基礎 URL： https://api.lemondata.cc/v1/claw

​
列出實例

GET /v1/claw/instances
傳回已驗證組織的所有實例。 
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"
    }
  ]
}

​
實例狀態值

狀態描述
PENDING剛建立，等待配置中
PROVISIONING容器正在部署中
RUNNING實例已啟用且運行正常
STOPPED因過期而停止（數據保留 7 天）
FAILED部署失敗（已自動退款）
DELETED永久移除

​
建立實例

POST /v1/claw/instances
建立新實例並從您的組織餘額中扣除 $20（有效期 30 天）。
​
subdomain
string
必填
子網域（3-32 個字元，小寫字母數字 + 連字號）。實例 URL：https://claw-{subdomain}.lemondata.cc
​
defaultModel
string
預設 AI 模型（例如：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
}
餘額不足將傳回 402 Payment Required。在建立實例前，請確保您的組織至少有 $20。

​
獲取實例

GET /v1/claw/instances/:id
傳回特定實例的詳細資訊。

​
更新實例

PATCH /v1/claw/instances/:id
更新實例配置。
​
defaultModel
string | null
更改預設 AI 模型
​
imConfig
object | null
更新 IM 平台配置（Telegram, Discord 等）
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"}'

​
重建實例

POST /v1/claw/instances/:id/rebuild
在保留數據 (PVC) 的情況下銷毀並重新建立容器。限制為每天 10 次重建。 如果超過每日限制，將傳回 429 Too Many Requests。

​
續訂實例

POST /v1/claw/instances/:id/renew
延長計費週期 30 天 ($20)。如果實例因過期而停止，它將自動重新啟動。 
{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "status": "RUNNING",
  "paidUntil": "2026-04-09T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}

​
健康檢查

GET /v1/claw/health
傳回 Claw 服務健康狀態。無需身分驗證。 
{"status": "ok", "timestamp": "2026-02-08T15:00:00.000Z"}