Task Dispatch

Automated task scheduling and execution for task management systems.

Quick Start

用户说"设置任务调度"或"部署 ClawBoard"时，按以下流程引导：

Step 1: 检测环境

# 检查 Node.js
node --version  # 需要 >= 18

# 检查 ClawBoard 是否已安装
ls -la ~/ClawBoard 2>/dev/null || echo "ClawBoard not installed"

Step 2: 部署 ClawBoard（如未安装）

# 克隆仓库
git clone https://github.com/CCCaptain0129/ClawBoard.git ~/ClawBoard
cd ~/ClawBoard

# 安装依赖并初始化
./clawboard install

# 生成访问 token（自动保存到 .env）
./clawboard token --generate

Step 3: 启动服务

cd ~/ClawBoard
./clawboard start

# 检查状态
./clawboard status

Step 4: 配置 Agent 环境

在 Agent 工作目录创建 .env 文件：

# 获取 token
TOKEN=$(cat ~/ClawBoard/.env | grep BOARD_ACCESS_TOKEN | cut -d= -f2)

# 写入 Agent 工作目录
echo "TASKBOARD_API_URL=http://127.0.0.1:3000" >> ~/.openclaw/workspace-<name>/.env
echo "TASKBOARD_ACCESS_TOKEN=$TOKEN" >> ~/.openclaw/workspace-<name>/.env

Step 5: 打开看板

前端看板: http://127.0.0.1:5173
后端 API: http://127.0.0.1:3000
输入 .env 中的 BOARD_ACCESS_TOKEN 登录

Step 6: 设置定时调度（可选）

用户说"设置定时调度"时：

{
  "name": "ClawBoard 调度巡检",
  "schedule": { "kind": "every", "everyMs": 300000 },
  "payload": {
    "kind": "agentTurn",
    "message": "执行 task-dispatch 调度检查。无任务时返回 HEARTBEAT_OK。"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "none" }
}

Agent Role

You are a dispatcher, not an executor.

Your job: plan, dispatch, verify, update status
NOT your job: implement tasks yourself
Task execution: delegated to subagents
You verify results and update task status

Data Source of Truth

What	Source
Task data	API endpoint (e.g., `http://127.0.0.1:3000/api/tasks/...`)
Task files	`tasks/*.json` (written by API)
Project docs	`projects/<project-name>/docs/`
NOT source of truth	Frontend dashboard (view only)

ClawBoard Deployment Guide

Prerequisites

Node.js >= 18
Git
PM2 (auto-installed by ./clawboard install)

Installation Commands

Command	Description
`./clawboard install`	Install dependencies, create .env
`./clawboard start`	Start frontend + backend services
`./clawboard stop`	Stop all services
`./clawboard status`	Check service health
`./clawboard token`	Show current access token
`./clawboard token --generate`	Generate new token

Verification Checklist

After deployment, verify:

✅ Backend API responds: curl http://127.0.0.1:3000/health
✅ Frontend loads: open http://127.0.0.1:5173
✅ Token works: curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:3000/api/tasks/projects
✅ Agent .env configured with token

task-dispatch

Install via CLI (Recommended)