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

# Công cụ apply_patch

# Công cụ apply\_patch

Áp dụng thay đổi file bằng định dạng bản vá có cấu trúc. Điều này lý tưởng cho các chỉnh sửa nhiều file hoặc nhiều đoạn, nơi một lệnh `edit` đơn lẻ có thể không đủ linh hoạt.

Công cụ này chấp nhận một chuỗi `input` duy nhất bao gồm một hoặc nhiều thao tác trên file:

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

## Tham số

* `input` (bắt buộc): Nội dung đầy đủ của bản vá bao gồm `*** Begin Patch` và `*** End Patch`.

## Lưu ý

* Đường dẫn trong bản vá hỗ trợ cả đường dẫn tương đối (từ thư mục workspace) và đường dẫn tuyệt đối.
* `tools.exec.applyPatch.workspaceOnly` mặc định là `true` (chỉ trong workspace). Chỉ đặt thành `false` nếu bạn thực sự muốn `apply_patch` ghi/xóa ngoài thư mục workspace.
* Sử dụng `*** Move to:` trong một đoạn `*** Update File:` để đổi tên file.
* `*** End of File` đánh dấu một chèn chỉ EOF khi cần thiết.
* Tính năng thử nghiệm và bị vô hiệu hóa theo mặc định. Kích hoạt với `tools.exec.applyPatch.enabled`.
* Chỉ dành cho OpenAI (bao gồm OpenAI Codex). Có thể giới hạn theo mô hình qua `tools.exec.applyPatch.allowModels`.
* Cấu hình chỉ nằm dưới `tools.exec`.

## Ví dụ

```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"
}
```