Skip to main content
使用本页选择合适的能力界面。工具是可调用的操作,技能用于指导智能体如何工作,而插件则添加运行时能力,例如工具、提供商、渠道、钩子和打包的技能。 这是一个概览和导航页面。有关完整的工具策略、默认值、组成员关系、提供商限制和配置字段,请参阅工具和自定义提供商

从这里开始

对于大多数智能体,请先使用内置工具类别,然后仅在智能体应该看到更少的工具或需要明确的主机访问权限时调整策略。

选择工具、Skills 或插件

1

当智能体需要执行操作时使用工具

工具是智能体可以调用的类型化函数,例如 execbrowserweb_searchmessageimage_generate。当智能体需要读取数据、更改文件、 发送消息、调用提供商或操作其他系统时,请使用工具。可见工具会以结构化函数定义的形式发送给模型。模型只能看到经过当前配置文件、允许/拒绝策略、提供商限制、沙箱状态、渠道权限和插件可用性筛选后保留下来的工具。
2

当智能体需要说明时使用 Skills

Skill 是加载到智能体提示词中的 SKILL.md 指令包。当智能体已经拥有所需工具,但需要可重复的工作流、 审查准则、命令序列或操作约束时,请使用 Skill。Skills 可以位于工作区、共享技能目录、托管的 OpenClaw 技能根目录或插件包中。Skills | 技能工作坊 | 自我学习 | 创建技能 | Skills 配置
3

当 OpenClaw 需要新能力时使用插件

插件可以添加工具、Skills、渠道、模型提供商、语音、实时语音、媒体生成、Web 搜索、Web 获取、钩子及其他运行时能力。 当能力包含代码、凭据、生命周期钩子、清单元数据或可安装的软件包时,请使用插件。现有插件可以从 ClawHub、npm、git、 本地目录或归档文件安装。安装和配置插件 | 构建插件 | 插件 SDK

内置工具类别

下表列出了代表性工具,帮助你了解相应界面。它不是完整的策略参考。有关确切的组、默认值以及允许/拒绝语义,请参阅工具和自定义提供商
代码模式和工具搜索是实验性的 OpenClaw 智能体界面。Codex harness 运行使用 Codex 原生代码模式、原生工具搜索、延迟动态工具和嵌套工具调用,而不是 tools.codeModetools.toolSearch

插件提供的工具

插件可以注册其他工具。插件作者通过 api.registerTool(...) 和清单中的 contracts.tools 接入工具;有关契约详情,请参阅插件 SDK插件清单 常见的插件提供工具包括:
  • Diffs,用于呈现文件和 Markdown 差异
  • 显示小组件,用于在支持的聊天客户端中呈现自包含的内联 SVG 和 HTML
  • 屏幕,用于排列已连接的 Control UI
  • LLM 任务,用于仅使用 JSON 的工作流步骤
  • Lobster,用于支持可恢复审批的类型化工作流
  • Tokenjuice,用于压缩冗杂的 execbash 工具 输出
  • 工具搜索,用于发现和调用大型工具 目录,而无需将每个 schema 都放入提示词
  • Canvas,用于节点 Canvas 控制和 A2UI 渲染

配置访问权限和审批

工具策略在模型调用前执行。如果策略移除了某个工具,模型在该轮中 将不会收到该工具的 schema。一次运行可能因全局配置、按 Agent 配置、渠道策略、提供商 限制、沙箱规则、渠道/运行时策略或插件可用性而失去工具。

扩展能力

根据需要 OpenClaw 完成的任务选择扩展路径:

排查工具缺失问题

如果模型无法看到或调用某个工具,请从当前轮次的有效策略 开始排查:
  1. 工具和自定义提供商中检查活动配置文件、tools.allowtools.deny
  2. 工具和自定义提供商中检查提供商特定限制,并确认所选 模型提供商支持该工具 结构。
  3. 使用沙箱、工具策略和提升权限提升权限的 Exec检查渠道权限、沙箱状态和提升权限访问。
  4. 插件中检查所属插件是否已安装并启用。
  5. 对于委派运行,请在按 Agent 配置的沙箱和工具限制中检查按 Agent 配置的限制。
  6. 对于大型 OpenClaw 目录,请确认运行使用的是直接工具 暴露、代码模式还是工具搜索

相关内容

  • 自动化,涵盖 cron、任务、Heartbeat、钩子、 常设指令和 Task Flow
  • 智能体,介绍智能体模型、会话、记忆和 多智能体协调
  • 工具和自定义提供商,提供权威工具 策略参考
  • 插件,介绍插件安装和管理
  • 插件 SDK,提供插件作者参考
  • Skills,介绍技能加载顺序、门控和配置
  • 技能工坊,用于生成和审查技能 创建
  • 工具搜索,用于精简的 OpenClaw 工具目录 发现
  • 代码模式,用于通过隐藏的 OpenClaw 工具目录运行精简的 JavaScript 或 TypeScript 工作流
  • Swarm,用于从代码模式进行结构化扇出和结果收集