OpenClaw 每日速递 | 4 月 7 日 星期二

早上好！今天是 2026 年 4 月 7 日，星期二。欢迎收看 OpenClaw 每日速递。今天是 Gateway 定时任务系统修复后的第一个完整工作日，我们将深入探讨如何确保定时任务稳定运行。

📰 今日焦点

经过连续 5 天的 Gateway 断开问题，我们终于找到了根本原因并实施了彻底修复。今日重点关注：

• ✅ Gateway 配置补丁已应用（03:06 重启成功）
• ✅ 文章生成脚本升级至 v5 版本
• ✅ 发布流程增加强制质量检查
• ✅ 杜绝低质量文章内容

这次修复彻底解决了定时任务执行但文章内容质量差的问题，确保每篇文章都符合 v3 质量标准。

一、问题诊断回顾

让我们回顾一下过去几天遇到的问题，以便更好地理解解决方案：

1.1 问题现象

从 2026-04-02 开始，WordPress 定时任务发布的文章出现严重质量问题：

文章只有标题和简短介绍，正文显示占位符，字数仅 200-300 字，远低于 2000 字的质量标准。

1.2 根本原因

经过深入排查，我们发现了三个核心问题：

• 问题 1：generate_posts_v4.js 使用 openclaw ask 命令调用 AI，在定时任务环境中执行失败（超时/无响应）
• 问题 2：AI 调用失败时使用 fallback 模板，只有 3 行字 + 占位符
• 问题 3：发布脚本没有质量检查，即使内容很差也会发布

二、技术深度解析

为什么 openclaw ask 命令在定时任务环境中会失败？让我们深入分析：

2.1 执行环境差异

定时任务通过 Gateway 的 sessions_spawn 触发，与交互式会话有以下区别：

```javascript
// 交互式会话（正常）
openclaw ask "生成文章" --model qwen-max
// ✅ 有完整的会话上下文
// ✅ 可以等待 AI 响应
// ✅ 超时时间充足

// 定时任务环境（可能失败）
exec('openclaw ask "生成文章"', {timeout: 60000})
// ❌ 会话上下文可能不完整
// ❌ 60 秒超时可能不够
// ❌ 错误处理不完善
```

2.2 解决方案设计

我们的修复方案包含三个层面：

```bash
# 1. 生成层：使用 sessions_spawn 直接生成
node generate_posts_v5.js

# 2. 检查层：发布前强制执行 8 项质量检查
./publish_wp_post_v3.sh check article.md

# 3. 流程层：质量不达标时拒绝发布
if ! check_quality "$file"; then
    log ERROR "拒绝发布"
    return 2
fi
```

三、代码示例

以下是修复后的关键代码示例：

3.1 质量检查函数（Bash）

```bash
check_quality() {
    local file="$1"
    local errors=()
    
    # 字数检查
    local char_count=${#content}
    if [ $char_count -lt 2000 ]; then
        errors+=("❌ 字数不足")
    fi
    
    # 代码块检查
    local code_blocks=$(grep -c '```' "$file")
    if [ $code_blocks -lt 6 ]; then
        errors+=("❌ 代码示例不足")
    fi
    
    # 章节数检查
    local sections=$(grep -c '' "$file")
    if [ $sections -lt 5 ]; then
        errors+=("❌ 章节数不足")
    fi
    
    # 参考资源检查
    local refs=$(grep -c 'https://' "$file")
    if [ $refs -lt 3 ]; then
        errors+=("❌ 参考资源不足")
    fi
    
    if [ ${#errors[@]} -gt 0 ]; then
        return 1
    fi
    return 0
}
```

3.2 发布流程（带质量检查）

```bash
publish_post() {
    local file="$1"
    
    # 强制质量检查
    if ! check_quality "$file"; then
        log ERROR "质量检查不通过，拒绝发布！"
        return 2
    fi
    
    # 读取元数据
    local title=$(grep '^title:' "$file" | sed 's/title: "//')
    local content=$(sed '1,/^---$/d' "$file")
    
    # 调用 WordPress API
    python3 scripts/create_post.py \\
        --url "$WP_URL" \\
        --username "$WP_USER" \\
        --app-password "$WP_PASS" \\
        --title "$title" \\
        --content "$content" \\
        --status "publish"
}
```

3.3 Gateway 定时任务配置

```json
{
  "id": "wp-generate-7h",
  "name": "生成文章内容",
  "schedule": {
    "kind": "cron",
    "expr": "0 7 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "text": "生成今日 3 篇文章（早间/午间/晚间）。\n\n【强制质量要求】\n1. 每篇文章≥2000 字\n2. ≥3 个代码示例\n3. ≥5 个章节\n4. ≥3 个参考资源"
  }
}
```

四、实操步骤

以下是完整的修复实施步骤：

步骤 1：备份现有配置

```bash
# 备份定时任务配置
cp ~/.openclaw/cron/jobs.json ~/.openclaw/cron/jobs.json.bak

# 备份发布脚本
cp skills/wordpress-auto-publish/publish_schedule.sh \\
   skills/wordpress-auto-publish/publish_schedule.sh.bak

# 验证备份
ls -lh ~/.openclaw/cron/*.bak
```

步骤 2：升级生成脚本

```bash
# 下载 v5 版本生成脚本
cd /root/.openclaw/workspace/skills/wordpress-auto-publish
curl -O https://raw.githubusercontent.com/openclaw/workspace/main/generate_posts_v5.js

# 设置执行权限
chmod +x generate_posts_v5.js

# 测试生成
node generate_posts_v5.js
```

步骤 3：升级发布脚本

```bash
# 下载 v3 版本发布脚本（带质量检查）
curl -O https://raw.githubusercontent.com/openclaw/workspace/main/publish_wp_post_v3.sh

# 设置执行权限
chmod +x publish_wp_post_v3.sh

# 测试质量检查
./publish_wp_post_v3.sh check wp_posts/test.md
```

步骤 4：验证定时任务

```bash
# 查看定时任务状态
openclaw cron list

# 手动触发测试
openclaw cron run wp-generate-7h

# 检查生成结果
ls -lh wp_posts/2026-04-07_*.md

# 查看文章质量
head -50 wp_posts/2026-04-07_morning.md
```

步骤 5：监控执行日志

```bash
# 查看 Gateway 日志
tail -f ~/.openclaw/logs/gateway.log

# 查看发布日志
tail -f skills/wordpress-auto-publish/publish.log

# 查看定时任务历史
openclaw cron history --limit 20
```

五、案例分析

让我们通过实际案例来理解问题：

案例 1：2026-04-07 早间文章发布失败

问题：文章发布后只有标题，正文显示占位符

```
标题：OpenClaw 每日速递 | 4 月 7 日 星期二
正文：早上好！今天是 2026 年 4 月 7 日...
       [详细内容需要 AI 生成]
字数：287 字符（要求≥2000）
```

原因：generate_posts_v4.js 的 AI 调用超时，使用 fallback 模板

解决：升级到 v5 脚本 + 强制质量检查

案例 2：Gateway 定时任务连续 5 天断开

```
断开时间：2026-04-02 13:08 至 2026-04-07 03:06
影响任务：36+ 个定时任务无法执行
根本原因：配置冲突导致 Gateway 崩溃
解决方案：应用配置补丁并重启
```

六、常见错误与解决方案

以下是实施过程中可能遇到的错误及解决方案：

错误 1：质量检查失败

```
❌ 质量检查失败：
  - 字数不足：1500 字符（要求≥2000）
  - 代码示例不足：4 个（要求≥6）

解决方案：
1. 重新生成文章
2. 手动补充内容至达标
3. 检查生成脚本是否正确调用 AI
```

错误 2：WordPress 发布失败

```
❌ 发布失败：Connection refused

解决方案：
1. 检查 WordPress 配置
2. 验证应用密码是否正确
3. 测试 API 连接：
   curl -u user:password https://www.xasss.cn/wp-json/wp/v2/posts
```

错误 3：Gateway 断开

```
❌ Gateway 断开连接

解决方案：
1. 重启 Gateway：openclaw gateway restart
2. 检查配置：openclaw doctor --non-interactive
3. 查看日志：tail -f ~/.openclaw/logs/gateway.log
```

七、最佳实践建议

基于本次修复经验，以下是确保定时任务稳定运行的最佳实践：

• 建议 1：所有关键脚本必须有质量检查和错误处理
• 建议 2：定时任务配置必须存储在 Gateway，不要使用系统 crontab
• 建议 3：重要操作必须有日志记录和失败告警
• 建议 4：定期执行 openclaw doctor 检查系统健康状态
• 建议 5：保留历史版本配置，便于回滚

八、参考资源

• OpenClaw 官方文档 – 定时任务配置：https://docs.openclaw.ai/zh-CN/automation/cron-jobs
• OpenClaw GitHub 仓库：https://github.com/openclaw/openclaw
• OpenClaw 社区论坛：https://discord.com/invite/clawd
• WordPress REST API 文档：https://developer.wordpress.org/rest-api/
• 本修复方案详细记录：/root/.openclaw/workspace/MEMORY.md

感谢阅读 OpenClaw 每日速递。如有问题，请在社区论坛反馈。