Przejdź do głównej treści
Dołączony Plugin oc-path dodaje CLI openclaw path dla schematu adresowania plików obszaru roboczego oc://. Jest dostarczany w repozytorium OpenClaw w extensions/oc-path/, ale jest opcjonalny — instalacja/kompilacja pozostawia go nieaktywnym, dopóki go nie włączysz. Adresy oc:// wskazują pojedynczy liść (lub zestaw liści z symbolem wieloznacznym) wewnątrz pliku obszaru roboczego. Plugin obsługuje dziś cztery rodzaje plików:
  • markdown (.md, .mdx): frontmatter, sekcje, elementy, pola
  • jsonc (.jsonc, .json5, .json): komentarze i formatowanie zachowane
  • jsonl (.jsonl, .ndjson): rekordy zorientowane na wiersze
  • yaml (.yaml, .yml, .lobster): węzły map/sekwencji/skalarów przez interfejs API dokumentu YAML
Osoby hostujące samodzielnie i rozszerzenia edytorów używają CLI do odczytu lub zapisu pojedynczego liścia bez bezpośredniego skryptowania względem SDK; agenci i hooki traktują go jako deterministyczną warstwę bazową, dzięki czemu rundy zapisu i odczytu z wiernością bajtową oraz strażnik sentinela redakcji działają jednolicie dla wszystkich rodzajów.

​
Dlaczego warto go włączyć

Włącz oc-path, gdy chcesz, aby skrypty, hooki lub lokalne narzędzia agentowe wskazywały precyzyjny fragment stanu obszaru roboczego bez wymyślania parsera dla każdego kształtu pliku. Pojedynczy adres oc:// może nazwać klucz frontmatter w Markdown, element sekcji, liść konfiguracji JSONC, pole zdarzenia JSONL albo krok przepływu pracy YAML. Ma to znaczenie w przepływach pracy maintainerów, gdzie zmiana powinna być mała, audytowalna i powtarzalna: sprawdź jedną wartość, znajdź pasujące rekordy, wykonaj próbny zapis, a potem zastosuj tylko ten liść, pozostawiając komentarze, zakończenia wierszy i pobliskie formatowanie bez zmian. Utrzymanie tego jako opcjonalnego Pluginu daje zaawansowanym użytkownikom warstwę adresowania bez wprowadzania zależności parserów ani powierzchni CLI do core dla instalacji, które nigdy jej nie potrzebują. Typowe powody włączenia:
  • Lokalna automatyzacja: skrypty powłoki mogą rozwiązać lub zaktualizować jedną wartość obszaru roboczego za pomocą openclaw path … --json, zamiast utrzymywać osobny kod parsowania Markdown, JSONC, JSONL i YAML.
  • Edycje widoczne dla agenta: agent może pokazać różnicę próbnego zapisu dla jednego zaadresowanego liścia przed zapisem, co łatwiej przejrzeć niż swobodny przepis pliku.
  • Integracje edytora: edytor może zmapować oc://AGENTS.md/tools/gh na dokładny węzeł Markdown i numer wiersza bez zgadywania na podstawie tekstu nagłówka.
  • Diagnostyka: emit przepuszcza plik przez parser i emiter tam i z powrotem, więc możesz sprawdzić, czy dany rodzaj pliku jest stabilny bajtowo, zanim oprzesz się na automatycznych edycjach.
Konkretne przykłady: 
# Is the GitHub plugin enabled in this config?
openclaw path resolve 'oc://config.jsonc/plugins/github/enabled' --json

# Which tool-call names appear in this session log?
openclaw path find 'oc://session.jsonl/[event=tool_call]/name' --json

# What bytes would this tiny config edit write?
openclaw path set 'oc://config.jsonc/plugins/github/enabled' 'true' --dry-run
Plugin celowo nie jest właścicielem semantyki wyższego poziomu. Pluginy pamięci nadal odpowiadają za zapisy w pamięci, polecenia konfiguracji nadal odpowiadają za pełne zarządzanie konfiguracją, a logika LKG nadal odpowiada za odtwarzanie/promowanie. oc-path to wąska warstwa adresowania i zachowujących bajty operacji na plikach, wokół której te narzędzia wyższego poziomu mogą budować.

​
Gdzie działa

Plugin działa w procesie wewnątrz CLI openclaw na hoście, na którym wywołujesz polecenie. Nie wymaga działającego Gateway i nie otwiera żadnych gniazd sieciowych — każdy czasownik jest czystą transformacją pliku, który wskażesz. Metadane Pluginu znajdują się w extensions/oc-path/openclaw.plugin.json: 
{
  "id": "oc-path",
  "name": "OC Path",
  "activation": {
    "onStartup": false,
    "onCommands": ["path"]
  },
  "commandAliases": [{ "name": "path", "kind": "cli" }]
}
onStartup: false utrzymuje Plugin poza gorącą ścieżką Gateway. onCommands: ["path"] informuje CLI, aby leniwie załadować Plugin przy pierwszym uruchomieniu openclaw path …, więc instalacje, które nigdy nie używają tego czasownika, nie ponoszą kosztu.

​
Włączanie

openclaw plugins enable oc-path
Uruchom ponownie Gateway (jeśli go używasz), aby migawka manifestu uwzględniła nowy stan. Proste wywołania openclaw path działają od razu na tym samym hoście — CLI ładuje Plugin na żądanie. Wyłącz za pomocą: 
openclaw plugins disable oc-path

​
Zależności

Wszystkie zależności parserów są lokalne dla Pluginu — włączenie oc-path nie wciąga nowych pakietów do runtime core:
ZależnośćCel
commanderOkablowanie podpoleceń dla resolve, find, set, validate, emit.
jsonc-parserParsowanie JSONC + edycje liści z zachowaniem komentarzy i końcowych przecinków.
markdown-itTokenizacja Markdown dla modelu sekcji / elementów / pól.
yamlParsowanie / emitowanie / edycja Document YAML z zachowaniem komentarzy i stylu przepływowego.
JSONL pozostaje napisany ręcznie — parsowanie zorientowane na wiersze jest prostsze niż jakakolwiek zależność, a parsowanie JSONC dla każdego wiersza i tak przechodzi przez jsonc-parser.

​
Co udostępnia

PowierzchniaDostarczane przez
CLI openclaw pathextensions/oc-path/cli-registration.ts
Parser / formatter oc://extensions/oc-path/src/oc-path/oc-path.ts
Parsowanie / emitowanie / edycja dla rodzajuextensions/oc-path/src/oc-path/{md,jsonc,jsonl,yaml}
Uniwersalne resolve / find / setextensions/oc-path/src/oc-path/{resolve,find,edit}.ts
Strażnik sentinela redakcjiextensions/oc-path/src/oc-path/sentinel.ts
CLI jest dziś jedyną publiczną powierzchnią. Czasowniki warstwy bazowej są prywatne dla Pluginu; konsumenci używają CLI (albo budują własny Plugin względem SDK).

​
Relacja z innymi Pluginami

  • memory-*: zapisy pamięci przechodzą przez Pluginy pamięci, a nie oc-path. oc-path jest ogólną warstwą bazową plików; Pluginy pamięci nakładają na nią własną semantykę.
  • LKG: path nie wie nic o odtwarzaniu konfiguracji Last-Known-Good. Jeśli plik jest śledzony przez LKG, następne wywołanie observe decyduje, czy promować, czy odzyskiwać; set --batch dla atomowego wielokrotnego ustawiania przez cykl życia promote/recover LKG jest planowane wraz z warstwą bazową odzyskiwania LKG.

​
Bezpieczeństwo

set zapisuje surowe bajty przez ścieżkę emitowania warstwy bazowej, która automatycznie stosuje strażnika sentinela redakcji. Liść zawierający __OPENCLAW_REDACTED__ (dosłownie lub jako podciąg) jest odrzucany w czasie zapisu z OC_EMIT_SENTINEL. CLI usuwa też dosłowny sentinel z każdego wyjścia dla człowieka lub JSON, które wypisuje, zastępując go [REDACTED], aby przechwytywania terminala i potoki nigdy nie ujawniały znacznika.

​
Powiązane