英文 Apply Patch
约 2 分钟
- 原始链接：https://docs.openclaw.ai/tools/apply-patch
- 来源章节：5. 官方文档：工具、技能、插件与自动化
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/tools/apply-patch
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
apply_patch 工具 - OpenClaw
[OpenClaw主页！图片1：深色徽标！图片2：深色徽标](http://docs.openclaw.ai/)
英语
搜索...
Ctrl+K
搜索...
导航
工具
apply_patch工具
概述
插件
#####技能
自动化和任务
工具
- apply_patch工具
- 网页浏览器
- 网络工具
- 顺便说一句附带问题
- 代码执行
- 差异
- 提升模式
- 执行工具
- 执行批准
- [图像生成](http://docs.openclaw.ai/tools/image- Generation)
- LLM任务
- 龙虾
- 工具循环检测
- PDF工具
- 反应
- 思维水平
代理协调
在此页面上
工具
apply_patch 工具
apply_patch工具
使用结构化补丁格式应用文件更改。这对于多文件或多块编辑来说是理想的选择，其中单个“edit”调用会很脆弱。该工具接受包装一个或多个文件操作的单个“input”字符串：
*** 开始补丁
*** 添加文件：path/to/file.txt
+1号线
+第2行
*** 更新文件：src/app.ts
@@
-旧线
+新行
*** 删除文件：obsolete.txt
*** 结束补丁
参数
input（必填）：完整补丁内容，包括*** Begin Patch和*** End Patch。
注释
- 补丁路径支持相对路径（来自工作空间目录）和绝对路径。
tools.exec.applyPatch.workspaceOnly默认为true（包含工作空间）。仅当您有意希望“apply_patch”在工作区目录之外写入/删除时，才将其设置为“false”。- 在“***更新文件：”块中使用“***移动到：”来重命名文件。
*** 文件结尾在需要时标记仅 EOF 插入。- 默认情况下适用于 OpenAI 和 OpenAI Codex 模型。设置“tools.exec.applyPatch.enabled: false”以禁用它。
- 可选择通过“tools.exec.applyPatch.allowModels”按模型进行门控。
- 配置仅位于
tools.exec下。
示例
{
“工具”：“应用补丁”，
"input": "*** 开始补丁\n*** 更新文件: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** 结束补丁"
}Ctrl+I