05 Tools Automation - Cygnus Tech Bloghttps://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/技术 × 产品 × 机器人Hugo 0.160.1 & FixIt v0.4.6-20260517062719-ed8ec5c2zh-CNruohuyang@163.com (Cygnus Yang)ruohuyang@163.com (Cygnus Yang)Sat, 23 May 2026 00:00:00 +0800第24章 工具系统 (Tools) —— OpenClaw 工具调用框架设计https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/24-tools/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/24-tools/<p>OpenClaw 的工具体系是<strong>按内置工具名、工具组和策略配置</strong>来组织的。</p> <h2 class="heading-element" id="当前工具系统的几个核心点"><span>当前工具系统的几个核心点</span> <a href="#%e5%bd%93%e5%89%8d%e5%b7%a5%e5%85%b7%e7%b3%bb%e7%bb%9f%e7%9a%84%e5%87%a0%e4%b8%aa%e6%a0%b8%e5%bf%83%e7%82%b9" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><h3 class="heading-element" id="1-工具是一级能力"><span>1. 工具是一级能力</span> <a href="#1-%e5%b7%a5%e5%85%b7%e6%98%af%e4%b8%80%e7%ba%a7%e8%83%bd%e5%8a%9b" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h3><p>当前官方文档明确列出的内置重点包括：</p>第25章 内置浏览器 —— 网页抓取和交互https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/25-browser/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/25-browser/<p>当前 OpenClaw 的浏览器能力由 <strong>Browser (openclaw-managed)</strong>、<code>chrome</code> extension relay，以及 agent 侧 <code>browser</code> 工具 / <code>openclaw browser</code> CLI 组成，核心配置块在：</p> <pre><code>browser</code></pre><p>不是插件配置块。</p> <h2 class="heading-element" id="当前浏览器能力是什么"><span>当前浏览器能力是什么</span> <a href="#%e5%bd%93%e5%89%8d%e6%b5%8f%e8%a7%88%e5%99%a8%e8%83%bd%e5%8a%9b%e6%98%af%e4%bb%80%e4%b9%88" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>按当前官方文档，可以概括为：</p>第26章 Cron 自动化 —— 定时任务自动化https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/26-cron/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/26-cron/<p>OpenClaw 的 cron 是一个<strong>Gateway 内置调度器</strong>，专门用于处理定时任务。与传统的 crontab 或需要外部依赖的方案不同，OpenClaw 的 cron 直接运行在 Gateway 内部，支持多种执行模式，并且任务会自动持久化。</p> <p>推荐操作入口是 <code>openclaw cron ...</code> 命令，任务持久化在状态目录里，不需要手工维护复杂的配置文件。</p> <h2 class="heading-element" id="cron-是如何工作的"><span>Cron 是如何工作的</span> <a href="#cron-%e6%98%af%e5%a6%82%e4%bd%95%e5%b7%a5%e4%bd%9c%e7%9a%84" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><pre><code>flowchart TD A[创建 Cron 任务&lt;br/&gt;openclaw cron add] --&gt; B[任务持久化&lt;br/&gt;~/.openclaw/cron/jobs.json] B --&gt; C{等待触发时间} C --&gt;|到时| D{执行模式} D --&gt;|main| E[发送事件到主会话&lt;br/&gt;systemEvent] D --&gt;|isolated| F[启动独立会话&lt;br/&gt;agentTurn] E --&gt; G[任务执行] F --&gt; G G --&gt; H{投递方式} H --&gt;|announce| I[发送到聊天渠道] H --&gt;|webhook| J[发送到外部 URL] H --&gt;|none| K[静默结束] I --&gt; L{是否删除} J --&gt; L K --&gt; L L --&gt;|deleteAfterRun=true| M[删除任务] L --&gt;|false| N[保留任务继续调度]</code></pre><p>官方文档的定义很明确：</p>第27章 Onboarding —— 新手引导流程设计https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/27-onboarding/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/05-tools-automation/27-onboarding/<p>Onboarding 是 OpenClaw 的新手安装配置引导流程，帮助你从零一键完成配置，不用手改 JSON。本章介绍 Onboarding 工作流程、交互界面和最佳实践。</p> <h2 class="heading-element" id="什么是-onboarding"><span>什么是 Onboarding</span> <a href="#%e4%bb%80%e4%b9%88%e6%98%af-onboarding" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>Onboarding = <strong>交互式命令行配置向导</strong>：</p>