跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 文档国际化输入> 除了生成文本之外，智能体执行的一切操作都通过工具完成。 工具是智能体读取文件、运行命令、浏览网页、发送消息以及与设备交互的方式。

​
工具、Skills 和插件

OpenClaw 有三个协同工作的层级：
1

工具是智能体调用的对象

工具是智能体可以调用的类型化函数（例如 exec、browser、 web_search、message）。OpenClaw 随附一组内置工具， 插件可以注册额外工具。智能体看到的工具是发送到模型 API 的结构化函数定义。
2

Skills 教智能体何时以及如何使用

Skill 是一个注入到系统提示词中的 markdown 文件（SKILL.md）。 Skills 为智能体提供上下文、约束和分步指导，帮助它有效使用工具。 Skills 可以存在于你的工作区、共享文件夹中，也可以随插件一同提供。Skills 参考 | 创建 Skills
3

插件将一切打包在一起

插件是一个可以注册任意能力组合的包： 渠道、模型提供商、工具、Skills、语音、实时转写、 实时语音、媒体理解、图像生成、视频生成、 Web 获取、Web 搜索等。有些插件是核心插件（随 OpenClaw 提供），其他则是外部插件（由社区发布到 npm）。安装和配置插件 | 构建你自己的插件

​
内置工具

这些工具随 OpenClaw 提供，无需安装任何插件即可使用：
工具作用页面
exec / process运行 shell 命令，管理后台进程Exec, Exec 审批
code_execution运行沙箱隔离的远程 Python 分析代码执行
browser控制 Chromium 浏览器（导航、点击、截图）浏览器
web_search / x_search / web_fetch搜索 Web、搜索 X 帖子、获取页面内容Web, Web 获取
read / write / edit工作区中的文件 I/O
apply_patch多 hunk 文件补丁应用补丁
message跨所有渠道发送消息智能体发送
canvas驱动 node Canvas（呈现、求值、快照）
nodes发现并定位已配对设备
cron / gateway管理定时作业；检查、修补、重启或更新 Gateway 网关
image / image_generate分析或生成图像图像生成
music_generate生成音乐曲目音乐生成
video_generate生成视频视频生成
tts一次性文本转语音转换TTS
sessions_* / subagents / agents_list会话管理、Status 和子智能体编排子智能体
session_status轻量级 /status 风格回读和会话模型覆盖设置会话工具
对于图像工作，使用 image 进行分析，使用 image_generate 进行生成或编辑。如果你目标使用 openai/*、google/*、fal/* 或其他非默认图像提供商，请先配置该提供商的认证/API key。 对于音乐工作，使用 music_generate。如果你目标使用 google/*、minimax/* 或其他非默认音乐提供商，请先配置该提供商的认证/API key。 对于视频工作，使用 video_generate。如果你目标使用 qwen/* 或其他非默认视频提供商，请先配置该提供商的认证/API key。 对于由工作流驱动的音频生成，当 ComfyUI 等插件注册了 music_generate 时使用它。 这不同于 tts，后者是文本转语音。 session_status 是会话组中的轻量级 Status/回读工具。 它回答关于当前会话的 /status 风格问题，并且可以选择性设置按会话生效的模型覆盖设置；model=default 会清除该覆盖设置。与 /status 一样，它可以从最新的转录用量条目回填稀疏的 token/缓存计数器以及当前运行时模型标签。 gateway 是仅所有者可用的 Gateway 网关操作运行时工具：
  • config.schema.lookup 用于在编辑前查看一个按路径限定的配置子树
  • config.get 用于获取当前配置快照 + 哈希
  • config.patch 用于带重启的部分配置更新
  • config.apply 仅用于完整配置替换
  • update.run 用于显式自更新 + 重启
对于部分变更，优先使用 config.schema.lookup，然后使用 config.patch。仅在你有意替换整个配置时使用 config.apply。 更全面的配置文档请阅读 配置 和 配置参考。 该工具也会拒绝更改 tools.exec.ask 或 tools.exec.security； 旧版 tools.bash.* 别名会规范化为相同的受保护 exec 路径。

​
插件提供的工具

插件可以注册额外工具。一些示例：
  • Diffs — diff 查看器和渲染器
  • LLM 任务 — 用于结构化输出的仅 JSON LLM 步骤
  • Lobster — 带可恢复审批的类型化工作流运行时
  • 音乐生成 — 由工作流支持的提供商共享的 music_generate 工具
  • OpenProse — markdown 优先的工作流编排
  • Tokenjuice — 压缩嘈杂的 exec 和 bash 工具结果
插件工具仍然使用 api.registerTool(...) 编写，并在 插件清单的 contracts.tools 列表中声明。OpenClaw 会在发现期间捕获经过验证的 工具描述符，并按插件来源和合约缓存它，因此 后续工具规划可以跳过插件运行时加载。工具执行仍会加载 所属插件并调用实时注册的实现。

​
工具配置

​
允许和拒绝列表

通过配置中的 tools.allow / tools.deny 控制智能体可以调用哪些工具。 拒绝始终优先于允许。 
{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}
当显式允许列表解析不到任何可调用工具时，OpenClaw 会失败关闭。 例如，tools.allow: ["query_db"] 只有在已加载插件实际 注册了 query_db 时才有效。如果没有任何内置工具、插件或内置 MCP 工具匹配 允许列表，运行会在模型调用之前停止，而不是继续作为 可能幻觉生成工具结果的纯文本运行。

​
工具配置档

tools.profile 会在应用 allow/deny 之前设置基础允许列表。 按智能体覆盖：agents.list[].tools.profile。
配置档包含内容
full所有核心和可选插件工具；用于更广泛命令/控制访问的不受限基线
codinggroup:fs、group:runtime、group:web、group:sessions、group:memory、cron、image、image_generate、music_generate、video_generate
messaginggroup:messaging、sessions_list、sessions_history、sessions_send、session_status
minimal仅 session_status
tools.profile: "messaging" 会刻意保持较窄范围，用于以渠道为中心的 智能体。它不包含更广泛的命令/控制工具，例如文件系统、运行时、 浏览器、canvas、nodes、cron 和 Gateway 网关控制。使用 tools.profile: "full" 作为更广泛命令/控制访问的不受限基线，然后在需要时通过 tools.allow / tools.deny 裁剪访问权限。
coding 包含轻量 Web 工具（web_search、web_fetch、x_search）， 但不包含完整的浏览器控制工具。浏览器自动化可以驱动真实 会话和已登录配置文件，因此请通过 tools.alsoAllow: ["browser"] 或按智能体设置的 agents.list[].tools.alsoAllow: ["browser"] 显式添加它。
在受限配置档（messaging、minimal）下配置 tools.exec 或 tools.fs 不会隐式扩大该配置档的允许列表。当你希望受限配置档使用这些已配置部分时，请添加显式 tools.alsoAllow 条目（例如 exec 使用 ["exec", "process"]，或 fs 使用 ["read", "write", "edit"]）。当存在配置部分但没有匹配的 alsoAllow 授权时，OpenClaw 会记录启动警告。
coding 和 messaging 配置档还允许在插件键 bundle-mcp 下配置的内置 MCP 工具。 当你希望某个配置档保留其常规内置工具但隐藏所有已配置 MCP 工具时，添加 tools.deny: ["bundle-mcp"]。 minimal 配置档不包含内置 MCP 工具。 示例（默认使用最广的工具表面）： 
{
  tools: {
    profile: "full",
  },
}

​
工具组

在允许/拒绝列表中使用 group:* 简写：
组工具
group:runtimeexec, process, code_execution（bash 可作为 exec 的别名）
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status
group:memorymemory_search, memory_get
group:webweb_search, x_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes
group:agentsagents_list
group:mediaimage, image_generate, music_generate, video_generate, tts
group:openclaw所有内置 OpenClaw 工具（不包括插件工具）
sessions_history 返回一个有边界、经过安全过滤的回忆视图。它会从助手文本中剥离思考标签、<relevant-memories> 脚手架、纯文本工具调用 XML 载荷（包括 <tool_call>...</tool_call>、<function_call>...</function_call>、<tool_calls>...</tool_calls>、<function_calls>...</function_calls> 和被截断的工具调用块）、降级后的工具调用脚手架、泄露的 ASCII/全角模型控制 token，以及格式错误的 MiniMax 工具调用 XML，然后应用遮盖/截断和可能的超大行占位符，而不是充当原始对话记录转储。

​
提供商特定限制

使用 tools.byProvider 为特定提供商限制工具，而不更改全局默认值： 
{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}