> ## 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.

# Wiki

# `openclaw wiki`

Kiểm tra và duy trì kho `memory-wiki`. Được cung cấp bởi plugin `memory-wiki` đi kèm.

Liên quan: [Plugin Memory Wiki](/vi/plugins/memory-wiki), [Tổng quan về bộ nhớ](/vi/concepts/memory), [CLI: bộ nhớ](/vi/cli/memory)

## Các lệnh thường dùng

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki okf import ./knowledge-catalog/okf/bundles/ga4
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki search "tôi nên hỏi ai về Teams?" --mode route-question
openclaw wiki get entity.alpha --from 1 --lines 80

openclaw wiki apply synthesis "Bản tóm tắt Alpha" \
  --body "Nội dung tổng hợp ngắn" \
  --source-id source.alpha

openclaw wiki apply metadata entity.alpha \
  --source-id source.alpha \
  --status review \
  --question "Vẫn còn hoạt động?"

openclaw wiki bridge import
openclaw wiki unsafe-local import
openclaw wiki chatgpt import --export ./chatgpt-export --dry-run
openclaw wiki chatgpt rollback <run-id>

openclaw wiki obsidian status
openclaw wiki obsidian search "alpha"
openclaw wiki obsidian open syntheses/alpha-summary.md
openclaw wiki obsidian command workspace:quick-switcher
openclaw wiki obsidian daily
```

## Chọn tác tử

Khi `plugins.entries.memory-wiki.config.vault.scope` là `agent`, hãy chọn
kho bằng tùy chọn cấp cao nhất `--agent <id>`:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw wiki --agent support status
openclaw wiki --agent support search "refund policy"
openclaw wiki --agent marketing ingest ./campaign-notes.md
```

Trong thiết lập có nhiều tác tử đã cấu hình, `--agent` là bắt buộc đối với các thao tác CLI
để lệnh không thể đọc hoặc ghi một kho mặc định tùy ý. Nếu
chỉ cấu hình một tác tử, tác tử đó vẫn là mặc định. ID tác tử không xác định
sẽ gây lỗi trước khi thao tác trên kho bắt đầu. Tùy chọn này không thay đổi
đường dẫn đã chọn khi `vault.scope` là `global`.

Các máy khách Gateway tuân theo cùng quy tắc: truyền `agentId` trong các yêu cầu `wiki.*`
dựa trên kho ở thiết lập đa tác tử có phạm vi theo tác tử. ID bị thiếu hoặc không xác định là một
lỗi. Các lượt tác tử, công cụ wiki, phần bổ sung kho ngữ liệu bộ nhớ và bản tóm lược lời nhắc
đã biên dịch đã mang sẵn ngữ cảnh tác tử thời gian chạy đang hoạt động.

## Các lệnh

### `wiki status`

Hiển thị chế độ và phạm vi của kho, tác tử đã phân giải, tình trạng hoạt động và khả năng sử dụng CLI Obsidian. Hãy dùng lệnh này trước tiên để kiểm tra xem kho dự kiến đã được khởi tạo, chế độ cầu nối có hoạt động ổn định hay tích hợp Obsidian có khả dụng hay không.

Khi chế độ cầu nối đang hoạt động và được cấu hình để đọc các tạo tác bộ nhớ, lệnh này truy vấn Gateway đang chạy để thấy cùng ngữ cảnh plugin bộ nhớ đang hoạt động như bộ nhớ của tác tử/thời gian chạy.

### `wiki doctor`

Chạy các bước kiểm tra tình trạng wiki và báo cáo các cách khắc phục có thể thực hiện. Thoát với mã khác 0 khi không hoạt động ổn định.

Khi chế độ cầu nối đang hoạt động và được cấu hình để đọc các tạo tác bộ nhớ, lệnh này truy vấn Gateway đang chạy trước khi tạo báo cáo. Các thao tác nhập cầu nối bị vô hiệu hóa và cấu hình cầu nối không đọc tạo tác bộ nhớ vẫn chạy cục bộ/ngoại tuyến.

Các vấn đề thường gặp:

* chế độ cầu nối được bật nhưng không có tạo tác bộ nhớ công khai
* bố cục kho không hợp lệ hoặc bị thiếu
* thiếu CLI Obsidian bên ngoài khi dự kiến sử dụng chế độ Obsidian

### `wiki init`

Tạo bố cục kho wiki và các trang khởi đầu, bao gồm chỉ mục cấp cao nhất và thư mục bộ nhớ đệm.

### `wiki ingest <path>`

Nhập tệp Markdown hoặc văn bản cục bộ vào thư mục `sources/` của wiki dưới dạng trang nguồn. `<path>` phải là đường dẫn tệp cục bộ; hiện chưa hỗ trợ nhập từ URL. Tệp nhị phân sẽ bị từ chối.

Các trang nguồn đã nhập mang frontmatter về nguồn gốc (`sourceType: local-file`, `sourcePath`, `ingestedAt`). Thao tác nhập luôn biên dịch lại kho sau đó.

Cờ: `--title <title>` ghi đè tiêu đề nguồn (mặc định: được suy ra từ tên tệp).

### `wiki okf import <path>`

Nhập một gói Open Knowledge Format đã giải nén vào các trang khái niệm của wiki.

Trình nhập đọc mọi tài liệu khái niệm `.md` không dành riêng trong cây thư mục OKF, yêu cầu trường `type` không được để trống và coi các giá trị `type` OKF không xác định là khái niệm chung. Các tệp `index.md` và `log.md` OKF dành riêng không được nhập dưới dạng khái niệm.

Các trang đã nhập được làm phẳng dưới `concepts/` để những luồng biên dịch, tìm kiếm, truy xuất, tạo bản tóm lược và bảng điều khiển hiện có của wiki nhận diện chúng ngay lập tức. ID khái niệm OKF gốc, `type`, `resource`, `tags`, dấu thời gian, đường dẫn nguồn và toàn bộ frontmatter được giữ nguyên trong frontmatter của trang. Các liên kết Markdown OKF nội bộ được viết lại để trỏ đến những trang wiki đã tạo; liên kết hỏng hoặc bên ngoài được giữ nguyên. Thao tác nhập luôn biên dịch lại kho sau đó.

Ví dụ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw wiki okf import ./bundles/ga4
openclaw wiki okf import ./bundles/ga4 --json
openclaw wiki search "BigQuery Table" --mode source-evidence --json
openclaw wiki get <path-from-json-result>
```

### `wiki compile`

Tạo lại chỉ mục, khối liên quan, bảng điều khiển và ảnh chụp truy vấn/lời nhắc đã biên dịch. Ảnh chụp được lưu bền vững trong trạng thái plugin SQLite dùng chung của OpenClaw và được giữ trong bộ nhớ để chiếu lời nhắc đồng bộ; thao tác này không tạo tệp bộ nhớ đệm trong kho.

Nếu `render.createDashboards` được bật, quá trình biên dịch cũng làm mới các trang báo cáo.

### `wiki lint`

Kiểm tra quy chuẩn của kho và ghi báo cáo bao gồm:

* các vấn đề cấu trúc (liên kết hỏng, ID bị thiếu/trùng lặp, thiếu loại trang hoặc tiêu đề, frontmatter không hợp lệ)
* các khoảng trống về nguồn gốc (thiếu ID nguồn, thiếu nguồn gốc nhập)
* các mâu thuẫn (mâu thuẫn được gắn cờ, các khẳng định xung đột)
* các câu hỏi còn bỏ ngỏ
* các trang và khẳng định có độ tin cậy thấp
* các trang và khẳng định đã lỗi thời

Chạy lệnh này sau các cập nhật wiki đáng kể.

### `wiki search <query>`

Tìm kiếm nội dung wiki. Hành vi phụ thuộc vào cấu hình:

* `search.backend`: `shared` hoặc `local`
* `search.corpus`: `wiki`, `memory` hoặc `all`
* `--mode`: `auto`, `find-person`, `route-question`, `source-evidence` hoặc `raw-claim`

Dùng `wiki search` cho việc xếp hạng và theo dõi nguồn gốc dành riêng cho wiki. Đối với một lượt truy xuất chung trên phạm vi rộng, hãy ưu tiên `openclaw memory search` khi plugin bộ nhớ đang hoạt động cung cấp tìm kiếm dùng chung.

Các chế độ tìm kiếm:

* `find-person`: bí danh, tên định danh, tài khoản mạng xã hội, ID chuẩn và trang cá nhân
* `route-question`: gợi ý về người nên hỏi/trường hợp sử dụng phù hợp nhất và ngữ cảnh mối quan hệ
* `source-evidence`: trang nguồn và các trường bằng chứng có cấu trúc
* `raw-claim`: văn bản khẳng định có cấu trúc cùng siêu dữ liệu khẳng định/bằng chứng

Ví dụ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw wiki search "bgroux" --mode find-person
openclaw wiki search "ai biết về việc triển khai Teams?" --mode route-question
openclaw wiki search "maintainer-whois" --mode source-evidence
openclaw wiki search "strong route Teams" --mode raw-claim --json
```

Đầu ra văn bản bao gồm các dòng `Claim:` và `Evidence:` khi kết quả khớp với một khẳng định có cấu trúc. Đầu ra JSON còn cung cấp `matchedClaimId`, `matchedClaimStatus`, `matchedClaimConfidence`, `evidenceKinds` và `evidenceSourceIds` để tác tử truy vấn sâu hơn.

### `wiki get <lookup>`

Đọc một trang wiki theo ID hoặc đường dẫn tương đối.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw wiki get entity.alpha
openclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80
```

### `wiki apply`

Áp dụng các thay đổi hẹp mà không chỉnh sửa trang theo kiểu tự do:

* `apply synthesis <title>`: tạo hoặc làm mới trang tổng hợp với nội dung tóm tắt được quản lý
* `apply metadata <lookup>`: cập nhật siêu dữ liệu trên một trang hiện có

Cả hai đều chấp nhận `--source-id`, `--contradiction`, `--question` (mỗi tùy chọn có thể lặp lại), `--confidence <n>` (0-1) và `--status <status>`. `apply metadata` cũng chấp nhận `--clear-confidence` để xóa giá trị độ tin cậy đã lưu. Đây là cách được hỗ trợ để phát triển các trang wiki mà vẫn giữ nguyên các khối được tạo và quản lý.

### `wiki bridge import`

Nhập các tạo tác bộ nhớ công khai từ plugin bộ nhớ đang hoạt động vào các trang nguồn dựa trên cầu nối. Dùng lệnh này trong chế độ `bridge` để đưa các tạo tác bộ nhớ mới nhất đã xuất vào kho wiki.

Đối với các thao tác đọc tạo tác cầu nối đang hoạt động, CLI định tuyến việc nhập qua Gateway RPC để sử dụng ngữ cảnh plugin bộ nhớ thời gian chạy. Nếu thao tác nhập cầu nối bị vô hiệu hóa hoặc tính năng đọc tạo tác bị tắt, lệnh vẫn giữ hành vi không nhập cục bộ/ngoại tuyến. Việc làm mới chỉ mục sau khi nhập được kiểm soát bởi `ingest.autoCompile`.

### `wiki unsafe-local import`

Nhập từ các đường dẫn cục bộ được cấu hình rõ ràng (`unsafeLocal.paths`) trong chế độ `unsafe-local`. Có chủ đích mang tính thử nghiệm và chỉ dùng trên cùng một máy. Việc làm mới chỉ mục sau khi nhập được kiểm soát bởi `ingest.autoCompile`.

### `wiki chatgpt import`

Nhập bản xuất ChatGPT vào các trang nguồn wiki dạng bản nháp.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw wiki chatgpt import --export ./chatgpt-export
openclaw wiki chatgpt import --export ./conversations.json --dry-run
```

| Cờ                | Mặc định   | Mô tả                                                               |
| ----------------- | ---------- | ------------------------------------------------------------------- |
| `--export <path>` | (bắt buộc) | Thư mục xuất ChatGPT hoặc đường dẫn `conversations.json`.           |
| `--dry-run`       | `false`    | Xem trước số lượng đã tạo/đã cập nhật/đã bỏ qua mà không ghi trang. |

Một thao tác nhập không phải chạy thử làm thay đổi bất kỳ trang nào sẽ ghi lại ID lượt nhập, được in trong phần tóm tắt và cần thiết để hoàn tác.

### `wiki chatgpt rollback <run-id>`

Hoàn tác một lượt nhập ChatGPT đã áp dụng trước đó, xóa các trang mà lượt nhập đã tạo và khôi phục các trang mà lượt nhập đã ghi đè. Không thực hiện gì (và báo cáo `alreadyRolledBack`) nếu lượt nhập đã được hoàn tác.

### `wiki obsidian ...`

Các lệnh hỗ trợ Obsidian dành cho kho chạy ở chế độ thân thiện với Obsidian: `status`, `search`, `open`, `command`, `daily`. Các lệnh này yêu cầu CLI `obsidian` chính thức có trong `PATH` khi `obsidian.useOfficialCli` được bật.

Quá trình xác thực cấu hình từ chối `obsidian.useOfficialCli: true` khi
`vault.scope` là `agent` vì `obsidian.vaultName` là một thiết lập toàn cục,
không phải ánh xạ theo từng tác tử. Khả năng kết xuất Markdown thân thiện với Obsidian vẫn
khả dụng.

## Hướng dẫn sử dụng thực tế

* Dùng `wiki search` + `wiki get` khi nguồn gốc và định danh trang là quan trọng.
* Dùng `wiki apply` thay vì chỉnh sửa thủ công các phần được tạo và quản lý.
* Dùng `wiki lint` trước khi tin tưởng nội dung mâu thuẫn hoặc có độ tin cậy thấp.
* Dùng `wiki compile` sau khi nhập hàng loạt hoặc thay đổi nguồn nếu muốn có ngay bảng điều khiển và bản tóm lược đã biên dịch mới nhất.
* Dùng `wiki okf import` khi danh mục dữ liệu, bản xuất tài liệu hoặc pipeline làm giàu dữ liệu của tác tử đã tạo ra các gói Markdown OKF.
* Dùng `wiki bridge import` khi chế độ cầu nối phụ thuộc vào các tạo tác bộ nhớ mới được xuất.

## Liên kết cấu hình

Hành vi của `openclaw wiki` được định hình bởi:

* `plugins.entries.memory-wiki.config.vaultMode`
* `plugins.entries.memory-wiki.config.vault.scope`
* `plugins.entries.memory-wiki.config.vault.path`
* `plugins.entries.memory-wiki.config.search.backend`
* `plugins.entries.memory-wiki.config.search.corpus`
* `plugins.entries.memory-wiki.config.bridge.*`
* `plugins.entries.memory-wiki.config.obsidian.*`
* `plugins.entries.memory-wiki.config.ingest.autoCompile`
* `plugins.entries.memory-wiki.config.render.*`
* `plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt`

Xem [Plugin Memory Wiki](/vi/plugins/memory-wiki) để biết đầy đủ mô hình cấu hình.

## Liên quan

* [Tài liệu tham khảo CLI](/vi/cli)
* [Wiki bộ nhớ](/vi/plugins/memory-wiki)