定时任务管理

使用 copaw cron 命令管理定时任务。

常用命令

# 列出所有任务
copaw cron list

# 查看任务详情
copaw cron get <job_id>

# 查看任务状态
copaw cron state <job_id>

# 删除任务
copaw cron delete <job_id>

# 暂停/恢复任务
copaw cron pause <job_id>
copaw cron resume <job_id>

# 立即执行一次
copaw cron run <job_id>

创建任务

支持两种任务类型：

• text：定时向频道发送固定消息
• agent：定时向 Agent 提问并发送回复到频道

快速创建

# 每天 9:00 发送文本消息
copaw cron create \
  --type text \
  --name "每日早安" \
  --cron "0 9 * * *" \
  --channel imessage \
  --target-user "CHANGEME" \
  --target-session "CHANGEME" \
  --text "早上好！"

# 每 2 小时向 Agent 提问
copaw cron create \
  --type agent \
  --name "检查待办" \
  --cron "0 */2 * * *" \
  --channel dingtalk \
  --target-user "CHANGEME" \
  --target-session "CHANGEME" \
  --text "我有什么待办事项？"

必填参数

创建任务需要：

• --type：任务类型（text 或 agent）
• --name：任务名称
• --cron：cron 表达式（UTC 时间，如用户在 UTC+8 希望每天 9:00 执行，需填 "0 1 * * *"）
• --channel：目标频道（imessage / discord / dingtalk / qq / console）
• --target-user：用户标识
• --target-session：会话标识
• --text：消息内容（text 类型）或提问内容（agent 类型）

从 JSON 创建（复杂配置）

copaw cron create -f job_spec.json

Cron 表达式示例

重要：--cron 参数中的时间为 UTC 时间。 用户描述的时间默认为其所在时区的本地时间，创建定时任务前必须先将其换算为 UTC 时间后再填写。 例如：用户在 UTC+8 时区，说"每天早上 9:00 执行"，需填写 0 1 * * *（UTC 01:00 = 本地 09:00）。

0 9 * * *      # 每天 UTC 9:00（UTC+8 用户的 17:00，UTC-5 用户的 4:00）
0 */2 * * *    # 每 2 小时（与时区无关）
30 8 * * 1-5   # UTC 工作日 8:30（UTC+9 用户的 17:30）
0 0 * * 0      # UTC 每周日零点（UTC+1 用户的周日 1:00）
*/15 * * * *   # 每 15 分钟（与时区无关）

使用建议

• 缺少参数时，询问用户补充后再创建
• 暂停/删除/恢复前，用 copaw cron list 查找 job_id
• 排查问题时，用 copaw cron state <job_id> 查看状态
• 给用户的命令要完整、可直接复制执行