OpenClawSkills
GitHub
Tools & Skills • TutorialHeader.readTime

apply_patch Tool

Apply multi-file patches with the apply_patch tool

Apply file changes using a structured patch format. This is ideal for multi-file

or multi-hunk edits where a single ''edit'' call would be brittle.

The tool accepts a single ''input'' string that wraps one or more file operations:

Terminal
*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@
-old line
+new line
*** Delete File: obsolete.txt
*** End Patch
Tutorial.step

Parameters

- ''input'' (required): Full patch contents including ''*** Begin Patch'' and ''*** End Patch''.

Tutorial.step

Notes

- Paths are resolved relative to the workspace root.

- Use ''*** Move to:'' within an ''*** Update File:'' hunk to rename files.

- ''*** End of File'' marks an EOF-only insert when needed.

- Experimental and disabled by default. Enable with ''tools.exec.applyPatch.enabled''.

- OpenAI-only (including OpenAI Codex). Optionally gate by model via

- ''tools.exec.applyPatch.allowModels''.

- Config is only under ''tools.exec''.

Tutorial.step

Example

Json
'{'
  "tool": "apply_patch",
  "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
'}'