openclaw-taskboard

---
name: openclaw-taskboard
description: 使用 OpenClaw 任務板管理任務、審核、自動化與進化紀錄。當使用者說「建立任務」「新增任務」「執行任務」「任務列表」「批准審核」或「/stop」「緊急終止」等，透過 API 寫入並操作任務板。需設定 OPENCLAW_TASKBOARD_URL。
---

# OpenClaw 任務板 Skill

## 觸發句型

- **建立／新增任務**：「建立任務」「新增任務」「加一個任務」「幫我記一個任務」「Create task」「Add task」或明確描述要做的事。
- **列出任務**：「任務列表」「有什麼任務」「任務狀態」「查看任務」。
- **執行任務**：「執行任務」「跑任務」「執行下一個」「run task」「run next」或指定任務 ID（如「執行任務 t3」）。
- **審核**：「批准審核」「駁回審核」「待審核項目」。
- **刪除任務**：「刪除任務 xxx」。
- **🛑 緊急終止**：「/stop」「/stop all」「停止」「緊急終止」「停止所有任務」→ 立即終止執行中的任務（詳見 EMERGENCY-MECHANISM.md）。

## API Base

從環境變數 `OPENCLAW_TASKBOARD_URL` 讀取，例：本機 `http://localhost:3011`，正式 `https://你的網域`。**務必指向可快速連到的後端**，否則 Telegram 回應會變慢。寫入時依後端設定帶 `x-api-key`。

## 常用端點（精簡）

| 操作 | 方法 | 路徑 |
|------|------|------|
| 列出任務 | GET | `{base}/api/openclaw/tasks` |
| 建立任務 | POST | `{base}/api/openclaw/tasks` |
| 更新任務 | PATCH | `{base}/api/openclaw/tasks/:id` |
| 刪除任務 | DELETE | `{base}/api/openclaw/tasks/:id` |
| 執行任務 | POST | `{base}/api/openclaw/tasks/:id/run` |
| 執行下一個 | POST | `{base}/api/openclaw/run-next` |
| 審核列表 | GET | `{base}/api/openclaw/reviews` |
| 進化紀錄 | GET | `{base}/api/openclaw/evolution-log` |
| **🛑 緊急終止** | | |
| 查看執行中 | GET | `{base}/api/emergency/running` |
| 終止所有 | POST | `{base}/api/emergency/stop-all` |
| 終止指定任務 | POST | `{base}/api/emergency/stop/:taskId` |
| /stop 指令 | POST | `{base}/api/emergency/stop-command` Body: `{ args: [] }` |

**建立任務 Body（JSON）**：`name` 或 `title`、`tags`（如 `["learn"]`）、`status`（如 `"ready"`）、可選 `subs`（`[{t:"子任務",d:false}]`）。

## 深入規格（Progressive disclosure）

- **完整 API 與同步關係**：見 [references/api.md](references/api.md)。
- **Supabase 表結構**：見 [references/schema.md](references/schema.md)。
- **模組邊界與程式碼對照**：見 [references/modules.md](references/modules.md)。

## 實作方式

使用 `fetch` 或 `curl` 呼叫上述 API，Content-Type: application/json。回應：建立成功回覆「已建立任務：{title}」；執行成功回覆「已觸發執行任務 {id}」；列表則簡要列出標題與狀態。

### 緊急終止 /stop 實作

當使用者說「/stop」「/stop all」「停止」等：

1. 若有指定 taskId（如「/stop t3」）→ `POST {base}/api/emergency/stop/{taskId}`，Body 可選 `{ reason: "用戶指定" }`
2. 否則（全部終止）→ `POST {base}/api/emergency/stop-all`
3. 或統一用 `POST {base}/api/emergency/stop-command`，Body: `{ args: ["all"] }` 或 `{ args: ["t3"] }`

回覆範例：「已終止 2 個任務」或「任務 t3 已終止」；若無執行中則「目前沒有執行中的任務」。