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

# công cụ apply_patch

Áp dụng các thay đổi tệp bằng định dạng bản vá có cấu trúc. Cách này lý tưởng cho các chỉnh sửa trên nhiều tệp
hoặc nhiều đoạn, khi một lệnh gọi `edit` duy nhất dễ bị lỗi.

Công cụ chấp nhận một chuỗi `input` duy nhất bao bọc một hoặc nhiều thao tác với tệp:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@ optional change context
-old line
+new line
*** Delete File: obsolete.txt
*** End Patch
```

## Tham số

* `input` (bắt buộc): Toàn bộ nội dung bản vá, bao gồm `*** Begin Patch` và `*** End Patch`.

## Lưu ý

* Đường dẫn trong bản vá hỗ trợ đường dẫn tương đối (tính từ thư mục không gian làm việc) và đường dẫn tuyệt đối.
* `tools.exec.applyPatch.workspaceOnly` mặc định là `true` (chỉ trong không gian làm việc). Chỉ đặt thành `false` nếu bạn chủ ý muốn `apply_patch` ghi/xóa bên ngoài thư mục không gian làm việc.
* Sử dụng `*** Move to:` trong một đoạn `*** Update File:` để đổi tên tệp.
* `*** End of File` đánh dấu thao tác chèn chỉ tại cuối tệp khi cần.
* Được bật mặc định cho mọi mô hình. Đặt `tools.exec.applyPatch.enabled: false`
  để tắt, hoặc giới hạn cho các mô hình cụ thể bằng
  `tools.exec.applyPatch.allowModels` (chấp nhận mã định danh thô như `gpt-5.4` hoặc mã định danh đầy đủ
  như `openai/gpt-5.4`).
* Cấu hình nằm trong `tools.exec.applyPatch.*`.

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

## Liên quan

<CardGroup cols={2}>
  <Card title="Bản khác biệt" href="/vi/tools/diffs" icon="code-compare">
    Trình xem bản khác biệt chỉ đọc để trình bày các thay đổi.
  </Card>

  <Card title="Công cụ Exec" href="/vi/tools/exec" icon="terminal">
    Thực thi lệnh shell từ tác tử.
  </Card>

  <Card title="Thực thi mã" href="/vi/tools/code-execution" icon="square-code">
    Phân tích Python từ xa trong môi trường hộp cát bằng xAI.
  </Card>
</CardGroup>