认证
所有 API 请求需要在 Header 中携带 API Key：
Authorization: Bearer YOUR_API_KEY消息 API
POST
/api/v1/messages发送消息给 ClawBot 并获取回复。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
content | string | 是 | 消息内容 |
channel | string | 否 | 通讯渠道 (telegram/wechat/discord) |
context_id | string | 否 | 对话上下文 ID |
响应示例
{
"id": "msg_abc123",
"content": "好的，我来帮你查询今天北京的天气...",
"tools_used": ["weather.get_weather"],
"tokens_used": 1250,
"created_at": "2026-02-10T10:30:00Z"
}技能 API
GET
/api/v1/skills获取已安装的技能列表。
POST
/api/v1/skills/install安装新技能。
DELETE
/api/v1/skills/:name卸载指定技能。
记忆 API
GET
/api/v1/memory/search?q=关键词搜索 ClawBot 的长期记忆。
POST
/api/v1/memory手动写入一条记忆。
任务 API
GET
/api/v1/tasks获取定时任务列表。
POST
/api/v1/tasks创建新的定时任务（Cron）。
Webhooks
ClawBot 支持 Webhook 回调，当特定事件发生时通知你的服务：
POST /api/v1/webhooks
{
"url": "https://your-server.com/callback",
"events": ["message.received", "task.completed", "skill.error"]
}