openclaw wiki
Przeglądaj i utrzymuj skarbiec memory-wiki. Funkcję zapewnia dołączony plugin memory-wiki.
Powiązane: Plugin Memory Wiki, Omówienie pamięci, CLI: pamięć
Typowe polecenia
Wybór agenta
Gdyplugins.entries.memory-wiki.config.vault.scope ma wartość agent, wybierz
skarbiec za pomocą opcji najwyższego poziomu --agent <id>:
--agent jest wymagana w operacjach
CLI, aby polecenie nie mogło odczytać ani zapisać dowolnego domyślnego skarbca.
Jeśli skonfigurowano tylko jednego agenta, pozostaje on agentem domyślnym.
Nieznane identyfikatory agentów powodują błąd przed rozpoczęciem operacji na
skarbcu. Opcja nie zmienia wybranej ścieżki, gdy vault.scope ma wartość
global.
Klienci Gateway stosują tę samą regułę: w konfiguracji wieloagentowej ze
skarbcem przypisanym do agenta przekazuj agentId w żądaniach wiki.*
korzystających ze skarbca. Brakujący lub nieznany identyfikator jest błędem.
Tury agenta, narzędzia wiki, uzupełnienia korpusu pamięci i skompilowane skróty
promptów już zawierają kontekst aktywnego agenta środowiska wykonawczego.
Polecenia
wiki status
Wyświetla tryb i zakres skarbca, rozpoznanego agenta, stan oraz dostępność CLI Obsidian. Użyj tego polecenia w pierwszej kolejności, aby sprawdzić, czy właściwy skarbiec został zainicjowany, tryb mostu działa prawidłowo lub integracja z Obsidian jest dostępna.
Gdy tryb mostu jest aktywny i skonfigurowany do odczytu artefaktów pamięci, polecenie wysyła zapytanie do działającego Gateway, dzięki czemu widzi ten sam kontekst aktywnego pluginu pamięci co pamięć agenta lub środowiska wykonawczego.
wiki doctor
Uruchamia kontrole stanu wiki i zgłasza możliwe do wykonania poprawki. Kończy działanie z niezerowym kodem, gdy wykryje problemy.
Gdy tryb mostu jest aktywny i skonfigurowany do odczytu artefaktów pamięci, polecenie wysyła zapytanie do działającego Gateway przed utworzeniem raportu. Wyłączone importy mostu i konfiguracje mostu, które nie odczytują artefaktów pamięci, pozostają lokalne i działają bez połączenia.
Typowe problemy:
- tryb mostu włączony bez publicznych artefaktów pamięci
- nieprawidłowy lub brakujący układ skarbca
- brak zewnętrznego CLI Obsidian, gdy oczekiwany jest tryb Obsidian
wiki init
Tworzy układ skarbca wiki i strony początkowe, w tym indeksy najwyższego poziomu i katalogi pamięci podręcznej.
wiki ingest <path>
Importuje lokalny plik Markdown lub tekstowy do folderu sources/ wiki jako stronę źródłową. <path> musi być ścieżką do pliku lokalnego; obecnie import z adresu URL nie jest dostępny. Odrzuca pliki binarne.
Zaimportowane strony źródłowe zawierają metadane pochodzenia we frontmatter (sourceType: local-file, sourcePath, ingestedAt). Po imporcie skarbiec jest zawsze ponownie kompilowany.
Flagi: --title <title> zastępuje tytuł źródła (domyślnie jest on wyprowadzany z nazwy pliku).
wiki okf import <path>
Importuje rozpakowany pakiet Open Knowledge Format do stron pojęć wiki.
Importer odczytuje każdy niezastrzeżony dokument pojęcia .md w drzewie katalogów OKF, wymaga niepustego pola type, a nieznane wartości type OKF traktuje jako ogólne pojęcia. Zastrzeżone pliki OKF index.md i log.md nie są importowane jako pojęcia.
Zaimportowane strony są umieszczane bezpośrednio w concepts/, dzięki czemu istniejące procesy kompilowania, wyszukiwania, pobierania, tworzenia skrótów i pulpitów wiki natychmiast je uwzględniają. Oryginalny identyfikator pojęcia OKF, type, resource, tags, znacznik czasu, ścieżka źródłowa i pełne frontmatter zostają zachowane we frontmatter strony. Wewnętrzne odnośniki Markdown OKF są przepisywane tak, aby wskazywały wygenerowane strony wiki; uszkodzone lub zewnętrzne odnośniki pozostają bez zmian. Po imporcie skarbiec jest zawsze ponownie kompilowany.
Przykłady:
wiki compile
Przebudowuje indeksy, bloki powiązań, pulpity i skompilowane skróty. Zapisuje stabilne artefakty przeznaczone do odczytu maszynowego w:
.openclaw-wiki/cache/agent-digest.json.openclaw-wiki/cache/claims.jsonl
render.createDashboards jest włączona, kompilacja odświeża również strony raportów.
wiki lint
Sprawdza skarbiec i zapisuje raport obejmujący:
- problemy strukturalne (uszkodzone odnośniki, brakujące lub zduplikowane identyfikatory, brak typu lub tytułu strony, nieprawidłowe frontmatter)
- braki w informacjach o pochodzeniu (brakujące identyfikatory źródeł, brakujące informacje o pochodzeniu importu)
- sprzeczności (oznaczone sprzeczności, kolidujące twierdzenia)
- otwarte pytania
- strony i twierdzenia o niskim poziomie pewności
- nieaktualne strony i twierdzenia
wiki search <query>
Przeszukuje zawartość wiki. Zachowanie zależy od konfiguracji:
search.backend:sharedlublocalsearch.corpus:wiki,memoryluball--mode:auto,find-person,route-question,source-evidencelubraw-claim
wiki search, gdy istotne są ranking właściwy dla wiki i informacje o pochodzeniu. Aby wykonać jedno szerokie wyszukiwanie we współdzielonych zasobach pamięci, wybierz openclaw memory search, jeśli aktywny plugin pamięci udostępnia wyszukiwanie współdzielone.
Tryby wyszukiwania:
find-person: aliasy, nazwy użytkowników, profile społecznościowe, kanoniczne identyfikatory i strony osóbroute-question: wskazówki dotyczące tego, kogo zapytać i do czego najlepiej wykorzystać daną osobę, oraz kontekst relacjisource-evidence: strony źródłowe i ustrukturyzowane pola dowodówraw-claim: ustrukturyzowany tekst twierdzenia z metadanymi twierdzenia i dowodów
Claim: i Evidence:, gdy wynik pasuje do ustrukturyzowanego twierdzenia. Dane wyjściowe JSON dodatkowo udostępniają pola matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds i evidenceSourceIds, umożliwiające agentowi szczegółową analizę.
wiki get <lookup>
Odczytuje stronę wiki według identyfikatora lub ścieżki względnej.
wiki apply
Stosuje ściśle określone zmiany bez swobodnego modyfikowania stron:
apply synthesis <title>: tworzy lub odświeża stronę syntezy z zarządzaną treścią podsumowaniaapply metadata <lookup>: aktualizuje metadane istniejącej strony
--source-id, --contradiction, --question (każde może być powtarzane), --confidence <n> (0–1) i --status <status>. apply metadata akceptuje również --clear-confidence, aby usunąć zapisaną wartość poziomu pewności. Jest to obsługiwany sposób rozwijania stron wiki, który zachowuje integralność zarządzanych, wygenerowanych bloków.
wiki bridge import
Importuje publiczne artefakty pamięci z aktywnego pluginu pamięci do stron źródłowych opartych na moście. Użyj tego polecenia w trybie bridge, aby pobrać najnowsze wyeksportowane artefakty pamięci do skarbca wiki.
W przypadku aktywnego odczytu artefaktów mostu CLI przekierowuje import przez RPC Gateway, aby użyć kontekstu pluginu pamięci środowiska wykonawczego. Jeśli importy mostu są wyłączone lub odczyt artefaktów jest wyłączony, polecenie zachowuje lokalne zachowanie bez połączenia, które nie importuje żadnych elementów. Odświeżanie indeksu po imporcie jest kontrolowane przez ingest.autoCompile.
wiki unsafe-local import
Importuje dane z jawnie skonfigurowanych ścieżek lokalnych (unsafeLocal.paths) w trybie unsafe-local. Funkcja jest celowo eksperymentalna i przeznaczona wyłącznie do użycia na tej samej maszynie. Odświeżanie indeksu po imporcie jest kontrolowane przez ingest.autoCompile.
wiki chatgpt import
Importuje eksport ChatGPT do roboczych stron źródłowych wiki.
Import bez opcji
--dry-run, który zmienia dowolną stronę, zapisuje identyfikator przebiegu importu, wyświetlany w podsumowaniu i wymagany do wycofania zmian.
wiki chatgpt rollback <run-id>
Wycofuje wcześniej zastosowany przebieg importu ChatGPT, usuwając utworzone przez niego strony i przywracając strony, które nadpisał. Nie wykonuje żadnych działań (i zgłasza alreadyRolledBack), jeśli przebieg został już wycofany.
wiki obsidian ...
Polecenia pomocnicze Obsidian dla skarbców działających w trybie zgodnym z Obsidian: status, search, open, command, daily. Gdy opcja obsidian.useOfficialCli jest włączona, wymagają oficjalnego CLI obsidian dostępnego w PATH.
Walidacja konfiguracji odrzuca obsidian.useOfficialCli: true, gdy
vault.scope ma wartość agent, ponieważ obsidian.vaultName jest jednym
ustawieniem globalnym, a nie mapowaniem dla poszczególnych agentów.
Renderowanie Markdown zgodne z Obsidian pozostaje dostępne.
Praktyczne wskazówki dotyczące użycia
- Używaj
wiki searchiwiki get, gdy istotne są pochodzenie i tożsamość strony. - Używaj
wiki applyzamiast ręcznie edytować zarządzane, wygenerowane sekcje. - Używaj
wiki lint, zanim zaufasz sprzecznej zawartości lub zawartości o niskim poziomie pewności. - Używaj
wiki compilepo imporcie zbiorczym lub zmianach źródeł, gdy potrzebujesz natychmiast odświeżonych pulpitów i skompilowanych skrótów. - Używaj
wiki okf import, gdy katalog danych, eksport dokumentacji lub potok wzbogacania agenta już generuje pakiety Markdown OKF. - Używaj
wiki bridge import, gdy tryb mostu zależy od nowo wyeksportowanych artefaktów pamięci.
Powiązania z konfiguracją
Na zachowanieopenclaw wiki wpływają:
plugins.entries.memory-wiki.config.vaultModeplugins.entries.memory-wiki.config.vault.scopeplugins.entries.memory-wiki.config.vault.pathplugins.entries.memory-wiki.config.search.backendplugins.entries.memory-wiki.config.search.corpusplugins.entries.memory-wiki.config.bridge.*plugins.entries.memory-wiki.config.obsidian.*plugins.entries.memory-wiki.config.ingest.autoCompileplugins.entries.memory-wiki.config.render.*plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt