从这里开始
对于大多数智能体,请先使用内置工具类别,然后仅在智能体应该看到更少的工具或需要明确的主机访问权限时调整策略。选择工具、Skills 或插件
1
当智能体需要执行操作时使用工具
工具是智能体可以调用的类型化函数,例如
exec、browser、
web_search、message 或 image_generate。当智能体需要读取数据、更改文件、
发送消息、调用提供商或操作其他系统时,请使用工具。可见工具会以结构化函数定义的形式发送给模型。模型只能看到经过当前配置文件、允许/拒绝策略、提供商限制、沙箱状态、渠道权限和插件可用性筛选后保留下来的工具。2
内置工具类别
下表列出了代表性工具,帮助你了解相应界面。它不是完整的策略参考。有关确切的组、默认值以及允许/拒绝语义,请参阅工具和自定义提供商。代码模式和工具搜索是实验性的 OpenClaw 智能体界面。Codex harness 运行使用 Codex 原生代码模式、原生工具搜索、延迟动态工具和嵌套工具调用,而不是
tools.codeMode 或 tools.toolSearch。插件提供的工具
插件可以注册其他工具。插件作者通过api.registerTool(...) 和清单中的 contracts.tools 接入工具;有关契约详情,请参阅插件 SDK和插件清单。
常见的插件提供工具包括:
- Diffs,用于呈现文件和 Markdown 差异
- 显示小组件,用于在支持的聊天客户端中呈现自包含的内联 SVG 和 HTML
- 屏幕,用于排列已连接的 Control UI
- LLM 任务,用于仅使用 JSON 的工作流步骤
- Lobster,用于支持可恢复审批的类型化工作流
- Tokenjuice,用于压缩冗杂的
exec和bash工具 输出 - 工具搜索,用于发现和调用大型工具 目录,而无需将每个 schema 都放入提示词
- Canvas,用于节点 Canvas 控制和 A2UI 渲染
配置访问权限和审批
工具策略在模型调用前执行。如果策略移除了某个工具,模型在该轮中 将不会收到该工具的 schema。一次运行可能因全局配置、按 Agent 配置、渠道策略、提供商 限制、沙箱规则、渠道/运行时策略或插件可用性而失去工具。- 工具和自定义提供商介绍工具配置文件、 允许/拒绝列表、提供商特定限制、循环检测和 提供商支持的工具设置。
- Exec 审批介绍主机命令审批 策略。
- 提升权限的 Exec介绍在沙箱外进行的受控 执行。
- 沙箱、工具策略和提升权限 说明哪个层级控制文件和进程访问权限。
- 按 Agent 配置的沙箱和工具限制 介绍委派运行中针对智能体的特定限制。
扩展能力
根据需要 OpenClaw 完成的任务选择扩展路径:排查工具缺失问题
如果模型无法看到或调用某个工具,请从当前轮次的有效策略 开始排查:- 在工具和自定义提供商中检查活动配置文件、
tools.allow和tools.deny。 - 在工具和自定义提供商中检查提供商特定限制,并确认所选 模型提供商支持该工具 结构。
- 使用沙箱、工具策略和提升权限 和提升权限的 Exec检查渠道权限、沙箱状态和提升权限访问。
- 在插件中检查所属插件是否已安装并启用。
- 对于委派运行,请在按 Agent 配置的沙箱和工具限制中检查按 Agent 配置的限制。
- 对于大型 OpenClaw 目录,请确认运行使用的是直接工具 暴露、代码模式还是工具搜索。