概述

使用此页面选择合适的功能界面。工具是可调用的操作，技能教代理如何工作，而插件添加运行时功能，例如工具、提供商、渠道、钩子和打包的技能。

这是一个概览和路由页面。有关详尽的工具策略、默认值、组成员资格、提供商限制和配置字段，请使用工具和自定义提供商。

从这里开始

对于大多数智能体，请先从内置工具类别入手，然后仅在智能体应看到更少工具或需要显式主机访问权限时调整策略。

如果您需要……	首先使用此功能	然后阅读
让智能体使用现有功能执行操作	内置工具	工具类别
控制智能体可以调用的内容	工具策略	工具和自定义提供商
教代理一个工作流	Skills	Skills 和 创建 Skills
添加新的集成或运行时界面	插件	插件 和 构建插件
稍后或后台运行工作	自动化	自动化概述
协调多个代理或进程	子代理	ACP 代理和 代理发送
搜索大型 PI 工具目录	工具搜索	工具搜索

选择工具、技能或插件

1. 当代理需要执行操作时，请使用工具

   工具是代理可以调用的类型化函数，例如 exec、browser、 web_search、message 或 image_generate。当代理 需要读取数据、更改文件、发送消息、调用提供商或操作 其他系统时，请使用工具。可见工具作为结构化函数 定义发送到模型。

   模型只能看到在活动配置文件、允许/拒绝 策略、提供商限制、沙箱状态、渠道权限和 插件可用性筛选后剩余的工具。

2. 当代理需要指令时使用 Skill

   Skill 是加载到代理提示词中的 SKILL.md 指令包。当代理已拥有所需的工具，但需要可重复的工作流程、审查标准、命令序列或操作约束时，请使用 Skill。

   Skills 可以存在于工作区、共享 Skill 目录、托管 OpenClaw Skill 根目录或插件包中。

   Skills | 创建 Skills | Skills 配置

3. OpenClaw当 OpenClaw 需要新功能时使用插件

   插件可以添加工具、技能、频道、模型提供商、语音、实时语音、媒体生成、网络搜索、网络获取、钩子和其他运行时功能。当功能包含代码、凭据、生命周期钩子、清单元数据或可安装的打包时，请使用插件。现有的插件可以从 ClawHub、npm、git、本地目录或归档文件中安装。

   安装和配置插件 | 构建插件 | 插件 SDK

内置工具类别

该表列出了代表性工具，以便您了解该平台。这并非完整的策略参考。有关确切的组、默认值以及允许/拒绝语义，请使用工具和自定义提供商。

类别	当代理需要…时使用	代表性工具	下一步阅读
运行时	运行命令、管理进程或使用提供商支持的 Python 分析	exec, process, code_execution	Exec, Code execution
文件	读取和更改工作区文件	read, write, edit, apply_patch	Apply patch
网页	搜索网络、搜索 X 帖子或获取可读的页面内容	web_search、x_search、web_fetch	Web 工具、Web 获取
浏览器	操作浏览器会话	browser	浏览器
消息传递和渠道	发送回复或渠道操作	message	Agent send
会话和代理	检查会话、委托工作、引导另一次运行或报告状态	sessions_*, subagents, agents_list, session_status	Sub-agents, Session 工具
自动化	安排工作或响应后台事件	cron, heartbeat_respond	自动化
Gateway(网关) 和节点	检查 Gateway(网关) 状态或已配对的目标设备	gateway, nodes	Gateway(网关)配置、节点
媒体	分析、生成或播放媒体	image、image_generate、music_generate、video_generate、tts	媒体概览
大型 PI 目录	搜索并调用许多符合条件的工具，而无需将每个架构发送给模型	tool_search_code，tool_search，tool_describe	工具搜索

Note

工具搜索是一个实验性的 PI 代理界面。Codex harness 运行使用 Codex 原生代码模式、原生工具搜索、延迟动态工具和嵌套 工具调用，而不是

tools.toolSearch

。

插件提供的工具

插件可以注册其他工具。插件作者通过 api.registerTool(...) 和清单的 contracts.tools 来连接工具；有关合约详情，请参阅 插件 SDK 和 插件清单。

常见的插件提供的工具包括：

• 用于呈现文件和 Markdown 差异的 Diffs
• LLM Task 用于仅 JSON 工作流步骤
• Lobster 用于具有可恢复审批的类型化工作流
• Tokenjuice 用于压缩嘈杂的 exec 和 bash 工具 输出
• 工具搜索，用于发现和调用大型工具目录而无需将每个架构放入提示中
• Canvas，用于节点 Canvas 控制和 A2UI 渲染

配置访问和批准

工具策略在模型调用之前强制执行。如果策略移除了某个工具，模型在该轮次中将不会收到该工具的架构。由于全局配置、代理特定配置、渠道策略、提供商限制、沙盒规则、仅所有者门控或插件可用性，运行可能会丢失工具。

• 工具和自定义提供商 文档介绍了工具配置文件、允许/拒绝列表、特定于提供商的限制、循环检测以及提供商支持的工具设置。
• 执行批准 文档介绍了主机命令批准策略。
• 提升权限执行 文档介绍了在沙箱之外进行受控执行的内容。
• 沙箱与工具策略与提升权限 解释了哪一层控制文件和进程访问。
• 逐代理的沙箱和工具限制 记录了委托运行的代理特定限制。

扩展能力

根据您需要 OpenClaw 执行的任务选择扩展路径：

• 使用 Plugins 安装或管理现有插件。
• 使用 Build plugins 构建新的集成、提供商、渠道、工具或钩子。
• 使用 Skills 和 Creating skills 添加或调整可复用的代理指令。
• 当工作流属于插件分发的技能包时，请使用技能研讨会打包可重用的工作流素材。
• 当您需要实现契约时，请使用插件 SDK和插件清单。

排查缺失的工具

如果模型无法查看或调用工具，请先检查当前轮次的有效策略：

1. 在 工具和自定义提供商 中检查活动配置文件 tools.allow 和 tools.deny。
2. 在 工具和自定义提供商 中检查特定提供商的限制，并确认所选的 模型提供商 支持该工具形状。
3. 请通过 沙箱与工具策略与提权 和 提权执行 检查渠道权限、沙箱状态以及提权访问。
4. 请检查所属插件是否已在 插件 中安装并启用。
5. 对于委派运行，请在 按代理划分的沙箱和工具限制 中检查每个代理的限制。
6. 对于大型 PI 目录，请确认运行使用的是直接工具暴露还是工具搜索。

相关

• 自动化，用于 cron、任务、心跳、承诺、挂钩、定期订单和任务流
• 代理，用于代理模型、会话、记忆和多代理协调
• 有关规范工具策略参考，请参阅Tools and custom providers
• 有关插件安装和管理，请参阅Plugins
• 有关插件作者参考，请参阅Plugin SDK
• 有关 Skills 加载顺序、准入机制和配置，请参阅Skills
• 有关紧凑的 PI 工具目录发现，请参阅Tool Search