AGENTS.MD

Publish mirror for docs.openclaw.ai. Source repo: openclaw/openclaw.

Rule

Do not hand-edit generated docs output.
Fix source or workflow; let sync/translation regenerate.
Emergency generated-output edits need explicit owner approval and a follow-up source/workflow fix.

AGENTS.md, CLAUDE.md, README.md.
.github/workflows/translate-*.yml.
.github/workflows/translate-locale-reusable.yml.
docs/.i18n/translation-workflow.md when documenting translation workflow internals.
docs/.i18n/glossary.<locale>.json when adding fixed glossary terms for the translation workflow.

English docs under docs/**; edit openclaw/openclaw/docs/** instead.
docs/docs.json; generated by source sync.
Locale pages under docs/<locale>/**; generated by translation workflows.
Translation memory docs/.i18n/*.tm.jsonl; generated by translation workflows.
Locale navigation files docs/.i18n/*-navigation.json; generated workflow state.
.openclaw-sync/source.json; generated sync metadata.
.openclaw-sync/check-docs-mdx.mjs and .openclaw-sync/docs-mdx-repair.md; copied from openclaw/openclaw.

Source sync starts in openclaw/openclaw/.github/workflows/docs-sync-publish.yml.
Sync mirrors openclaw/openclaw/docs/** into this repo and updates .openclaw-sync/source.json.
translate-all.yml runs from this repo after debounced docs changes, weekly schedule, release dispatch, or manual dispatch.
Translation pending logic compares source file SHA-256 with each page's x-i18n.source_hash.
Locale workers upload artifacts; the finalizer pushes one aggregate i18n commit.
If translated MDX fails, the repair step may touch only docs/<locale>/** and docs/.i18n/<locale>.tm.jsonl.