CLAUDE

기준일: 2026-07-26
공식 기준: CLAUDE

CLAUDE 문서는 OpenClaw 공식 문서(CLAUDE)를 한국어로 정리한 가이드입니다. This directory owns docs authoring, Mintlify link rules, and docs i18n policy. 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

This directory owns docs authoring, Mintlify link rules, and docs i18n policy.

문서 구성

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

Docs Guide
Mintlify Rules
Docs Content Rules
Internal Docs
Maturity Scorecard Editing
Docs i18n

상세 내용

Docs Guide

This directory owns docs authoring, Mintlify link rules, and docs i18n policy.

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

Mintlify Rules

주요 항목:

Docs are hosted on Mintlify (https://docs.openclaw.ai).
Internal doc links in docs/**/*.md must stay root-relative with no .md or .mdx suffix (example: Config).
Section cross-references should use anchors on root-relative paths (example: Hooks).
Doc headings should avoid em dashes and apostrophes because Mintlify anchor generation is brittle there.
README and other GitHub-rendered docs should keep absolute docs URLs so links work outside Mintlify.
Docs content must stay generic: no personal device names, hostnames, or local paths; use placeholders like user@gateway-host.

Docs Content Rules

주요 항목:

For docs, UI copy, and picker lists, order services/providers alphabetically unless the section is explicitly describing runtime order or auto-detection order.
Keep bundled plugin naming consistent with the repo-wide plugin terminology rules in the root AGENTS.md.
Generated docs, never hand-edit: docs/plugins/reference/**, docs/plugins/reference.md, and docs/plugins/plugin-inventory.md come from pnpm plugins:inventory:gen; docs/docs_map.md from pnpm docs:map:gen; docs/maturity/** from pnpm maturity:render.

Internal Docs

주요 항목:

Long-lived private operator docs belong in ~/Projects/manager/docs/.
Repo-local internal scratch/mirror docs may live under ignored docs/internal/.
Never add docs/internal/** pages to docs/docs.json navigation or link them from public docs.
scripts/docs-sync-publish.mjs excludes and prunes docs/internal/** from the public openclaw/docs publish repo if a page is force-added later.
Internal docs may mention repo paths, private app names, 1Password item names, and runbooks, but never include secret values.

Maturity Scorecard Editing

taxonomy.yaml and qa/maturity-scores.yaml are the source inputs; generated maturity docs under docs/maturity/ are projections and should not be hand-edited for score, LTS, taxonomy, QA profile, or evidence tables. scripts/qa/render-maturity-docs.ts owns generation; use pnpm maturity:render to refresh committed docs and pnpm maturity:check to verify them. .github/workflows/maturity-scorecard.yml renders artifact previews and can open generated-doc PRs; .github/workflows/openclaw-release-checks.yml dispatches it for release QA. Keep deterministic qa-evidence.json.scorecard data in GitHub Actions artifacts unless a maintainer explicitly asks for a sanitized committed projection. Human overrides must change source state in a PR and explain the reason plus public or redacted evidence.

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

Docs i18n

주요 항목:

Foreign-language docs are not maintained in this repo. The generated publish output lives in the separate openclaw/docs repo (often cloned locally as ../openclaw-docs).
Do not add or edit localized docs under docs/<locale>/** here.
Treat English docs in this repo plus glossary files as the source of truth.
Pipeline: update English docs here, update docs/.i18n/glossary.<locale>.json as needed, then let the publish-repo sync and scripts/docs-i18n run in openclaw/docs.
Before rerunning scripts/docs-i18n, add glossary entries for any new technical terms, page titles, or short nav labels that must stay in English or use a fixed translation.
pnpm docs:check-i18n-glossary is the guard for changed English doc titles and short internal doc labels.
Translation memory lives in generated docs/.i18n/*.tm.jsonl files in the publish repo.
See docs/.i18n/README.md.

실습 체크리스트

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

CLAUDE

기준일: 2026-07-26
공식 기준: CLAUDE

핵심 요약

This directory owns docs authoring, Mintlify link rules, and docs i18n policy.

문서 구성

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

Docs Guide
Mintlify Rules
Docs Content Rules
Internal Docs
Maturity Scorecard Editing
Docs i18n

상세 내용

Docs Guide

This directory owns docs authoring, Mintlify link rules, and docs i18n policy.

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

Mintlify Rules

주요 항목:

Docs are hosted on Mintlify (https://docs.openclaw.ai).
Internal doc links in docs/**/*.md must stay root-relative with no .md or .mdx suffix (example: Config).
Section cross-references should use anchors on root-relative paths (example: Hooks).
Doc headings should avoid em dashes and apostrophes because Mintlify anchor generation is brittle there.
README and other GitHub-rendered docs should keep absolute docs URLs so links work outside Mintlify.
Docs content must stay generic: no personal device names, hostnames, or local paths; use placeholders like user@gateway-host.

Docs Content Rules

주요 항목:

For docs, UI copy, and picker lists, order services/providers alphabetically unless the section is explicitly describing runtime order or auto-detection order.
Keep bundled plugin naming consistent with the repo-wide plugin terminology rules in the root AGENTS.md.
Generated docs, never hand-edit: docs/plugins/reference/**, docs/plugins/reference.md, and docs/plugins/plugin-inventory.md come from pnpm plugins:inventory:gen; docs/docs_map.md from pnpm docs:map:gen; docs/maturity/** from pnpm maturity:render.

Internal Docs

주요 항목:

Long-lived private operator docs belong in ~/Projects/manager/docs/.
Repo-local internal scratch/mirror docs may live under ignored docs/internal/.
Never add docs/internal/** pages to docs/docs.json navigation or link them from public docs.
scripts/docs-sync-publish.mjs excludes and prunes docs/internal/** from the public openclaw/docs publish repo if a page is force-added later.
Internal docs may mention repo paths, private app names, 1Password item names, and runbooks, but never include secret values.

Maturity Scorecard Editing

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

Docs i18n

주요 항목:

Foreign-language docs are not maintained in this repo. The generated publish output lives in the separate openclaw/docs repo (often cloned locally as ../openclaw-docs).
Do not add or edit localized docs under docs/<locale>/** here.
Treat English docs in this repo plus glossary files as the source of truth.
Pipeline: update English docs here, update docs/.i18n/glossary.<locale>.json as needed, then let the publish-repo sync and scripts/docs-i18n run in openclaw/docs.
Before rerunning scripts/docs-i18n, add glossary entries for any new technical terms, page titles, or short nav labels that must stay in English or use a fixed translation.
pnpm docs:check-i18n-glossary is the guard for changed English doc titles and short internal doc labels.
Translation memory lives in generated docs/.i18n/*.tm.jsonl files in the publish repo.
See docs/.i18n/README.md.

실습 체크리스트

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

CLAUDE

핵심 요약

문서 구성

상세 내용

Docs Guide

Mintlify Rules

Docs Content Rules

Internal Docs

Maturity Scorecard Editing

Docs i18n

실습 체크리스트

관련 링크

관련 가이드

CLAUDE

핵심 요약

문서 구성

상세 내용

Docs Guide

Mintlify Rules

Docs Content Rules

Internal Docs

Maturity Scorecard Editing

Docs i18n

실습 체크리스트

관련 링크

관련 가이드