Skill 中的工具调用：exec/browser/message 详解

OpenClaw 提供 exec（执行命令）、browser（浏览器控制）、message（消息发送）三大核心工具。本文深入讲解每个工具的参数、使用场景和最佳实践。

一、核心概念

exec 工具在子进程中执行系统命令，支持超时控制、环境变量注入、工作目录指定。browser 工具基于 Playwright，支持页面导航、元素操作、截图、PDF 生成。message 工具向用户发送消息，支持文本、图片、文件附件。

工具调用遵循统一接口：tool_name 指定工具，input 传递参数，timeout 设置超时（默认 30s）。执行结果包含 success 标志、result 数据、error 错误信息。支持链式调用，使用 {{steps[index].result}} 引用前序结果。

二、实操步骤

选择工具的原则：系统操作选 exec，网页交互选 browser，用户通知选 message。复杂场景可组合使用：先用 browser 抓取网页，再用 exec 处理数据，最后用 message 发送结果。

第一步掌握 exec 工具。常用参数：command（命令字符串）、cwd（工作目录）、env（环境变量字典）、timeout（超时毫秒）。注意：命令注入风险，务必验证用户输入。

# 三工具组合使用示例
execution:
steps:
# Step 1: 使用 browser 截图
- tool: browser
name: screenshot
input:
action: screenshot
url: "https://example.com"
fullPage: true

# Step 2: 使用 exec 分析图片
- tool: exec
name: analyze
input:
command: "3 analyze.py {{steps.screenshot.output}}"
timeout: 60000

# Step 3: 使用 message 发送结果
- tool: message
name: notify
input:
content: "分析完成：{{steps.analyze.stdout}}"
attachments:
- path: "{{steps.screenshot.output}}"

三、常见问题与最佳实践

常见问题：exec 命令超时？增加 timeout 参数或优化命令性能。browser 元素找不到？增加等待时间或使用更稳定的选择器。message 发送失败？检查频道配置和权限设置。

最佳实践：安全建议：exec 命令使用参数化方式避免注入；browser 使用无头模式节省资源；敏感操作添加确认提示；大文件传输使用流式处理；设置合理的超时防止资源占用。

四、总结

掌握三大核心工具是 Skill 开发的基础。exec 扩展系统能力，browser 连接互联网，message 建立用户沟通。灵活组合这些工具，你能创造出无限可能的自动化方案。