openclaw-api-reference（OpenClaw API reference 文档）

OpenClaw API 参考

完整的 API 文档和示例。

基础 URL

http://localhost:3000/api/v1

认证

API Key

curl -H "Authorization: Bearer YOUR_API_KEY" \
  http://localhost:3000/api/v1/chat

JWT

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:3000/api/v1/chat

聊天 API

发送消息

POST /api/v1/chat

{
  "message": "你好",
  "session_id": "optional-session-id",
  "model": "deepseek-chat"
}

响应：

{
  "response": "你好！有什么可以帮你的？",
  "session_id": "abc123",
  "tokens": {
    "input": 5,
    "output": 10
  }
}

流式响应

POST /api/v1/chat/stream

{
  "message": "写一首诗"
}

响应（SSE）：

data: {"text": "春"}
data: {"text": "眠"}
data: {"text": "不"}
data: {"text": "觉"}
data: {"text": "晓"}
data: [DONE]

会话 API

创建会话

POST /api/v1/sessions

{
  "name": "我的会话",
  "model": "deepseek-chat"
}

获取会话

GET /api/v1/sessions/:id

列出会话

GET /api/v1/sessions

删除会话

DELETE /api/v1/sessions/:id

消息 API

获取消息历史

GET /api/v1/sessions/:id/messages

# 参数
?limit=50
&offset=0
&order=desc

删除消息

DELETE /api/v1/messages/:id

Skills API

列出 Skills

GET /api/v1/skills

执行 Skill

POST /api/v1/skills/:name/run

{
  "params": {
    "key": "value"
  }
}

创建 Skill

POST /api/v1/skills

{
  "name": "my-skill",
  "description": "描述",
  "script": "echo 'hello'"
}

配置 API

获取配置

GET /api/v1/config

更新配置

PATCH /api/v1/config

{
  "model": "gpt-4o",
  "temperature": 0.7
}

用户 API

创建用户

POST /api/v1/users

{
  "email": "user@example.com",
  "password": "secure-password"
}

获取用户

GET /api/v1/users/:id

更新用户

PATCH /api/v1/users/:id

{
  "name": "新名字"
}

Webhook API

创建 Webhook

POST /api/v1/webhooks

{
  "url": "https://your-server.com/webhook",
  "events": ["message.created", "session.created"]
}

测试 Webhook

POST /api/v1/webhooks/:id/test

错误处理

错误格式

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is invalid",
    "details": {}
  }
}

常见错误码

SDK

JavaScript/TypeScript

npm install openclaw-sdk

import { OpenClaw } from 'openclaw-sdk';

const client = new OpenClaw({
  apiKey: 'your-api-key'
});

const response = await client.chat({
  message: '你好'
});

Python

pip install openclaw

from openclaw import OpenClaw

client = OpenClaw(api_key='your-api-key')

response = client.chat(message='你好')

需要帮助？

• API 集成：¥99
• SDK 开发：¥299
• 企业支持：¥999

联系：微信 yang1002378395 或 Telegram @yangster151

创建：2026-03-14