Chuyển đến nội dung chính

​
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, Tổng quan về bộ nhớ, CLI: bộ nhớ

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

​
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>:
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ụ:

​
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ụ:
Đầ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.

​
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.
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 để biết đầy đủ mô hình cấu hình.

​
Liên quan