https://blog.ohtly.com/tags/%E5%BC%82%E6%AD%A5%E9%80%9A%E7%9F%A5/ Recent content in 异步通知 on OHTLY Blog Hugo zh-cn Fri, 29 May 2026 10:00:00 +0800 https://blog.ohtly.com/posts/2026-05-27-openclaw-message-agent-turn-vs-wake/ Wed, 27 May 2026 19:20:00 +0800 https://blog.ohtly.com/posts/2026-05-27-openclaw-message-agent-turn-vs-wake/ <h2 id="为什么需要这个"> 为什么需要这个 <a class="heading-link" href="#%e4%b8%ba%e4%bb%80%e4%b9%88%e9%9c%80%e8%a6%81%e8%bf%99%e4%b8%aa"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>AI Agent 经常需要执行耗时较长的异步任务（视频剪辑、字幕生成、模型推理等）。任务完成后，如何通知用户？</p> <p>有三种常见实现方式：</p> <table> <thead> <tr> <th>方式</th> <th>过程</th> <th>优点</th> <th>缺点</th> </tr> </thead> <tbody> <tr> <td><strong>同步等待</strong></td> <td>发起任务 → 一直等到完成 → 返回结果</td> <td>实现简单</td> <td>长时间阻塞，用户体验差</td> </tr> <tr> <td><strong>异步轮询</strong></td> <td>发起任务 → 拿到 job_id → 不断查询 → 完成</td> <td>不阻塞</td> <td>对话不能断开，浪费 token</td> </tr> <tr> <td><strong>异步+通知</strong></td> <td>发起任务 → 返回&quot;已提交&quot; → 完成后主动推送</td> <td>体验最好，资源最优</td> <td>需要服务端支持回调</td> </tr> </tbody> </table> <p>OpenClaw 的独特优势在于它拥有 <strong>Webhook/Hook 机制</strong>，可以作为服务端接收外部回调，主动推送消息到飞书。</p> <p>对比其他 AI 工具：</p> <ul> <li><strong>OpenCode / Claude Code</strong>：纯 CLI 工具，只有&quot;触发→等待→返回&quot;的模式，没有回调机制</li> <li><strong>OpenClaw</strong>：内置 Gateway 服务，支持 <code>/hooks/*</code> 端点，天然适合异步回调</li> </ul> <p>所以 <strong>&ldquo;异步+通知&rdquo;</strong> 是 OpenClaw 的场景的最优解。</p> <h2 id="整体架构"> 整体架构 <a class="heading-link" href="#%e6%95%b4%e4%bd%93%e6%9e%b6%e6%9e%84"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <div class="mermaid"> sequenceDiagram participant U as 用户（飞书） participant O as OpenClaw Agent participant W as Windmill / 外部系统 participant H as OpenClaw Hook U->>O: 发消息处理这个视频 O->>W: API 调用（异步） O-->>U: 任务已提交 Note over W: 几分钟后... W-->>H: POST /hooks/agent H->>H: 创建 Agent Turn H->>U: 飞书消息（带下载链接） </div> <h2 id="agent-turn-与-wake"> Agent Turn 与 Wake <a class="heading-link" href="#agent-turn-%e4%b8%8e-wake"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>OpenClaw 提供了两种代码触发的消息通知方式，它们都通过 Gateway 的 <code>/hooks/*</code> 端点实现。</p>