prev:
  text: '第6章 智能体管理'
  link: '/cn/adopt/chapter6'
next:
  text: '第8章 网关运维'
  link: '/cn/adopt/chapter8'​

第七章 工具与定时任务

学完本章，你的龙虾就能自己找工具干活、定时执行任务了——搜网页、操浏览器、每天早上自动发天气，一个不落。

AutoClaw 用户：AutoClaw 默认开启 full 工具配置档，无需手动配置。本章帮你理解工具系统，以便按需调整。

0. 工具 vs 技能

龙虾的"大脑"是模型（第二章配置），工具（Tools）是它的"双手"——没有工具只能聊天，有了工具才能干实事。

一句话：Tools 是手脚，Skills 是招式。

1. 工具配置档（Tool Profiles）

Tool Profile 控制龙虾"能做什么"，个人电脑上直接用 full 即可。

# 查看当前配置
openclaw config get tools.profile

# 设置为 full（推荐）
openclaw config set tools.profile full
openclaw gateway restart
​

如果龙虾只给建议、不执行操作，多半是配置档停在了旧版默认值 messaging——跑一遍上面的命令就好。

::: danger full 模式安全提示
full 模式下 OpenClaw 可在你的电脑上执行任意命令、读写任意文件。个人电脑上使用没问题（每次操作前都会请求确认），但不要在生产服务器上使用 full 模式。
:::

{
  "tools": { "profile": "full" },
  "agents": {
    "list": [
      {
        "id": "support",
        "tools": { "profile": "messaging", "allow": ["slack"] }
      }
    ]
  }
}
​

2. 内置工具一览

不需要逐个记住——龙虾会自动选工具，你只要确保配置档是 full。

3. 联网搜索

想让龙虾告诉你今天的新闻或最新股价？配置联网搜索就行。

一行命令启动向导：

openclaw configure --section web
​

向导会让你选搜索引擎、填 API Key，完成后龙虾就能实时查网了。

配置完成后直接在对话里问：

今天有什么科技新闻？
帮我搜索"OpenClaw 最新版本"的更新内容
​

龙虾自动判断要不要联网，不用你指定。

web_fetch 工具还能直接抓取指定网址的内容并转成文字。JavaScript 渲染的动态网页建议用下一节的浏览器工具。

4. 浏览器自动化

想让龙虾帮你填表单、截图、点按钮？浏览器工具默认已启用，直接说就行：

帮我打开百度搜索"今日天气"，截图给我看
打开 https://example.com，找到登录按钮并点击
​

龙虾会自动启动 Chrome、打开页面、识别元素、执行操作，最后截图给你确认。

前提：系统需要安装 Chrome 或 Chromium，大多数电脑已经预装。

如果浏览器未启用，运行：

openclaw config set browser.enabled true
openclaw gateway restart
​

{
  "browser": {
    "enabled": true,
    "defaultProfile": "chrome",
    "profiles": {
      "chrome": { "port": 18800 },
      "work": { "port": 18801 }
    }
  }
}
​

用 work 浏览器打开飞书文档
​

5. 定时任务（Cron）

想让龙虾每天早上给你推新闻？那就需要定时任务。

最简单的例子——每天早上 8 点发天气预报：

openclaw cron add --name "天气预报" --cron "0 8 * * *" \
  --message "查询今天的天气，发送给我" \
  --channel "feishu:chat:你的ChatID"
​

三种调度方式按需选：

# 固定周期：每 30 分钟执行一次
openclaw cron add --name "定期检查" --every 30m \
  --message "检查有没有需要我处理的事情"

# 一次性延时：20 分钟后提醒
openclaw cron add --name "提醒" --at 20m \
  --message "提醒：该休息一下了！"
​

管理任务：

openclaw cron list                   # 查看所有任务
openclaw cron run 天气预报           # 手动触发一次
openclaw cron runs --id <taskID>     # 查看执行历史
openclaw cron disable 天气预报       # 暂停
openclaw cron enable 天气预报        # 恢复
openclaw cron edit <jobId>           # 编辑
openclaw cron rm <jobId>             # 删除
​

Cron 任务依赖 Gateway 持续运行。电脑关机期间的任务不会补执行，Gateway 重启后恢复。

--channel 格式因平台而异：feishu:chat:<ChatID>、telegram:chat:<ChatID>、qqbot:group:<groupid>。完整格式见附录 F 命令速查表。

6. 命令执行（Exec）

exec 是龙虾"干活"的核心——安装软件、处理文件、运行脚本都靠它。直接说需求就行：

帮我创建一个文件叫 hello.txt，写上今天的日期和"Hello from OpenClaw!"
用 Python 写一个猜数字小游戏，保存为 game.py 并运行它
​

每次执行前龙虾都会请求你确认。

7. 工具权限管理

需要限制龙虾的能力？用 tools.allow 和 tools.deny 精确控制：

# 禁止浏览器
openclaw config set tools.deny '["browser"]'

# 只允许文件操作和搜索
openclaw config set tools.allow '["group:fs", "group:web"]'
​

deny 优先于 allow，匹配不区分大小写，支持 * 通配符。

{
  "tools": {
    "profile": "coding",
    "byProvider": {
      "google-antigravity": { "profile": "minimal" }
    }
  }
}
​

{
  "tools": {
    "loopDetection": {
      "enabled": true,
      "warningThreshold": 10,
      "criticalThreshold": 20,
      "globalCircuitBreakerThreshold": 30
    }
  }
}
​

8. 插件工具

内置工具不够用？OpenClaw 支持插件扩展：

安装和配置详见附录 G 配置文件详解。

9. 常见问题

龙虾只会聊天，不执行任何操作？

工具配置档可能停在了 messaging 或 minimal：

openclaw config set tools.profile full
openclaw gateway restart
​

联网搜索不可用？

需要先配置搜索引擎 API Key：openclaw configure --section web。

浏览器工具报错？

先确认已启用（openclaw config get browser.enabled），再确保系统装了 Chrome 或 Chromium。Linux 无图形界面服务器需要 Chromium headless 模式；WSL2 用户可能需要额外配置，详见附录 G。

定时任务没有执行？

检查 Gateway 是否在运行（openclaw status）。关机期间的任务不会补执行。

怎么看龙虾调用了哪些工具？

在 Web 控制面板（openclaw dashboard）的对话详情里可以看到每次工具调用，也可以查日志：

openclaw logs --limit 50
​