从这里开始
对于大多数智能体，先从内置工具类别开始，然后仅在智能体应看到更少工具或需要显式主机访问权限时调整策略。选择工具、Skills 或插件
当智能体需要执行操作时使用工具
工具是智能体可以调用的类型化函数，例如
exec、browser、
web_search、message 或 image_generate。当智能体需要读取数据、修改文件、发送消息、调用提供商或操作另一个系统时，使用工具。可见工具会作为结构化函数定义发送给模型。模型只能看到通过活动 profile、允许/拒绝策略、提供商限制、沙箱状态、渠道权限和插件可用性筛选后的工具。内置工具类别
下表列出代表性工具，帮助你识别该表面。它不是完整的策略参考。关于准确的分组、默认值和允许/拒绝语义，请使用工具和自定义提供商。| 类别 | 当智能体需要……时使用 | 代表性工具 | 接下来阅读 |
|---|---|---|---|
| 运行时 | 运行命令、管理进程或使用提供商支持的 Python 分析 | exec、process、code_execution | Exec、代码执行 |
| 文件 | 读取和修改工作区文件 | read、write、edit、apply_patch | 应用补丁 |
| Web | 搜索 Web、搜索 X 帖子，或获取可读页面内容 | web_search、x_search、web_fetch | Web 工具、Web 获取 |
| 浏览器 | 操作浏览器会话 | browser | 浏览器 |
| 消息和渠道 | 发送回复或渠道操作 | message | Agent send |
| 会话和智能体 | 检查会话、委派工作、引导另一次运行，或报告状态 | sessions_*、subagents、agents_list、session_status、get_goal、create_goal、update_goal | 目标、子智能体、会话工具 |
| 自动化 | 调度工作或响应后台事件 | cron、heartbeat_respond | 自动化 |
| Gateway 网关和节点 | 检查 Gateway 网关状态或已配对的目标设备 | gateway、nodes | Gateway 配置、节点 |
| 媒体 | 分析、生成或朗读媒体 | image、image_generate、music_generate、video_generate、tts | 媒体概览 |
| 大型 OpenClaw 目录 | 搜索并调用许多符合条件的工具，而无需将每个 schema 都发送给模型 | tool_search_code、tool_search、tool_describe | 工具搜索 |
工具搜索是实验性的 OpenClaw 智能体表面。Codex harness 运行使用 Codex 原生代码模式、原生工具搜索、延迟动态工具和嵌套工具调用，而不是
tools.toolSearch。插件提供的工具
插件可以注册额外工具。插件作者通过api.registerTool(...) 和清单中的 contracts.tools 连接工具；关于契约细节，请使用插件 SDK 和插件清单。
常见的插件提供工具包括：
- Diffs，用于渲染文件和 Markdown diff
- LLM Task，用于仅 JSON 的工作流步骤
- Lobster，用于带可恢复审批的类型化工作流
- Tokenjuice，用于压缩嘈杂的
exec和bash工具输出 - 工具搜索，用于发现并调用大型工具目录，而无需将每个 schema 都放入提示中
- Canvas，用于节点 Canvas 控制和 A2UI 渲染
配置访问和审批
工具策略会在模型调用之前执行。如果策略移除了某个工具，模型在该轮次中不会收到该工具的 schema。一次运行可能会因为全局配置、按智能体配置、渠道策略、提供商限制、沙箱规则、渠道/运行时策略或插件可用性而失去工具。- 工具和自定义提供商记录工具 profile、允许/拒绝列表、提供商特定限制、循环检测和提供商支持的工具设置。
- Exec 审批记录主机命令审批策略。
- 提升权限的 Exec记录沙箱外的受控执行。
- 沙箱、工具策略和提升权限解释哪一层控制文件和进程访问。
- 按 Agent 配置的沙箱和工具限制记录委派运行的智能体特定限制。
扩展能力
根据你需要 OpenClaw 完成的工作选择扩展路径：- 使用插件安装或管理现有插件。
- 使用构建插件构建新的集成、提供商、渠道、工具或 Hook。
- 使用 Skills 和创建技能添加或调优可复用的智能体指令。
- 当你需要实现契约时，使用插件 SDK 和插件清单。
排查缺失工具
如果模型无法看到或调用某个工具，请从当前轮次的有效策略开始：- 检查工具和自定义提供商中的活动 profile、
tools.allow和tools.deny。 - 检查工具和自定义提供商中的提供商特定限制，并确认所选模型提供商支持该工具形状。
- 通过沙箱、工具策略和提升权限和提升权限的 Exec检查渠道权限、沙箱状态和提升权限访问。
- 检查所属插件是否已在插件中安装并启用。
- 对于委派运行，检查按 Agent 配置的沙箱和工具限制中的按智能体限制。
- 对于大型 OpenClaw 目录，确认该运行使用的是直接工具暴露还是工具搜索。