【应用实战】OpenClaw开发小助手

// 生成 cron 参数qqbot_remind({  action: "add",  content: "今日任务汇总",  time: "0 9 * * *"  // 每天早上 9 点执行})// 返回结构示例：// { expr: "0 9 * * *", tz: "Asia/Shanghai", nextRun: "..." }

cron({  action: "add",  job: {    name: "每日任务汇总",    schedule: {      kind: "cron",      expr: "0 9 * * *",      tz: "Asia/Shanghai"    },    // 关键配置：isolated 模式确保不干扰当前对话    sessionTarget: "isolated",    // wakeMode: now 表示如果添加时错过了时间，立即补执行一次    wakeMode: "now",    payload: {      kind: "agentTurn",      message: "【每日任务汇总】请检查今日任务列表，确认优先级与阻塞项...",      deliver: true,      channel: "qqbot",      to: "{用户 openid}"  // 替换为实际用户 openid    }  }})

cron({  action: "add",  job: {    name: "PR 审查提醒",    schedule: {      kind: "cron",      expr: "0 10 * * 1-5",  // 工作日（周一至周五）早上 10 点      tz: "Asia/Shanghai"    },    sessionTarget: "isolated",    payload: {      kind: "agentTurn",      // 使用模板变量，Agent 执行时会动态替换 {n}      message: "【PR 审查】今日有 {n} 个待审查的 PR，请查看...",      deliver: true,      channel: "qqbot",      to: "{用户 openid}"    }  }})

{  "integrations": {    "github": {      "webhook_secret": "ghp_xxx_2026",  // 与 GitHub 配置的 Secret 一致      "enabled_events": ["push", "pull_request", "issues"],      "default_channel_id": "your-channel-id"  // 默认投递频道    }  }}

// 事件处理函数示例function handleGitHubEvent(event) {  const emojiMap = {    push: "🚀",    pull_request: "🔀",    issues: "🐛"  };  const icon = emojiMap[event.type] || "📢";  return qqbot_channel_api({    method: "POST",    path: `/channels/{icon} **GitHub 事件通知**\n` +               `> 📦 仓库：\`{event.type}\n` +               `> 📝 描述：{event.url})`,      // 如需富媒体展示，可添加 embed 或 ark 消息      msg_type: 0  // 0: 文本消息    }  });}

{  "integrations": {    "notion": {      "token": "secret_xxx",  // Internal Integration Token      "default_database_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"    }  }}

notion_api({  method: "POST",  path: "/v1/pages",  body: {    parent: {       database_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"     },    icon: {      type: "emoji",      emoji: "✅"    },    properties: {      "任务名称": {        title: [          { text: { content: "完成 OpenClaw 文档整理" } }        ]      },      "状态": {        select: { name: "进行中" }      },      "优先级": {        select: { name: "高" }      },      "截止日期": {        date: { start: "2026-04-20" }      },      "标签": {        multi_select: [          { name: "文档" },          { name: "自动化" }        ]      }    }  }})

// 假设上一步返回了 page_id: xxxxnotion_api({  method: "PATCH",  path: "/v1/blocks/xxxx/children",  body: {    children: [      {        object: "block",        type: "heading_2",        heading_2: {          rich_text: [{ text: { content: "执行步骤" } }]        }      },      {        object: "block",        type: "bulleted_list_item",        bulleted_list_item: {          rich_text: [{ text: { content: "梳理核心功能模块" } }]        }      },      {        object: "block",        type: "bulleted_list_item",        bulleted_list_item: {          rich_text: [{ text: { content: "补充配置细节与边界情况" } }]        }      }    ]  }})

cron({  action: "add",  job: {    name: "每日笔记归档",    schedule: {      kind: "cron",      expr: "0 18 * * *",  // 每天晚上 18:00      tz: "Asia/Shanghai"    },    sessionTarget: "isolated",    payload: {      kind: "agentTurn",      message: "【笔记归档】今日学习笔记已整理，请确认是否同步到 Notion？\n" +               "如确认，请回复「归档」我将自动执行同步。",      deliver: true,      channel: "qqbot",      to: "{用户 openid}"    }  }})

{  "channels": {    "qqbot": {      "appid": "your-bot-appid",      "token": "your-bot-token",      "secret": "your-bot-secret",      "sandbox": false,      "default_channel_id": "channel-id-for-default-push"    }  },  "routing": {    "rules": [      {        "name": "github_events",        "match": { "source": "github" },        "target": { "channel": "qqbot", "channel_id": "dev-channel-id" }      },      {        "name": "daily_reminders",        "match": { "type": "cron", "job_name": "*提醒*" },        "target": { "channel": "qqbot", "to": "{用户 openid}" }      },      {        "name": "notion_sync",        "match": { "source": "notion" },        "target": { "channel": "qqbot", "channel_id": "doc-channel-id" }      }    ]  }}

// 路由决策函数（可在 Agent 逻辑中使用）function routeMessage(message) {  const rules = {    github_event: {      channel: "qqbot",      target: "dev-channel-id",      priority: "high",      template: "github_notify"    },    notion_sync: {      channel: "qqbot",       target: "doc-channel-id",      priority: "normal",      template: "simple_text"    },    daily_reminder: {      channel: "qqbot",      target: "user-private",      priority: "normal",      mention: true    },    code_review: {      channel: "qqbot",      target: "review-channel-id",      priority: "high",      mention_all: false    }  };  const rule = rules[message.type];  if (!rule) {    console.warn(`未知消息类型: {NOTION_TOKEN}"    }  }}

const filterRules = {  // 排除指定标签的 Issues  exclude_labels: ["wontfix", "duplicate", "security"],  // 最低优先级阈值  min_priority: "medium",  // 排除指定作者（通常是机器人）  exclude_authors: ["github-actions", "dependabot", "snyk-bot"],  // 排除私有仓库事件（可选）  exclude_private_repos: true};

# 1. 查看所有定时任务状态openclaw cron list# 输出示例：# ID    NAME              SCHEDULE        NEXT_RUN          STATUS# 1     每日任务汇总       0 9 * * *       2026-04-18 09:00  active# 2     PR 审查提醒        0 10 * * 1-5    2026-04-18 10:00  active# 2. 查看网关实时日志（按 Ctrl+C 退出）【路径以你自己的实际路径为准】tail -f /home/tht/.openclaw/logs/gateway.log | grep -E "(webhook|cron|qqbot)"# 3. 查看 Agent 执行日志（排查消息未发送原因）【路径以你自己的实际路径为准】tail -f /home/tht/.openclaw/logs/agent.log# 4. 手动触发一次任务（用于调试）openclaw cron trigger --id 1

const notificationLevels = {  urgent: {    pattern: /(CI failed|security alert|production error)/i,    action: "immediate_mention"  // 立即 @ 用户  },  daily: {    pattern: /(每日汇总|待办任务)/,    action: "morning_digest"     // 仅早推送一次  },  silent: {    pattern: /(dependabot|github-actions)/,    action: "log_only"           // 只记录日志，不推送  }};