PR #68250: docs: use relative links in provider index to fix localization #68139

• Repository: openclaw/openclaw
• Author: ShayMeshGit
• State: open | merged: False
• Link: https://github.com/openclaw/openclaw/pull/68250

Description (problem / solution / changelog)

Summary

• Problem: Links on localized documentation pages (e.g., German /de/docs/providers/index) were 404ing because they pointed to the domain root (e.g., /providers/ollama) instead of the localized documentation path (e.g., /de/docs/providers/ollama).
• Why it matters: This broke the onboarding and configuration flow for non-English users.
• What changed: Standardized all internal links in docs/providers/index.md to be standard root-relative paths (e.g., /providers/ollama) to comply with docs/AGENTS.md.
• Underlying Fix: Patched the i18n relocalizer (scripts/docs-i18n/localized_links.go) to correctly include the /docs segment when rewriting root-relative links for localized sites.
• Verification: Verified that node scripts/docs-link-audit.mjs passes with 0 broken links in the English source.

Change Type (select all)

• Bug fix
• Feature
• Refactor required for the fix
• Docs
• Security hardening
• Chore/infra

Scope (select all touched areas)

• Gateway / orchestration
• Skills / tool execution
• Auth / tokens
• Memory / storage
• Integrations
• API / contracts
• UI / DX
• CI/CD / infra

Linked Issue/PR

• Closes #68139
• This PR fixes a bug or regression

Root Cause (if applicable)

• Root cause: The i18n relocalizer was prepending the language code (e.g., /de) but omitting the /docs segment that the localized documentation site requires. This caused standard root-relative links (mandated by Mintlify/AGENTS.md) to resolve incorrectly on the localized domain.
• Missing detection / guardrail: The relocalizer lacked a test case or configuration to ensure compatibility with the specific sub-path requirements of the localized docs host (openclaw-ai.com/<lang>/docs/...).

Regression Test Plan (if applicable)

• Coverage level that should have caught this:
  • Unit test
  • Seam / integration test
  • End-to-end test
  • Existing coverage already sufficient
• Target test or file: scripts/docs-i18n/localized_links_test.go
• Scenario the test should lock in: Rewritten localized links should include the /docs segment after the language code.

User-visible / Behavior Changes

Users on localized documentation sites will now be correctly redirected to the localized version of provider pages instead of hitting a 404 at the domain root.

Diagram (if applicable)

For UI changes or non-trivial logic flows, include a small ASCII diagram reviewers can scan quickly. Otherwise write N/A.

Source: [Ollama](/providers/ollama)
Old Relocalizer: /de/providers/ollama (404)
New Relocalizer: /de/docs/providers/ollama (Works)

Security Impact (required)

• New permissions/capabilities? (No)
• Secrets/tokens handling changed? (No)
• New/changed network calls? (No)
• Command/tool execution surface changed? (No)
• Data access scope changed? (No)

Repro + Verification

Environment

• OS: Darwin
• Runtime/container: Native

Steps

1. Run node scripts/docs-link-audit.mjs to confirm English links are valid.
2. (Manual/Pipeline) Run scripts/docs-i18n and verify rewritten links include /docs.

Expected

• Links resolve to the localized sub-hierarchy.

Actual

• English link audit: checked_internal_links=2848, broken_links=0.

Evidence

Attach at least one:

• Trace/log snippets: checked_internal_links=2848, broken_links=0

Human Verification (required)

What you personally verified (not just CI), and how:

• Verified the patch in scripts/docs-i18n/localized_links.go ensures the /docs segment is present.
• Re-standardized docs/providers/index.md to use the /path format required by Mintlify.

Review Conversations

• I replied to or resolved every bot review conversation I addressed in this PR.

Compatibility / Migration

• Backward compatible? (Yes)
• Config/env changes? (No)
• Migration needed? (No)

Risks and Mitigations

• Risk: If a future deployment moves docs away from the /docs sub-path, this will need to be updated.
  • Mitigation: Centralized link rewriting logic in localized_links.go makes this a single point of change.

Changed files

• scripts/docs-i18n/localized_links.go (modified, +2/-2)