Plugin OC Path

Plugin oc-path ที่บันเดิลมาด้วยเพิ่ม CLI openclaw path สำหรับ รูปแบบการระบุที่อยู่ไฟล์ในเวิร์กสเปซ oc:// โดยมาพร้อมกับ repo ของ OpenClaw ภายใต้ extensions/oc-path/ แต่เป็นแบบเลือกใช้เอง — การติดตั้ง/บิลด์จะปล่อยให้ปิดอยู่จนกว่าคุณจะ เปิดใช้งาน

ที่อยู่ oc:// ชี้ไปยัง leaf เดียว (หรือชุด leaf แบบไวลด์การ์ด) ภายใน ไฟล์เวิร์กสเปซ วันนี้ Plugin เข้าใจไฟล์สี่ชนิด:

• markdown (.md, .mdx): frontmatter, ส่วน, รายการ, ฟิลด์
• jsonc (.jsonc, .json5, .json): คงคอมเมนต์และการจัดรูปแบบไว้
• jsonl (.jsonl, .ndjson): ระเบียนแบบแยกตามบรรทัด
• yaml (.yaml, .yml, .lobster): โหนด map/sequence/scalar ผ่าน API เอกสาร YAML

ผู้โฮสต์เองและส่วนขยายของเอดิเตอร์ใช้ CLI เพื่ออ่านหรือเขียน leaf เดียว โดยไม่ต้องเขียนสคริปต์กับ SDK โดยตรง; เอเจนต์และฮุกถือว่าสิ่งนี้เป็น ฐานรองรับที่กำหนดผลลัพธ์ได้แน่นอน เพื่อให้การ round-trip ที่รักษา byte-fidelity และ ตัวป้องกัน redaction sentinel ใช้ได้สม่ำเสมอในทุกชนิดไฟล์

เหตุผลที่ควรเปิดใช้งาน

เปิดใช้งาน oc-path เมื่อคุณต้องการให้สคริปต์ ฮุก หรือเครื่องมือเอเจนต์ในเครื่องชี้ไปยัง ชิ้นส่วนสถานะของเวิร์กสเปซที่แม่นยำ โดยไม่ต้องสร้าง parser สำหรับไฟล์แต่ละรูปแบบ ที่อยู่ oc:// เดียวสามารถระบุคีย์ frontmatter ของ markdown, รายการในส่วน, leaf ของคอนฟิก JSONC, ฟิลด์เหตุการณ์ JSONL หรือขั้นตอน workflow ของ YAML ได้

สิ่งนี้สำคัญกับ workflow ของผู้ดูแลที่การเปลี่ยนแปลงควรเล็ก ตรวจสอบได้ และทำซ้ำได้: ตรวจค่าหนึ่งค่า, หา records ที่ตรงกัน, ทดลองเขียนแบบ dry-run, จากนั้นใช้เฉพาะ leaf นั้นโดยปล่อยคอมเมนต์ line endings และการจัดรูปแบบใกล้เคียงไว้ตามเดิม การคงสิ่งนี้เป็น Plugin แบบเลือกใช้เองทำให้ผู้ใช้ขั้นสูงได้ฐานรองรับการระบุที่อยู่ โดยไม่ใส่ dependency ของ parser หรือพื้นผิว CLI เข้าไปใน core สำหรับการติดตั้งที่ไม่ต้องใช้

เหตุผลทั่วไปในการเปิดใช้งาน:

• ระบบอัตโนมัติในเครื่อง: shell scripts สามารถ resolve หรืออัปเดตค่าเดียวในเวิร์กสเปซ ด้วย openclaw path … --json แทนการพกโค้ด parser แยกสำหรับ markdown, JSONC, JSONL และ YAML
• การแก้ไขที่เอเจนต์เห็นได้: เอเจนต์สามารถแสดง diff แบบ dry-run สำหรับ leaf ที่ระบุที่อยู่ไว้ ก่อนเขียน ซึ่งตรวจทานได้ง่ายกว่าการ rewrite ไฟล์แบบอิสระ
• การผสานกับเอดิเตอร์: เอดิเตอร์สามารถ map oc://AGENTS.md/tools/gh ไปยัง โหนด markdown และเลขบรรทัดที่ถูกต้อง โดยไม่ต้องเดาจากข้อความหัวข้อ
• การวินิจฉัย: emit ทำ round-trip ไฟล์ผ่าน parser และ emitter ดังนั้น คุณจึงตรวจได้ว่าไฟล์ชนิดหนึ่ง byte-stable หรือไม่ ก่อนพึ่งพาการแก้ไขอัตโนมัติ

ตัวอย่างที่เป็นรูปธรรม:

# 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 นี้ตั้งใจไม่เป็นเจ้าของ semantics ระดับสูงกว่า Plugin หน่วยความจำ ยังคงเป็นเจ้าของการเขียนหน่วยความจำ คำสั่งคอนฟิกยังคงเป็นเจ้าของการจัดการคอนฟิกเต็มรูปแบบ และตรรกะ LKG ยังคงเป็นเจ้าของการ restore/promotion oc-path เป็นเลเยอร์แคบสำหรับ การระบุที่อยู่และการดำเนินการไฟล์ที่รักษา byte ซึ่งเครื่องมือระดับสูงกว่าเหล่านั้น สามารถสร้างต่อยอดได้

ที่ที่มันทำงาน

Plugin ทำงาน ใน process ภายใน CLI openclaw บนโฮสต์ที่คุณ เรียกใช้คำสั่ง ไม่ต้องมี Gateway ที่กำลังทำงาน และไม่เปิด network sockets ใด ๆ — ทุก verb เป็นการ transform แบบบริสุทธิ์เหนือไฟล์ที่คุณชี้ไป

metadata ของ Plugin อยู่ใน extensions/oc-path/openclaw.plugin.json:

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

onStartup: false กัน Plugin ออกจาก hot path ของ Gateway onCommands: ["path"] บอก CLI ให้โหลด Plugin แบบ lazy ครั้งแรกที่คุณรัน openclaw path … ดังนั้นการติดตั้งที่ไม่เคยใช้ verb นี้จะไม่มีต้นทุน

เปิดใช้งาน

openclaw plugins enable oc-path

รีสตาร์ท Gateway (ถ้าคุณรันอยู่) เพื่อให้ snapshot ของ manifest รับสถานะใหม่ การเรียกใช้ openclaw path เปล่า ๆ ทำงานได้ทันทีบนโฮสต์เดียวกัน — CLI จะโหลด Plugin เมื่อต้องการ

ปิดใช้งานด้วย:

openclaw plugins disable oc-path

Dependencies

dependency ของ parser ทั้งหมดอยู่ใน Plugin เท่านั้น — การเปิดใช้งาน oc-path ไม่ได้ดึง แพ็กเกจใหม่เข้าไปใน runtime ของ core:

JSONL ยังคงเขียนเอง — การ parse แบบแยกตามบรรทัดเรียบง่ายกว่า dependency ใด ๆ และการ parse JSONC ต่อบรรทัดก็ผ่าน jsonc-parser อยู่แล้ว

สิ่งที่มีให้

CLI เป็นพื้นผิวสาธารณะเดียวในวันนี้ verb ของฐานรองรับเป็นส่วนตัวของ Plugin; consumers ใช้ CLI (หรือสร้าง Plugin ของตนเองกับ SDK)

ความสัมพันธ์กับ Plugin อื่น

• memory-*: การเขียนหน่วยความจำผ่าน Plugin หน่วยความจำ ไม่ใช่ oc-path oc-path เป็นฐานรองรับไฟล์ทั่วไป; Plugin หน่วยความจำวาง semantics ของตัวเอง ไว้ด้านบน
• LKG: path ไม่รู้เกี่ยวกับการ restore คอนฟิก Last-Known-Good ถ้า ไฟล์ถูกติดตามโดย LKG การเรียก observe ถัดไปจะตัดสินใจว่าจะ promote หรือ recover; มีแผนสำหรับ set --batch เพื่อ multi-set แบบ atomic ผ่าน lifecycle promote/recover ของ LKG ควบคู่กับฐานรองรับ LKG-recovery

ความปลอดภัย

set เขียน raw bytes ผ่าน emit path ของฐานรองรับ ซึ่งใช้ ตัวป้องกัน redaction-sentinel โดยอัตโนมัติ leaf ที่พก __OPENCLAW_REDACTED__ (แบบตรงตัวหรือเป็น substring) จะถูกปฏิเสธตอนเขียน ด้วย OC_EMIT_SENTINEL CLI ยังล้าง sentinel ตรงตัวจาก output แบบ human หรือ JSON ใด ๆ ที่พิมพ์ออกมา โดยแทนที่ด้วย [REDACTED] เพื่อให้การจับภาพ terminal และ pipelines ไม่รั่ว marker

ที่เกี่ยวข้อง

• ข้อมูลอ้างอิง CLI openclaw path
• จัดการ Plugin
• การสร้าง Plugin