4. Run `pnpm check:docs` if dependencies are available.

5. Leave the worktree clean if no docs need changes.

If `pnpm docs:check-mdx` or `pnpm check:docs` reports MDX parse errors, fix only the syntax needed for the listed existing docs files. Preserve prose meaning, frontmatter, code fences, and links; do not broadly rewrite translated or source content while repairing parser failures.

When uncertain, prefer no edit and explain the uncertainty in the final message.

# OpenClaw Docs MDX Repair Agent

You are repairing generated OpenClaw documentation after a fast MDX validation failure.

Goal: fix only the MDX syntax errors reported by the checker.

Hard limits:

- Edit only existing Markdown/MDX files under the locale path named by `LOCALE`.

- Do not edit source English docs unless `LOCALE=en`.

- Do not edit code, workflows, package metadata, generated sync metadata, translation memory, or assets.

- Do not add, delete, or rename files.

- Preserve the meaning of translated prose.

- Preserve frontmatter, `x-i18n.source_hash`, links, code fences, JSX component names, and existing page structure.

- Avoid broad formatting or retranslation.

Required workflow:

1. Read `.openclaw-sync/mdx/${LOCALE}.json` when it exists.

2. Inspect only the listed files and nearby lines.

3. Fix the minimal syntax issue, such as broken JSX attribute quoting, mismatched component closing tags, raw `<` text, raw HTML comments, or accidental top-level `import`/`export` text.

4. Run `node source/scripts/check-docs-mdx.mjs "docs/${LOCALE}" --json-out ".openclaw-sync/mdx/${LOCALE}.json"`.

5. Leave no changes outside `docs/${LOCALE}`.

When uncertain, prefer the smallest escaping fix: backticks for literal words, `&lt;` for literal `<`, double quotes around JSX attribute values, and balanced component tags.

--source-repo "$GITHUB_REPOSITORY" \

--source-sha "$GITHUB_SHA"

- name: Install docs MDX checker dependency

run: npm install --no-save --package-lock=false @mdx-js/mdx@3.1.1

- name: Check publish docs MDX

run: node "$GITHUB_WORKSPACE/publish/.openclaw-sync/check-docs-mdx.mjs" "$GITHUB_WORKSPACE/publish/docs"

- name: Commit publish repo sync

working-directory: publish

run: |

"check:base-config-schema": "node --import tsx scripts/generate-base-config-schema.ts --check",

"check:bundled-channel-config-metadata": "node --import tsx scripts/generate-bundled-channel-config-metadata.ts --check",

"check:changed": "node scripts/check-changed.mjs",

"check:docs": "pnpm format:docs:check && pnpm lint:docs && pnpm docs:check-i18n-glossary && pnpm docs:check-links",

"check:docs": "pnpm format:docs:check && pnpm lint:docs && pnpm docs:check-mdx && pnpm docs:check-i18n-glossary && pnpm docs:check-links",

"check:host-env-policy:swift": "node scripts/generate-host-env-security-policy-swift.mjs --check",

"check:import-cycles": "node --import tsx scripts/check-import-cycles.ts",

"check:loc": "node --import tsx scripts/check-ts-max-loc.ts --max 500",

"docs:check-i18n-glossary": "node scripts/check-docs-i18n-glossary.mjs",

"docs:check-links": "node scripts/docs-link-audit.mjs",

"docs:check-links:anchors": "node scripts/docs-link-audit.mjs --anchors",

"docs:check-mdx": "node scripts/check-docs-mdx.mjs docs README.md",

"docs:dev": "cd docs && mint dev",

"docs:list": "node scripts/docs-list.js",

"docs:spellcheck": "bash scripts/docs-spellcheck.sh",

"@grammyjs/types": "^3.26.0",

"@lit-labs/signals": "^0.2.0",

"@lit/context": "^1.1.6",

"@mdx-js/mdx": "^3.1.1",

"@types/express": "^5.0.6",

"@types/markdown-it": "^14.1.2",

"@types/node": "25.6.0",