CLI commands

위키

`openclaw wiki`

memory-wiki 볼트를 검사하고 유지 관리합니다. 번들로 제공되는 memory-wiki Plugin에서 제공합니다.

자주 사용하는 명령어

bash

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki okf import ./knowledge-catalog/okf/bundles/ga4openclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki search "who should I ask about Teams?" --mode route-questionopenclaw wiki get entity.alpha --from 1 --lines 80 openclaw wiki apply synthesis "Alpha Summary" \  --body "Short synthesis body" \  --source-id source.alpha openclaw wiki apply metadata entity.alpha \  --source-id source.alpha \  --status review \  --question "Still active?" openclaw wiki bridge importopenclaw wiki unsafe-local importopenclaw wiki chatgpt import --export ./chatgpt-export --dry-runopenclaw wiki chatgpt rollback <run-id> openclaw wiki obsidian statusopenclaw wiki obsidian search "alpha"openclaw wiki obsidian open syntheses/alpha-summary.mdopenclaw wiki obsidian command workspace:quick-switcheropenclaw wiki obsidian daily

에이전트 선택

plugins.entries.memory-wiki.config.vault.scope가 agent이면 최상위 --agent <id> 옵션으로 볼트를 선택합니다.

bash

openclaw wiki --agent support statusopenclaw wiki --agent support search "refund policy"openclaw wiki --agent marketing ingest ./campaign-notes.md

여러 에이전트가 구성된 설정에서는 명령어가 임의의 기본 볼트를 읽거나 쓰지 못하도록 CLI 작업에 --agent가 필요합니다. 에이전트가 하나만 구성되어 있으면 해당 에이전트가 계속 기본값으로 사용됩니다. 알 수 없는 에이전트 ID는 볼트 작업이 시작되기 전에 실패합니다. vault.scope가 global이면 이 옵션은 선택된 경로를 변경하지 않습니다.

Gateway 클라이언트에도 같은 규칙이 적용됩니다. 에이전트 범위의 다중 에이전트 설정에서는 볼트 기반 wiki.* 요청에 agentId를 전달합니다. ID가 없거나 알 수 없는 경우 오류가 발생합니다. 에이전트 턴, 위키 도구, 메모리 코퍼스 보충 자료, 컴파일된 프롬프트 다이제스트에는 이미 활성 런타임 에이전트 컨텍스트가 포함됩니다.

명령어

`wiki status`

볼트 모드와 범위, 확인된 에이전트, 상태 및 Obsidian CLI 사용 가능 여부를 표시합니다. 의도한 볼트가 초기화되었는지, 브리지 모드가 정상인지 또는 Obsidian 연동을 사용할 수 있는지 확인할 때 가장 먼저 사용합니다.

브리지 모드가 활성화되어 있고 메모리 아티팩트를 읽도록 구성된 경우, 이 명령어는 실행 중인 Gateway를 쿼리하므로 에이전트/런타임 메모리와 동일한 활성 메모리 Plugin 컨텍스트를 확인합니다.

`wiki doctor`

위키 상태 검사를 실행하고 실행 가능한 수정 방법을 보고합니다. 상태가 비정상이면 0이 아닌 코드로 종료됩니다.

브리지 모드가 활성화되어 있고 메모리 아티팩트를 읽도록 구성된 경우, 이 명령어는 보고서를 생성하기 전에 실행 중인 Gateway를 쿼리합니다. 비활성화된 브리지 가져오기 및 메모리 아티팩트를 읽지 않는 브리지 구성은 로컬/오프라인 상태를 유지합니다.

일반적인 문제:

공개 메모리 아티팩트 없이 브리지 모드가 활성화됨
볼트 레이아웃이 잘못되었거나 없음
Obsidian 모드가 필요한데 외부 Obsidian CLI가 없음

`wiki init`

최상위 인덱스와 캐시 디렉터리를 포함하여 위키 볼트 레이아웃과 시작 페이지를 생성합니다.

`wiki ingest <path>`

로컬 마크다운 또는 텍스트 파일을 소스 페이지로 위키의 sources/ 폴더에 가져옵니다. <path>는 로컬 파일 경로여야 하며 현재 URL 가져오기는 지원하지 않습니다. 바이너리 파일은 거부합니다.

가져온 소스 페이지에는 출처 frontmatter(sourceType: local-file, sourcePath, ingestedAt)가 포함됩니다. 가져온 뒤에는 항상 볼트를 다시 컴파일합니다.

플래그: --title <title>은 소스 제목을 재정의합니다(기본값: 파일 이름에서 파생).

`wiki okf import <path>`

압축을 푼 Open Knowledge Format 번들을 위키 개념 페이지로 가져옵니다.

가져오기 도구는 OKF 디렉터리 트리에서 예약되지 않은 모든 .md 개념 문서를 읽고, 비어 있지 않은 type 필드를 요구하며, 알 수 없는 OKF type 값을 일반 개념으로 처리합니다. 예약된 OKF index.md 및 log.md 파일은 개념으로 가져오지 않습니다.

가져온 페이지는 concepts/ 아래에 평탄화되므로 기존 위키 컴파일, 검색, 가져오기, 다이제스트 및 대시보드 흐름에서 즉시 확인할 수 있습니다. 원본 OKF 개념 ID, type, resource, tags, 타임스탬프, 소스 경로 및 전체 frontmatter는 페이지 frontmatter에 보존됩니다. 내부 OKF 마크다운 링크는 생성된 위키 페이지를 가리키도록 다시 작성되며, 끊어진 링크나 외부 링크는 변경하지 않습니다. 가져온 뒤에는 항상 볼트를 다시 컴파일합니다.

예:

bash

openclaw wiki okf import ./bundles/ga4openclaw wiki okf import ./bundles/ga4 --jsonopenclaw wiki search "BigQuery Table" --mode source-evidence --jsonopenclaw wiki get <path-from-json-result>

`wiki compile`

인덱스, 관련 블록, 대시보드 및 컴파일된 다이제스트를 다시 빌드합니다. 다음 위치에 안정적인 머신용 아티팩트를 작성합니다.

.openclaw-wiki/cache/agent-digest.json
.openclaw-wiki/cache/claims.jsonl

render.createDashboards가 활성화되어 있으면 컴파일 시 보고서 페이지도 새로 고칩니다.

`wiki lint`

볼트를 린트하고 다음 내용을 다루는 보고서를 작성합니다.

구조적 문제(끊어진 링크, 누락되거나 중복된 ID, 누락된 페이지 유형 또는 제목, 잘못된 frontmatter)
출처 공백(누락된 소스 ID, 누락된 가져오기 출처)
모순(표시된 모순, 충돌하는 주장)
미해결 질문
신뢰도가 낮은 페이지와 주장
오래된 페이지와 주장

의미 있는 위키 업데이트 후에 실행합니다.

`wiki search <query>`

위키 콘텐츠를 검색합니다. 동작은 구성에 따라 달라집니다.

search.backend: shared 또는 local
search.corpus: wiki, memory 또는 all
--mode: auto, find-person, route-question, source-evidence 또는 raw-claim

위키별 순위 지정과 출처가 중요하면 wiki search를 사용합니다. 한 번의 광범위한 공유 회상 검색에는 활성 메모리 Plugin이 공유 검색을 제공하는 경우 openclaw memory search를 사용하는 것이 좋습니다.

검색 모드:

find-person: 별칭, 핸들, 소셜 계정, 정식 ID 및 인물 페이지
route-question: 문의 대상/가장 적합한 용도에 대한 힌트와 관계 컨텍스트
source-evidence: 소스 페이지와 구조화된 증거 필드
raw-claim: 주장/증거 메타데이터가 포함된 구조화된 주장 텍스트

예:

bash

openclaw wiki search "bgroux" --mode find-personopenclaw wiki search "who knows Teams rollout?" --mode route-questionopenclaw wiki search "maintainer-whois" --mode source-evidenceopenclaw wiki search "strong route Teams" --mode raw-claim --json

결과가 구조화된 주장과 일치하면 텍스트 출력에 Claim: 및 Evidence: 줄이 포함됩니다. JSON 출력에는 에이전트 측 상세 탐색을 위한 matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds 및 evidenceSourceIds도 추가로 노출됩니다.

`wiki get <lookup>`

ID 또는 상대 경로로 위키 페이지를 읽습니다.

bash

openclaw wiki get entity.alphaopenclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80

`wiki apply`

자유 형식으로 페이지를 직접 수정하지 않고 제한적인 변경을 적용합니다.

apply synthesis <title>: 관리되는 요약 본문이 포함된 종합 페이지를 생성하거나 새로 고침
apply metadata <lookup>: 기존 페이지의 메타데이터 업데이트

두 명령어 모두 --source-id, --contradiction, --question(각각 반복 가능), --confidence <n>(0~1) 및 --status <status>를 허용합니다. apply metadata는 저장된 신뢰도 값을 제거하는 --clear-confidence도 허용합니다. 관리되는 생성 블록을 그대로 유지하면서 위키 페이지를 발전시키는 데 지원되는 방법입니다.

`wiki bridge import`

활성 메모리 Plugin의 공개 메모리 아티팩트를 브리지 기반 소스 페이지로 가져옵니다. bridge 모드에서 최근에 내보낸 메모리 아티팩트를 위키 볼트로 가져올 때 사용합니다.

활성 브리지 아티팩트 읽기의 경우 CLI는 런타임 메모리 Plugin 컨텍스트를 사용하도록 Gateway RPC를 통해 가져오기를 라우팅합니다. 브리지 가져오기가 비활성화되어 있거나 아티팩트 읽기가 꺼져 있으면 명령어는 로컬/오프라인의 가져오기 0건 동작을 유지합니다. 가져오기 후 인덱스 새로 고침은 ingest.autoCompile에 따라 제어됩니다.

`wiki unsafe-local import`

unsafe-local 모드에서 명시적으로 구성된 로컬 경로(unsafeLocal.paths)에서 가져옵니다. 의도적으로 실험적이며 동일한 머신에서만 사용할 수 있습니다. 가져오기 후 인덱스 새로 고침은 ingest.autoCompile에 따라 제어됩니다.

`wiki chatgpt import`

ChatGPT 내보내기를 위키 소스 페이지 초안으로 가져옵니다.

bash

openclaw wiki chatgpt import --export ./chatgpt-exportopenclaw wiki chatgpt import --export ./conversations.json --dry-run

플래그	기본값	설명
`--export <path>`	(필수)	ChatGPT 내보내기 디렉터리 또는 `conversations.json` 경로입니다.
`--dry-run`	`false`	페이지를 작성하지 않고 생성/업데이트/건너뜀 건수를 미리 봅니다.

시험 실행이 아닌 가져오기로 페이지가 하나라도 변경되면 가져오기 실행 ID가 기록되어 요약에 출력되며, 롤백할 때 필요합니다.

`wiki chatgpt rollback <run-id>`

이전에 적용된 ChatGPT 가져오기 실행을 롤백하여 생성된 페이지를 제거하고 덮어쓴 페이지를 복원합니다. 실행이 이미 롤백된 경우 아무 작업도 하지 않고 alreadyRolledBack을 보고합니다.

`wiki obsidian ...`

Obsidian 친화적 모드로 실행되는 볼트를 위한 Obsidian 보조 명령어입니다: status, search, open, command, daily. obsidian.useOfficialCli가 활성화되어 있으면 PATH에 공식 obsidian CLI가 있어야 합니다.

obsidian.vaultName은 에이전트별 매핑이 아닌 하나의 전역 설정이므로 vault.scope가 agent일 때 구성 검증에서 obsidian.useOfficialCli: true를 거부합니다. Obsidian 친화적 마크다운 렌더링은 계속 사용할 수 있습니다.

실용적인 사용 지침

출처와 페이지 식별자가 중요하면 wiki search와 wiki get을 사용합니다.
관리되는 생성 섹션을 직접 편집하는 대신 wiki apply를 사용합니다.
모순되거나 신뢰도가 낮은 콘텐츠를 신뢰하기 전에 wiki lint를 사용합니다.
대량 가져오기 또는 소스 변경 후 최신 대시보드와 컴파일된 다이제스트가 즉시 필요하면 wiki compile을 사용합니다.
데이터 카탈로그, 문서 내보내기 또는 에이전트 보강 파이프라인이 이미 OKF 마크다운 번들을 생성하는 경우 wiki okf import를 사용합니다.
브리지 모드가 새로 내보낸 메모리 아티팩트에 의존하는 경우 wiki bridge import를 사용합니다.

위키

`openclaw wiki`

자주 사용하는 명령어

에이전트 선택

명령어

`wiki status`

`wiki doctor`

`wiki init`

`wiki ingest <path>`

`wiki okf import <path>`

`wiki compile`

`wiki lint`

`wiki search <query>`

`wiki get <lookup>`

`wiki apply`

`wiki bridge import`

`wiki unsafe-local import`

`wiki chatgpt import`

`wiki chatgpt rollback <run-id>`

`wiki obsidian ...`

실용적인 사용 지침

관련 구성

관련 문서

On this page

Molty