从这里开始
对于大多数代理，先从内置工具类别开始，然后仅当代理应看到更少的工具或需要明确的主机访问时再调整策略。选择工具、技能或插件
1
当代理需要执行操作时使用工具
工具是代理可以调用的类型化函数，例如
exec、browser、
web_search、message 或 image_generate。当代理需要
读取数据、修改文件、发送消息、调用提供者或
操作其他系统时，使用工具。可见工具会作为结构化
函数定义发送给模型。模型只能看到那些在当前配置文件、允许/拒绝
策略、提供者限制、沙箱状态、通道权限以及
插件可用性下仍然保留的工具。2
内置工具类别
下表列出了一些代表性工具，方便你识别这个能力层。它不是 完整的策略参考。有关精确的组、默认值和允许/拒绝 语义，请使用 工具和自定义提供者。代码模式和工具搜索是实验性的 OpenClaw 代理入口。Codex
harness 运行使用 Codex 原生代码模式、原生工具搜索、延迟动态
工具以及嵌套工具调用，而不是
tools.codeMode 或 tools.toolSearch。插件提供的工具
插件可以注册额外的工具。插件作者通过api.registerTool(...) 和清单中的 contracts.tools 来接入工具；请使用
插件 SDK 和 插件清单
查看契约细节。
常见的插件提供工具包括：
- Diffs 用于渲染文件和 markdown 差异
- Show widget 用于在受支持的聊天客户端中显示自包含的内联 SVG 和 HTML
- Screen 用于组织一个已连接的 Control UI
- LLM Task 用于仅 JSON 的工作流步骤
- Lobster 用于带有可恢复审批的类型化工作流
- Tokenjuice 用于压缩噪声较多的
exec和bash工具 输出 - Tool Search 用于发现并调用大型工具 目录，而无需将每个 schema 都放进提示词中
- Canvas 用于节点 Canvas 控制和 A2UI 渲染
配置访问和审批
工具策略在模型调用之前强制执行。如果策略移除了某个工具， 模型在该轮不会收到该工具的 schema。运行可能会因为全局配置、 按代理配置、通道策略、提供者限制、沙箱规则、通道/运行时策略或 插件可用性而失去工具。- 工具和自定义提供者 文档说明了工具配置文件、 允许/拒绝列表、特定提供者限制、循环检测，以及 基于提供者的工具设置。
- Exec 审批 文档说明了主机命令审批 策略。
- 特权执行 文档说明了在 沙箱之外受控执行。
- 沙箱 vs 工具策略 vs 特权执行 解释了哪一层控制文件和进程访问。
- 按代理的沙箱和工具限制 文档说明了用于委派运行的特定代理限制。
扩展能力
根据你需要 OpenClaw 执行的任务选择扩展路径：- 使用 插件 安装或管理现有插件。
- 通过 构建插件 来构建新的集成、提供程序、渠道、工具或钩子。
- 使用 技能 和 创建技能 来添加或调整可复用的代理指令。
- 当你需要实现 合同时，使用 插件 SDK 和 插件清单。
排查缺失工具
如果模型无法看到或调用某个工具，请先从当前轮次的有效策略开始检查：- 检查活动配置文件、
tools.allow和tools.deny，见 工具与自定义提供方。 - 检查 工具与自定义提供方 中提供方特定的限制，并确认 所选 模型提供方 支持该工具 形状。
- 检查通道权限、沙箱状态以及提升权限，见 沙箱 vs 工具策略 vs 提升权限 和 提升执行。
- 检查拥有该插件是否已安装并启用，见 插件。
- 对于委派运行，检查每个代理的限制，见 每个代理的沙箱和工具限制。
- 对于大型 OpenClaw 目录，确认此次运行是否使用直接工具 暴露、代码模式 或 工具搜索。