clawdesk-api

分类: 开发与编程 | 上传者: glassrun | 下载: 0 | 版本: v1.0（最新）

ClawDesk API 集成，用于管理代理、项目和任务。在与 http://localhost:3777 的 ClawDesk 后端交互时使用，以实现 (1) 列出/创建/更新/删除代理，(2) 管理项目和任务，(3) 在代理上运行任务，(4) 从 OpenClaw 同步代理，(5) 查看系统统计信息和仪表板。

更新日志: Source: GitHub https://github.com/glassrun/clawdesk

目录结构

当前层级: tree/main/skills/

📁 references/
- 📄 endpoints.md 3.9 KB
📄 SKILL.md 1.9 KB

SKILL.md

---
name: clawdesk-api
description: ClawDesk API integration for managing agents, projects, and tasks. Use when interacting with ClawDesk backend at http://localhost:3777 for (1) Listing/creating/updating/deleting agents, (2) Managing projects and tasks, (3) Running tasks on agents, (4) Syncing agents from OpenClaw, (5) Viewing system stats and dashboard.
---

# ClawDesk API Skill

Base URL: `http://localhost:3777`

## Quick Reference

| Resource | Endpoints |
|----------|----------|
| Health | `GET /health` |
| Agents | `GET/POST /api/agents`, `GET/PUT/DELETE /api/agents/:id` |
| Projects | `GET/POST /api/projects`, `GET/PUT/DELETE /api/projects/:id` |
| Tasks | `GET /api/tasks`, `GET/PUT/DELETE /api/tasks/:id` |
| Run | `POST /api/tasks/:id/run` |
| Assign | `POST /api/tasks/:id/assign` |

## Authentication

No authentication required for local development.

## Common Workflows

### List all agents
```bash
curl http://localhost:3777/api/agents
```

### Sync agents from OpenClaw
```bash
curl -X POST http://localhost:3777/api/agents/sync
```

### Create a task
```bash
curl -X POST http://localhost:3777/api/projects/:id/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"Task name","priority":"high"}'
```

### Assign task to agent
```bash
curl -X PUT http://localhost:3777/api/tasks/:id \
  -H "Content-Type: application/json" \
  -d '{"assigned_agent_id":"main"}'
```

### Run task on agent
```bash
curl -X POST http://localhost:3777/api/tasks/:id/run
```

## Task Filters

Use query params: `?status`, `?priority`, `?agent_id`, `?project_id`, `?search`, `?page`, `?limit`

```bash
curl "http://localhost:3777/api/tasks?status=pending&priority=high"
```

## Notes

- Agent IDs are strings: `"main"`, `"project-manager"`, etc.
- Task IDs are numbers: `1776619252186`
- Project IDs are numbers: `1776619182108`

For detailed endpoint documentation, see [ENDPOINTS.md](references/endpoints.md).

登录后下载/点赞/收藏 ❤ 5 | ★ 0

clawdesk-api

目录结构

SKILL.md

举报内容

提示