OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Plugin guides

OC Path Plugin'i

Paketle birlikte gelen oc-path Plugin’i, oc:// çalışma alanı dosyası adresleme şeması için openclaw path CLI’sini ekler. OpenClaw deposunda extensions/oc-path/ altında sunulur ancak isteğe bağlıdır: kurulum/derleme sonrasında siz etkinleştirene kadar devre dışı kalır.

oc:// adresleri, bir çalışma alanı dosyasındaki tek bir yaprak öğeyi (veya joker karakterle belirtilen bir yaprak kümesini) gösterir. Plugin dört dosya türünü destekler:

  • markdown (.md): ön bilgiler, bölümler, öğeler, alanlar
  • jsonc (.jsonc, .json): yorumlar ve biçimlendirme korunur
  • jsonl (.jsonl, .ndjson): satır odaklı kayıtlar
  • yaml (.yaml, .yml, .lobster): yaml paketinin Document API’si üzerinden eşleme/dizi/skaler düğümleri

Kendi sisteminde barındıranlar ve düzenleyici uzantıları, doğrudan SDK’ye yönelik betik yazmadan tek bir yaprak öğeyi okumak veya yazmak için CLI’yi kullanır; ajanlar ve kancalar ise bayt düzeyinde aslına uygun gidiş-dönüş işlemlerinin ve redaksiyon belirteci korumasının tüm türlerde tutarlı şekilde uygulanması için bunu belirlenimci bir altyapı olarak kullanır. Tam dil bilgisi, her komuta özgü bayrak listesi ve dosya türü başına uygulamalı örnekler için CLI başvurusuna bakın; bu sayfa Plugin’in neden ve nasıl etkinleştirileceğini açıklar.

Neden etkinleştirmelisiniz?

Betiklerin, kancaların veya yerel ajan araçlarının her dosya biçimi için özel bir ayrıştırıcı kullanmadan çalışma alanı durumunun belirli bir parçasını göstermesi gerektiğinde oc-path’i etkinleştirin. Tek bir oc:// adresi; bir markdown ön bilgi anahtarını, bölüm öğesini, JSONC yapılandırma yaprağını, JSONL olay alanını veya YAML iş akışı adımını adlandırabilir.

Bu, değişikliğin küçük, denetlenebilir ve tekrarlanabilir kalması gereken bakımcı iş akışları için önemlidir: tek bir değeri inceleyin, eşleşen kayıtları bulun, bir yazma işlemini deneme modunda çalıştırın ve ardından yorumlara, satır sonlarına ve yakındaki biçimlendirmeye dokunmadan yalnızca o yaprak öğeyi uygulayın.

Etkinleştirmenin yaygın nedenleri:

  • Yerel otomasyon: kabuk betikleri, ayrı markdown, JSONC, JSONL ve YAML ayrıştırma kodları taşımak yerine openclaw path … --json ile tek bir çalışma alanı değerini çözümler veya günceller.
  • Ajan tarafından görülebilen düzenlemeler: bir ajan, yazmadan önce adreslenmiş tek bir yaprak öğe için deneme modu farkını gösterir; bunu incelemek serbest biçimli bir dosya yeniden yazımını incelemekten daha kolaydır.
  • Düzenleyici entegrasyonları: bir düzenleyici, başlık metninden tahminde bulunmadan oc://AGENTS.md/tools/gh adresini tam markdown düğümü ve satır numarasıyla eşler.
  • Tanılama: emit, bir dosyayı ayrıştırıcı ve çıktı üretici üzerinden gidiş-dönüş işlemine tabi tutar; böylece otomatik düzenlemelere güvenmeden önce dosya türünün bayt düzeyinde kararlı olup olmadığını denetleyebilirsiniz.
bash
# GitHub Plugin’i bu yapılandırmada etkin mi?openclaw path resolve 'oc://config.jsonc/plugins/github/enabled' --json # Bu oturum günlüğünde hangi araç çağrısı adları görünüyor?openclaw path find 'oc://session.jsonl/[event=tool_call]/name' --json # Bu küçük yapılandırma düzenlemesi hangi baytları yazar?openclaw path set 'oc://config.jsonc/plugins/github/enabled' 'true' --dry-run

oc-path, kasıtlı olarak daha üst düzey anlamların sahibi değildir. Bellek Plugin’leri bellek yazma işlemlerinin, yapılandırma komutları tam yapılandırma yönetiminin ve bilinen son iyi (LKG) yapılandırma kurtarma mekanizması da geri yükleme/yükseltme işlemlerinin sahibi olmaya devam eder. oc-path, bu üst düzey araçların çevresinde oluşturulabileceği dar kapsamlı adresleme ve bayt korumalı dosya işlemi katmanıdır.

Nerede çalışır?

Plugin, komutu çağırdığınız ana makinedeki openclaw CLI’sinin işlem içi ortamında çalışır. Çalışan bir Gateway gerektirmez ve herhangi bir ağ soketi açmaz; her komut, gösterdiğiniz dosya üzerinde gerçekleştirilen saf bir dönüşümdür.

Plugin meta verileri extensions/oc-path/openclaw.plugin.json içinde bulunur:

json
{  "id": "oc-path",  "name": "OC Path",  "activation": {    "onStartup": false,    "onCommands": ["path"]  },  "commandAliases": [{ "name": "path", "kind": "cli" }]}

onStartup: false, Plugin’i Gateway başlatma yolunun dışında tutar. commandAliases ve activation.onCommands, openclaw path … komutunu ilk kez çalıştırdığınızda CLI’ye Plugin’i gecikmeli olarak yüklemesini bildirir; böylece komutu hiç kullanmayan kurulumlarda herhangi bir maliyet oluşmaz.

Etkinleştirme

bash
openclaw plugins enable oc-path

Bildirim anlık görüntüsünün yeni durumu algılaması için Gateway’i (çalıştırıyorsanız) yeniden başlatın. Aynı ana makinedeki yalın openclaw path çağrıları hemen çalışır; CLI, Plugin’i talep üzerine yükler.

Şununla devre dışı bırakın:

bash
openclaw plugins disable oc-path

Bağımlılıklar

Tüm ayrıştırıcı bağımlılıkları Plugin’e özeldir; oc-path’i etkinleştirmek çekirdek çalışma zamanına yeni paketler eklemez:

Bağımlılık Amaç
commander resolve, find, set, validate, emit alt komutlarının bağlanması.
jsonc-parser Yorumları ve sondaki virgülleri koruyarak JSONC ayrıştırma ve yaprak düzenlemeleri.
markdown-it Bölüm / öğe / alan modeli için Markdown belirteçlerine ayırma.
yaml Yorumları ve akış stilini koruyarak YAML Document ayrıştırma / üretme / düzenleme.

JSONL elle gerçekleştirilmiş olarak kalır: satır odaklı ayrıştırma herhangi bir bağımlılığı kullanmaktan daha basittir ve satır başına ayrıştırma zaten jsonc-parser üzerinden geçer.

Sağladıkları

Yüzey Sağlayan
openclaw path CLI extensions/oc-path/cli-registration.ts
oc:// ayrıştırıcı / biçimleyici extensions/oc-path/src/oc-path/oc-path.ts
Türe göre ayrıştırma / üretme / düzenleme extensions/oc-path/src/oc-path/{md,jsonc,jsonl,yaml}
Evrensel çözümleme / bulma / ayarlama extensions/oc-path/src/oc-path/{resolve,find,edit}.ts
Redaksiyon belirteci koruması extensions/oc-path/src/oc-path/sentinel.ts

Günümüzde tek genel kullanıma açık yüzey CLI’dir. Altyapı komutları Plugin’e özeldir; tüketiciler CLI’yi kullanır (veya SDK’ye karşı kendi Plugin’lerini oluşturur).

Diğer Plugin’lerle ilişkisi

  • memory-*: bellek yazma işlemleri oc-path üzerinden değil, bellek Plugin’leri üzerinden gerçekleştirilir. oc-path genel amaçlı bir dosya altyapısıdır; bellek Plugin’leri kendi anlamlarını bunun üzerine katmanlar.
  • LKG: path, bilinen son iyi yapılandırmanın geri yüklenmesi hakkında bilgi sahibi değildir. path üzerinden düzenlediğiniz bir dosya LKG tarafından da izleniyorsa bir sonraki yapılandırma gözlem döngüsü dosyanın yükseltilmesine veya kurtarılmasına karar verir; bir path düzenlemesini o dosyaya yapılan diğer tüm doğrudan yazma işlemleriyle aynı şekilde değerlendirin.

Güvenlik

set, redaksiyon belirteci korumasını otomatik olarak uygulayan altyapının çıktı üretme yolu üzerinden ham baytlar yazar. __OPENCLAW_REDACTED__ değerini (aynen veya bir alt dize olarak) taşıyan bir yaprak öğenin yazılması, yazma sırasında OC_EMIT_SENTINEL hatasıyla reddedilir. CLI ayrıca yazdırdığı insan tarafından okunabilir veya JSON biçimindeki tüm çıktılardan değişmez belirteci temizleyerek [REDACTED] ile değiştirir; böylece terminal kayıtları ve işlem hatları belirteci hiçbir zaman sızdırmaz.

İlgili içerikler

Was this useful?
On this page

On this page