# bot-connect **Repository Path**: feng-kailong/bot-connect ## Basic Information - **Project Name**: bot-connect - **Description**: bot连接服务,用于clawdbot的微信连接使用 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-01 - **Last Updated**: 2026-09-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Remind 企业微信用户通过 botConnect 让本地 OpenClaw 设置、查询、修改、取消提醒时,按本文执行。 精确时刻的提醒一律走 OpenClaw Automations(`openclaw automations`,`openclaw cron` 是别名)。Heartbeat 只做模糊巡检,不承担「几点几分提醒我」。 ## 送达路径 ```text 用户(企业微信客服) → botConnect 收到消息 → WebSocket chat.send(sessionKey = main) → 本地 OpenClaw Gateway 创建/管理 automations → 到期后 main 会话产出 FINAL 回复 → botConnect 按已绑定关系找回用户 → 企业微信客服文本消息 ``` 提醒能回到微信,依赖这三条同时成立: 1. 本机 OpenClaw Gateway 在跑(调度在 Gateway 进程里,不在模型里)。 2. 本地连接程序已连上 botConnect。 3. 用户已完成微信与本地 OpenClaw 的绑定。 到期后必须在 **main 会话**里产出一条对用户可读的 FINAL 文本。botConnect 只转发 WebSocket 里 `payload.state = final` 且带文本的消息;`isolated` + `--announce` 投向 Telegram/Slack 的路径到不了企业微信。 ## 何时用哪种机制 | 用户意图 | 机制 | 会话与载荷 | | --- | --- | --- | | 「20 分钟后提醒我开会」 | 一次性 automation | `--session main --system-event --wake now` | | 「明天下午 3 点提醒我交表」 | 一次性 automation(绝对时间) | 同上,`--at` 带时区 | | 「每天早上 8 点提醒我吃药」 | 循环 cron | `--session main --system-event --wake now --tz Asia/Shanghai` | | 「每隔 2 小时提醒我喝水」 | 固定间隔 | `--every 2h`,同样走 main | | 「每天 9 点总结一下日历」 | 需要模型再加工的循环任务 | 仍用 main + system-event,把加工要求写进事件文本 | | 「帮我盯着收件箱」 | Heartbeat / 独立巡检任务 | 不是 Remind | 企业微信这条链路里,提醒默认用 **main + system-event + wake now**。不要用 isolated announce 当微信投递。 ## 创建提醒 1. 抽出三件事:提醒什么、何时、一次还是重复。时间含糊就先问清楚,再创建。 2. 用 `Asia/Shanghai` 解释用户口中的时间。无时区的 ISO 时间在 OpenClaw 里按 UTC;必须显式加 `--tz Asia/Shanghai`,或写成带偏移的时间(例如 `2026-09-07T15:00:00+08:00`)。 3. 先 `automations(action: "list")` 或 `openclaw automations list`,避免重复建同一条。 4. 用一句话向用户确认:时间、内容、是否重复。得到确认后再创建。 5. 创建成功后,用用户能看懂的话说出下次触发时间,不抛 jobId 除非对方要管理。 完成标准:任务已出现在 automations 列表里,`enabled` 为真,且 `nextRunAt` 对得上用户说的时间。 ### 一次性 相对时间: ```bash openclaw automations add \ --name "开会提醒" \ --at "20m" \ --session main \ --system-event "提醒用户:20 分钟前约定的会议到时间了。用一句完整中文直接提醒,说明是什么事。不要问还要不要提醒。" \ --wake now ``` 绝对时间: ```bash openclaw automations add \ --name "交表提醒" \ --at "2026-09-07T15:00:00+08:00" \ --tz Asia/Shanghai \ --session main \ --system-event "提醒用户:该交周报了。直接说事,不要寒暄计划。" \ --wake now ``` `--at` 一次性任务成功完成后默认删除。要保留成功记录时再加 `--keep-after-run`。 ### 循环 固定间隔: ```bash openclaw automations add \ --name "喝水提醒" \ --every 2h \ --session main \ --system-event "提醒用户喝水。一句话,中文,不要追问。" \ --wake now ``` 日历式 cron(5 或 6 段;`--tz` 解释本地钟): ```bash openclaw automations add \ --name "吃药提醒" \ --cron "0 8 * * *" \ --tz Asia/Shanghai \ --session main \ --system-event "提醒用户:早上 8 点吃药。直接提醒,不要展开成健康讲座。" \ --wake now ``` `--every` 不能搭配 `--tz`。cron 的日-of-month 与日-of-week 都不是 `*` 时是 **或** 关系,不是且。 ### system-event 怎么写 到期后这段文字就是智能体仅有的上下文。写完整、自包含、指定中文回复: - 写清「提醒谁、提醒什么、用户当时怎么说的」。 - 要求直接对用户说话,不要输出 `NO_REPLY`,不要只在内部记一笔。 - 需要查日历或 HEARTBEAT.md 时,把「去读 xxx」写进事件文本;main 提醒不会自动带上心跳清单。 ## 管理提醒 ```bash openclaw automations list openclaw automations list --all openclaw automations show openclaw automations get openclaw automations edit --system-event "更新后的提醒文本" openclaw automations enable openclaw automations disable openclaw automations run openclaw automations runs --limit 20 openclaw automations remove ``` 智能体侧优先用 `automations` 工具(`cron` 是兼容旧名): | 动作 | 用途 | | --- | --- | | `list` | 看启用中的提醒;禁用的要带全部列表 | | `get` | 看单条完整定义 | | `add` / `create` | 新建 | | `edit` | 改时间、文案、启用状态 | | `remove` | 取消 | | `run` | 立即试跑 | 改一条提醒:先 `list`/`get` 对上用户说的那条,再 `edit` 或先删后加。对用户只复述人话时间,不堆命令。 完成标准:用户能说出「改成了几点」或「已经取消」,且列表状态与之一致。 ## 对用户怎么说 创建后的确认要短,说清时间和事情: - 「好,明天下午 3 点提醒你交周报。」 - 「每隔 2 小时提醒你喝水,下一次大约 16:00。」 到期投递像熟人发消息,不要系统通知腔: - 「该交周报了。」 - 「会议时间到了:和产品对一下接口。」 不要在确认里甩 jobId、cron 表达式或内部路径,除非用户在排查。 ## 对话示例 用户:20 分钟后提醒我站起来活动一下。 - 创建 `--at 20m` 的 main / system-event 提醒。 - 回复:「20 分钟后叫你起来活动。」 用户:每个工作日早上 9 点提醒我看日程。 - 创建 `--cron "0 9 * * 1-5" --tz Asia/Shanghai`。 - 事件文本写明:用中文提醒用户查看今天的日程。 - 回复:「每个工作日 09:00 提醒你看日程。」 用户:把吃药提醒改成每天 8 点半。 / 以后不用提醒我喝水了。 - `list` 找到对应任务,`edit` 或 `remove`。 - 回复改后的时间,或「喝水提醒已经关掉。」 ## 故障排查 | 现象 | 先查什么 | | --- | --- | | 到点没有微信消息 | Gateway 是否在跑;`automations list` 是否仍 enabled;本地 WebSocket 是否在线 | | OpenClaw 里有回复,微信没有 | 用户是否已完成绑定;本地连接是否仍在线 | | 时间偏了 8 小时 | `--at` 是否当成 UTC;补上 `+08:00` 或 `--tz Asia/Shanghai` | | 一次性提醒成功后消失 | 默认 `deleteAfterRun`,属预期 | | 任务在列表里但禁用 | 连续失败会被自动禁用;`list --all` 看原因,修好后 `enable` | | 用了 isolated + announce | 企业微信收不到;改回 main + system-event | 试跑:`openclaw automations run `。看历史:`openclaw automations runs `。 ## 参考 - OpenClaw Automations: - 机制选型: - CLI: - 本仓库:botConnect 将 main 会话的 FINAL 文本转发到企业微信客服