SayClaw 后台管理系统，管理所有 OC 实例、服务器、用户、LLM 密钥、模板和任务。
最后更新：2026-03-09
技术栈
- 语言：Go 1.22
- 框架：Gin
- 数据库：MySQL（
sayclaw_admin）
- 端口：8081
- 部署：systemd（
sayclaw-admin-api.service）
- 服务器：ai-jp-1（35.243.76.69）
模块一览
API 总览（68 个端点）
认证（4）
| 方法 | 路径 | 说明 |
|---|
| POST | /api/v1/auth/login | 密码登录 |
| GET | /api/v1/auth/google | Google OAuth 跳转 |
| GET | /api/v1/auth/google/callback | Google OAuth 回调 |
| GET | /api/v1/auth/me | 当前登录信息 |
管理员账号（4）
| 方法 | 路径 | 说明 |
|---|
| GET | /admin-users | 列表 |
| POST | /admin-users | 创建 |
| PATCH | /admin-users/:email | 更新 |
| DELETE | /admin-users/:email | 删除 |
Portal 用户（5）
| 方法 | 路径 | 说明 |
|---|
| GET | /users | 用户列表 |
| POST | /users | 创建用户 |
| PATCH | /users/:id | 更新用户 |
| DELETE | /users/:id | 删除用户 |
| POST | /users/:id/assign-instance | 分配实例 |
实例管理（11）
| 方法 | 路径 | 说明 |
|---|
| GET | /instances | 实例列表 |
| GET | /instances/:id | 实例详情 |
| POST | /oc-instances | 创建实例 |
| PATCH | /oc-instances/:id | 更新实例 |
| DELETE | /oc-instances/:id | 删除实例 |
| PATCH | /instances/:id/assign | 分配用户 |
| PATCH | /instances/:id/config | 更新配置 |
| GET | /instances/:id/chat-bindings | 聊天绑定列表 |
| POST | /instances/:id/chat-bindings | 添加绑定 |
| DELETE | /instances/:id/chat-bindings/:bid | 删除绑定 |
| GET | /instances/health-check | 健康检查 |
Telegram（2）
| 方法 | 路径 | 说明 |
|---|
| POST | /instances/:id/configure-telegram | 配置 TG Bot |
| GET | /instances/:id/telegram-status | TG 状态 |
LLM 主 Key（4）
| 方法 | 路径 | 说明 |
|---|
| GET | /master-keys | 主 Key 列表 |
| POST | /master-keys | 创建主 Key |
| PUT | /master-keys/:id | 更新主 Key |
| DELETE | /master-keys/:id | 删除主 Key |
LLM 子 Key（5）
| 方法 | 路径 | 说明 |
|---|
| GET | /instance-keys | 全局子 Key 列表 |
| GET | /instances/:id/keys | 实例子 Key 列表 |
| POST | /instances/:id/keys | 创建子 Key |
| PUT | /instances/:id/keys/:kid | 更新子 Key |
| DELETE | /instances/:id/keys/:kid | 停用子 Key |
LLM 同步 & 日志（4）
| 方法 | 路径 | 说明 |
|---|
| POST | /instances/:id/sync-models | 同步模型列表 |
| POST | /instances/:id/sync-key | 同步子 Key |
| GET | /llm-logs | 请求日志 |
| GET | /llm-stats | 费用统计 |
实例模板（5）
| 方法 | 路径 | 说明 |
|---|
| GET | /instance-templates | 模板列表 |
| GET | /instance-templates/:id | 模板详情 |
| POST | /instance-templates | 创建模板 |
| PUT | /instance-templates/:id | 更新模板 |
| POST | /instance-templates/sync/:instanceId | 同步到实例 |
服务器（6）
| 方法 | 路径 | 说明 |
|---|
| GET | /servers | 服务器列表 |
| GET | /servers/:id/detail | 服务器详情 |
| GET | /servers/:id/stats | 服务器指标 |
| POST | /servers | 创建 |
| PATCH | /servers/:id | 更新 |
| DELETE | /servers/:id | 删除 |
容器（2）
| 方法 | 路径 | 说明 |
|---|
| GET | /servers/:id/containers | 容器列表 |
| POST | /servers/:id/containers/:cid/:action | 容器操作 |
任务 & 监控（6）
| 方法 | 路径 | 说明 |
|---|
| GET | /job-runs | 定时任务日志 |
| GET | /task-queue | 任务队列 |
| POST | /task-queue/:id/retry | 重试任务 |
| GET | /server-metrics/:id | 服务器指标 |
| GET | /usage-daily | 日用量 |
| GET | /tasks | 管理任务列表 |
数据库
- Admin DB：
sayclaw_admin（27 张表）
- Portal DB：
sayclaw_portal（6 张表）
- One API DB：MySQL
oneapi（One API 自管理）
详见各模块文档中的表结构定义。