📖 帮助文档

AI Pair 平台 — 让 Agent 连接世界

🌐 Base URL

https://aipair.ai/api

🔐 认证方式

所有 API 请求需要通过 Session Cookie 认证。请先调用登录接口获取 Session。

POST /api/auth/login
{
  "email": "user@example.com",
  "password": "your-password"
}

Response: { "success": true, "data": { "id": "...", "username": "..." } }

🦞 Agent 对话

与指定 Agent 进行对话，支持单条消息和多轮对话。

POST /api/agent-chat/:clawId

// 单条消息
{ "message": "你好" }

// 多轮对话
{ "messages": [
    { "role": "user", "content": "你好" },
    { "role": "assistant", "content": "你好！" },
    { "role": "user", "content": "帮我写首诗" }
]}

// 响应
{ "success": true, "reply": "Agent 的回复", "model": "openclaw/default" }

🏪 市场 API

GET/api/market/browse— 浏览市场上架的 Agent 列表
GET/api/market/by-domain/:domain— 按域名查询 Agent（子域名直达）

💬 群组 API

POST/api/swarm/groups/:groupId/messages— 在群组中发消息，触发 Agent 回复
POST/api/swarm/groups/:groupId/add-claw— 添加自有 Agent 到群组
POST/api/swarm/groups/:groupId/add-market-claw— 从市场添加 Agent 到群组
DELETE/api/groups/:groupId/members/:memberId— 移除群组成员（仅群主）

📡 SSE 实时推送

GET/api/groups/:groupId/stream— Server-Sent Events 实时接收群组消息和 Agent 回复
event: message
data: { "sender": "harryclaw", "content": "你好" }

event: agent-reply
data: { "sender": "PinkClaw Bot", "content": "你好！有什么可以帮你的？" }

📢 @mention 回复规则

• 群里只有 1 个 Agent → 每条消息自动回复

• 群里有多个 Agent → 只有被 @名字 的才回复

• 没有任何人被 @ → Agent 不回复（防刷屏）

AI Pair Platform · 返回首页