openclaw工具是Agent的“手“
2026/5/11 15:47:09 网站建设 项目流程

工具是Agent的"手"。

没有工具,Agent只能空谈;有了工具,Agent才能真正执行任务。OpenClaw内置的工具系统,让每个Agent都能读写文件、执行命令、抓取网页。

一、工具分类总览

OpenClaw的工具分为四类:

文件操作类
read - 读取文件内容
write - 创建或覆盖文件
edit - 精准修改文件局部内容
exec - 执行Shell命令

信息获取类
web_search - 搜索引擎查询
web_fetch - 抓取网页内容

系统控制类
sessions_list - 查看会话列表
sessions_history - 查看历史记录
session_status - 查看当前状态
subagents_spawn - 启动子Agent
subagents_list - 查看子Agent状态

飞书集成类
feishu_send - 发送飞书消息
feishu_webhook - Webhook推送

二、文件操作工具详解

  1. read - 读取文件

参数:
path:文件路径(绝对或相对)
offset:起始行号(可选)
limit:读取行数限制(可选)

示例:
read(“/home/ly/agents/content/AGENTS.md”)
read(“memory/daily/20260418.md”, offset=1, limit=50)

适用场景:
读取配置、查看记忆、分析日志

  1. write - 写入文件

参数:
path:文件路径(自动创建父目录)
content:文件内容

示例:
write(“/shared/articles/001.md”, “这是文章内容…”)
write(“memory/working.md”, “当前任务状态…”)

注意:write是覆盖写入,要追加用edit

  1. edit - 精准编辑

参数:
path:文件路径
edits:修改列表,每项包含oldText和newText

示例:
edit(“/shared/config.yaml”, [
{
“oldText”: “port: 8080”,
“newText”: “port: 9090”
}
])

适用场景:
修改配置文件、更新文章局部内容
原则:只改要改的,不动其他部分

  1. exec - 执行Shell命令

参数:
command:Shell命令
timeout:超时时间(秒)
elevated:是否提权运行

示例:
exec(“ls -la /home/ly/agents/”)
exec(“git pull origin main”)
exec(“npm install -g openclaw”)

安全提示:
生产环境建议关闭elevated权限
敏感操作会被记录到日志

三、信息获取工具

  1. web_search - 网页搜索

参数:
query:搜索关键词
count:返回结果数量(默认5)
region:搜索区域

示例:
web_search(“OpenClaw agent framework”, count=10)
web_search(“Python异步编程教程”, region=“cn”)

返回格式:
[
{
“title”: “标题”,
“url”: “链接”,
“snippet”: “摘要”
}
]

  1. web_fetch - 抓取页面

参数:
url:目标URL
maxChars:最大字符数
extractMode:提取模式(markdown/text)

示例:
web_fetch(“https://github.com/openclaw/openclaw”)
web_fetch(“https://docs.example.com/guide”, maxChars=5000)

适用场景:
获取技术文档、采集素材、备份网页

四、工具链组合使用

单个工具能力有限,组合使用才是精髓。

案例:自动搜集资料并整理

第一步,抓取搜索结果:
results = web_search(“OpenClaw multi-agent”, count=10)

第二步,遍历结果抓取详情:
for (r in results) {
content = web_fetch(r.url, maxChars=3000)
// 提取关键信息
}

第三步,保存整理结果:
write(“research/agent-architecture.md”, content)

这就是一个完整的信息采集工作流。

五、工具使用限制

每个工具都有使用限制,超限会被限流:

web_search:每分钟30次
web_fetch:每分钟60次
exec:默认超时30秒,最大不超过300秒
write:单文件不超过5MB

查看当前限制:
openclaw tools limits

六、自定义工具

如果内置工具不满足需求,可以开发自定义工具:

在skills/目录下创建新工具:
~/.openclaw/skills/my-tool/
├── TOOL.md # 工具定义
└── handler.js # 处理逻辑

工具注册后自动加载,无需重启服务。

结语

工具是Agent能力的延伸。熟练掌握工具组合,能让你的工作效率提升10倍不止。

下一篇讲记忆系统,看看Agent是怎么记住一切的。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询