clawdbot-dingtalk 0.4.3 → 0.4.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawdbot-dingtalk",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "DingTalk (钉钉) channel plugin for Openclaw - enables AI agent messaging via DingTalk Stream API",
   "type": "module",
   "main": "./dist/index.js",

package/skills/dingtalk-cron-job/SKILL.md

@@ -49,15 +49,14 @@ openclaw cron add \
 只允许使用以下命令做验证/排障，禁止自造变体：
 
 ```bash
-openclaw cron run <job-id> --force --expect-final
 openclaw cron runs --id <job-id> --limit 5
 openclaw cron rm <job-id>
+openclaw cron list
 ```
 
 说明：
-- `cron run` 只接受位置参数 `<job-id>`，不要写 `--id`
 - `cron runs` 必须写 `--id`
-- `--expect-final` 用于等待最终回复，避免"看起来成功但无最终输出"
+- **严禁对一次性 `--at` 任务执行 `openclaw cron run`**：该命令会触发 `deleteAfterRun`，导致任务在定时时间到达前被删除，实际定时消息将永远不会发出
 
 ## 群聊提醒（本群/提醒所有人）
 
@@ -177,33 +176,28 @@ openclaw cron add \
 - [ ] 全局 `cron.enabled` 未被关闭，且未设置 `OPENCLAW_SKIP_CRON=1`
 - [ ] `--channel` 是 `clawdbot-dingtalk`
 - [ ] `--to` 是正确的 senderStaffId
+- [ ] **不要对一次性 `--at` 任务执行 `cron run` 测试**（会导致任务被提前删除）
 
-## 创建后最小验收（必须执行）
-
-创建任务成功后，必须立刻做两步验收：
+## 创建后确认（必须执行）
 
-1. 强制触发一次并等待最终输出
+创建任务成功后，告知用户任务已创建，并说明预计触发时间。
 
-```bash
-openclaw cron run <job-id> --force --expect-final
-```
+**严禁对一次性 `--at` 任务执行 `openclaw cron run`。** 该命令会立即执行任务并触发 `deleteAfterRun`，导致任务在定时时间到达前被删除。这是已知 bug，实际定时消息将永远不会发出。
 
-2. 查看最近运行记录（确认 run log 已写入）
+如需验证任务是否已正确注册，只允许使用：
 
 ```bash
 openclaw cron runs --id <job-id> --limit 5
 ```
 
-若两步任一步失败，不要宣称"已稳定定时发送"。必须明确告知用户当前仅完成"任务创建"，调度执行仍待确认。
+对于**循环任务**（`--cron`），可以使用 `openclaw cron run <job-id> --force --expect-final` 来测试，因为循环任务不会被删除。
 
 ## 失败告警模板（固定句式）
 
-当最小验收失败时，直接使用类似以下文案：
+当任务创建失败或参数不合法时，直接使用类似以下文案：
 
-> 已完成任务创建，但本次强制触发/运行记录校验未通过。
-> 这通常表示调度器尚未实际执行。
-> 我已给出可复现命令：`openclaw cron run <job-id> --force --expect-final` 和 `openclaw cron runs --id <job-id> --limit 5`。
-> 在看到有效 run 记录前，不应视为"已稳定定时发送"。
+> 定时任务创建失败。请检查时间格式是否正确，以及 `--channel` 和 `--to` 参数是否正确。
+> 可用 `openclaw cron list` 确认当前任务列表。
 
 ## 调试命令（仅限白名单）
 
@@ -211,12 +205,12 @@ openclaw cron runs --id <job-id> --limit 5
 # 查看所有任务
 openclaw cron list
 
-# 立即测试任务（强制 + 等待 final）
-openclaw cron run <job-id> --force --expect-final
-
 # 查看运行记录
 openclaw cron runs --id <job-id> --limit 5
 
 # 删除任务
 openclaw cron rm <job-id>
+
+# 仅限循环任务（--cron）的测试，严禁用于一次性 --at 任务
+openclaw cron run <job-id> --force --expect-final
 ```

package/workspace-templates/AGENTS.md

@@ -84,6 +84,10 @@ Skills 提供你的工具。需要时查看对应的 `SKILL.md`。把本地特
 - 消息有字数限制 —— 保持简洁，不要写长篇大论
 - 需要长内容时，分段发送或使用要点概括
 
+## 定时任务 (Cron)
+
+**严禁测试一次性定时任务：** 使用 cron 工具 `action: "add"` 创建任务后，**绝对不要**立即调用 `action: "run"` 来测试。`cron run` 会触发 `deleteAfterRun`，导致一次性任务在定时时间到达之前就被删除，实际的定时消息将永远不会发出。只需确认任务已创建，告诉用户它会在预定时间执行即可。
+
 ## Heartbeat - 主动出击
 
 收到 heartbeat 轮询时，不要每次都只回复 `HEARTBEAT_OK`。利用 heartbeat 做有意义的事。