OC Path plugin

기준일: 2026-07-26
공식 기준: OC Path plugin

OC Path plugin 문서는 OpenClaw 공식 문서(plugins/oc-path)를 한국어로 정리한 가이드입니다. Bundled oc-path plugin: ships the openclaw path CLI for the oc:// workspace-file addressing scheme 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Bundled oc-path plugin: ships the openclaw path CLI for the oc:// workspace-file addressing scheme

한국어 가이드 범위: plugins/oc-path 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Why enable it
• Is the GitHub plugin enabled in this config?
• Which tool-call names appear in this session log?
• What bytes would this tiny config edit write?
• Where it runs
• Enable
• Dependencies
• What it provides
• Relationship to other plugins
• Safety
• 관련 문서

상세 내용

본문

The bundled oc-path plugin adds the openclaw path CLI for the oc:// workspace-file addressing scheme. It ships in the OpenClaw repo under extensions/oc-path/ but is opt-in: install/build leaves it dormant until you enable it.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• markdown (.md): frontmatter, sections, items, fields
• jsonc (.jsonc, .json): comments and formatting preserved
• jsonl (.jsonl, .ndjson): line-oriented records
• yaml (.yaml, .yml, .lobster): map/sequence/scalar nodes through the

Why enable it

Enable oc-path when scripts, hooks, or local agent tooling need to point at a precise piece of workspace state without a bespoke parser per file shape. A single oc:// address can name a markdown frontmatter key, a section item, a JSONC config leaf, a JSONL event field, or a YAML workflow step.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Local automation: shell scripts resolve or update one workspace value
• Agent-visible edits: an agent shows a dry-run diff for one addressed
• Editor integrations: an editor maps oc://AGENTS.md/tools/gh to the
• Diagnostics: emit round-trips a file through the parser and emitter,

Is the GitHub plugin enabled in this config?

openclaw path resolve 'oc://config.jsonc/plugins/github/enabled' --json

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Which tool-call names appear in this session log?

openclaw path find 'oc://session.jsonl/[event=tool_call]/name' --json

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

What bytes would this tiny config edit write?

openclaw path set 'oc://config.jsonc/plugins/github/enabled' 'true' --dry-run ```

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Where it runs

The plugin runs in-process inside the openclaw CLI on the host where you invoke the command. It does not need a running Gateway and does not open any network sockets; every verb is a pure transform over a file you point it at.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

Enable

Restart the Gateway (if you run one) so the manifest snapshot picks up the new state. Bare openclaw path invocations work immediately on the same host; the CLI loads the plugin on demand.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw plugins enable oc-path

openclaw plugins disable oc-path

Dependencies

All parser dependencies are plugin-local; enabling oc-path does not pull new packages into the core runtime:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Dependency	Purpose
commander	Subcommand wiring for resolve, find, set, validate, emit.
jsonc-parser	JSONC parse and leaf edits with comments and trailing commas kept.
markdown-it	Markdown tokenization for the section / item / field model.
yaml	YAML Document parse / emit / edit with comments and flow style kept.

What it provides

The CLI is the only public surface today. The substrate verbs are private to the plugin; consumers use the CLI (or build their own plugin against the SDK).

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Surface	Provided by
openclaw path CLI	extensions/oc-path/cli-registration.ts
oc:// parser / formatter	extensions/oc-path/src/oc-path/oc-path.ts
Per-kind parse / emit / edit	extensions/oc-path/src/oc-path/{md,jsonc,jsonl,yaml}
Universal resolve / find / set	extensions/oc-path/src/oc-path/{resolve,find,edit}.ts
Redaction-sentinel guard	extensions/oc-path/src/oc-path/sentinel.ts

Relationship to other plugins

oc-path. oc-path is a generic file substrate; memory plugins layer their own semantics on top.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• memory-*: memory writes go through the memory plugins, not
• LKG: path does not know about last-known-good config restore. If a

Safety

set writes raw bytes through the substrate's emit path, which applies the redaction-sentinel guard automatically. A leaf carrying __OPENCLAW_REDACTED__ (verbatim or as a substring) is refused at write time with OC_EMIT_SENTINEL. The CLI also scrubs the literal sentinel from any human or JSON output it prints, replacing it with [REDACTED] so terminal captures and pipelines never leak the marker.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

관련 문서

주요 항목:

• openclaw path CLI reference
• Manage plugins
• Building plugins

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/plugins/oc-path
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

# 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

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

openclaw plugins enable oc-path

openclaw plugins disable oc-path

관련 링크

• 공식 원문: plugins/oc-path
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.