概览
概览
使用本页选择合适的能力界面。工具是可调用的操作，技能用于指导智能体如何工作，而插件则添加运行时能力，例如工具、提供商、渠道、钩子和打包的技能。
这是一个概览和导航页面。有关完整的工具策略、默认值、组成员关系、提供商限制和配置字段，请参阅工具和自定义提供商。
从这里开始
对于大多数智能体，请先使用内置工具类别，然后仅在智能体应该看到更少的工具或需要明确的主机访问权限时调整策略。
| 如果需要…… | 请先使用 | 然后阅读 |
|---|---|---|
| 让智能体使用现有能力执行操作 | 内置工具 | 工具类别 |
| 控制智能体可以调用的内容 | 工具策略 | 工具和自定义提供商 |
| 向智能体传授工作流 | Skills | Skills、创建技能、技能工作坊和自我学习 |
| 添加新的集成或运行时界面 | 插件 | 插件和构建插件 |
| 稍后或在后台运行工作 | 自动化 | 自动化概览 |
| 协调多个智能体或 harness | 子智能体 | ACP 智能体和智能体发送 |
| 通过代码编排并发智能体 | Swarm | 代码模式和子智能体 |
| 搜索大型 OpenClaw 工具目录 | 工具搜索 | 工具搜索 |
| 在一个紧凑程序中组合多个工具 | 代码模式 | 代码模式 |
选择工具、Skills 或插件
当智能体需要执行操作时使用工具
工具是智能体可以调用的类型化函数，例如 exec、browser、
web_search、message 或 image_generate。当智能体需要读取数据、更改文件、
发送消息、调用提供商或操作其他系统时，请使用工具。可见工具会以结构化函数定义的形式发送给模型。
模型只能看到经过当前配置文件、允许/拒绝策略、提供商限制、沙箱状态、渠道权限和插件可用性筛选后保留下来的工具。
当智能体需要说明时使用 Skills
Skill 是加载到智能体提示词中的 SKILL.md 指令包。当智能体已经拥有所需工具，但需要可重复的工作流、
审查准则、命令序列或操作约束时，请使用 Skill。
Skills 可以位于工作区、共享技能目录、托管的 OpenClaw 技能根目录或插件包中。
当 OpenClaw 需要新能力时使用插件
插件可以添加工具、Skills、渠道、模型提供商、语音、实时语音、媒体生成、Web 搜索、Web 获取、钩子及其他运行时能力。 当能力包含代码、凭据、生命周期钩子、清单元数据或可安装的软件包时，请使用插件。现有插件可以从 ClawHub、npm、git、 本地目录或归档文件安装。
内置工具类别
下表列出了代表性工具，帮助你了解相应界面。它不是完整的策略参考。有关确切的组、默认值以及允许/拒绝语义，请参阅工具和自定义提供商。
| 类别 | 在智能体需要执行以下操作时使用…… | 代表性工具 | 接下来阅读 |
|---|---|---|---|
| 运行时 | 运行命令、管理进程或使用由提供商支持的 Python 分析 | exec、process、terminal、code_execution |
Exec、Control UI 终端、代码执行 |
| 文件 | 读取和更改工作区文件 | read、write、edit、apply_patch |
应用补丁 |
| 人工输入 | 暂停并等待由用户决定的结构化决策 | ask_user |
询问用户 |
| Web | 搜索 Web、搜索 X 帖子或获取可读的页面内容 | web_search、x_search、web_fetch |
Web 工具、Web 获取 |
| 浏览器 | 操作浏览器会话 | browser |
浏览器 |
| 操作员界面 | 排列已连接的 Control UI 窗格、面板和导航 | screen |
屏幕 |
| 消息和渠道 | 发送回复或执行渠道操作 | message |
智能体发送 |
| 会话和智能体 | 检查会话、委派工作、编排收集器、引导另一次运行或报告状态 | sessions_*、agents_wait、subagents、agents_list、session_status、get_goal、create_goal、update_goal |
目标、Swarm、子智能体、会话工具 |
| 自动化 | 安排工作或响应后台事件 | cron、heartbeat_respond |
自动化 |
| Gateway 网关和节点 | 检查 Gateway 网关状态或已配对的目标设备 | gateway、nodes |
Gateway 配置、节点 |
| 媒体 | 分析、生成媒体或将其转换为语音 | image、image_generate、music_generate、video_generate、tts |
媒体概览 |
| 大型 OpenClaw 目录 | 搜索、调用并组合大量符合条件的工具，而无需将每个架构都发送给模型 | exec、wait、tool_search_code、tool_search、tool_describe |
代码模式、工具搜索 |
插件提供的工具
插件可以注册其他工具。插件作者通过 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 目录，请确认运行使用的是直接工具 暴露、代码模式还是工具搜索。