> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# apply_patch 도구

# apply\_patch 도구

구조화된 패치 형식을 사용하여 파일 변경 사항을 적용합니다. 이는 단일 `edit` 호출로는 취약해질 수 있는 다중 파일 또는 다중 헝크 편집에 이상적입니다.

이 도구는 하나 이상의 파일 작업을 감싸는 단일 `input` 문자열을 허용합니다:

```
*** 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
```

## 매개변수

* `input` (필수): `*** Begin Patch` 및 `*** End Patch` 를 포함한 전체 패치 내용.

## 참고

* 패치 경로는 상대 경로(워크스페이스 디렉터리 기준)와 절대 경로를 모두 지원합니다.
* `tools.exec.applyPatch.workspaceOnly`의 기본값은 `true`(워크스페이스 내부로 제한)입니다. `apply_patch`가 워크스페이스 디렉터리 외부에 쓰기/삭제를 수행하도록 의도한 경우에만 `false`로 설정하세요.
* 파일 이름을 변경하려면 `*** Update File:` 헝크 내에서 `*** Move to:` 를 사용하십시오.
* `*** End of File` 는 필요 시 EOF 전용 삽입을 표시합니다.
* 실험적이며 기본적으로 비활성화되어 있습니다. `tools.exec.applyPatch.enabled` 로 활성화하십시오.
* OpenAI 전용입니다(OpenAI Codex 포함). 필요 시 `tools.exec.applyPatch.allowModels` 를 통해 모델별로 제한할 수 있습니다.
* 구성은 `tools.exec` 아래에만 있습니다.

## 예제

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "tool": "apply_patch",
  "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
}
```