Skip to content

[Bug]: Broken anchor link in FAQ — Xfinity SSL troubleshooting reference #36970

@miraexhoi

Description

@miraexhoi

Bug type

Behavior bug (incorrect output/state without crash)

Summary

FAQ page contains a broken cross-document anchor link to a non-existent troubleshooting section about Xfinity/SSL errors.

Steps to reproduce

  1. Open https://docs.openclaw.ai/help/faq#i-cant-access-docsopenclawai-ssl-error-what-now
  2. Click the "Troubleshooting" link in that section
  3. Observe you land on /help/troubleshooting with no matching anchor

Expected behavior

The link navigates to a relevant troubleshooting section with additional Xfinity SSL details.

Actual behavior

The link targets /help/troubleshooting#docsopenclawai-shows-an-ssl-error-comcastxfinity, but that anchor does not exist in troubleshooting.md.
The page has only these sections: "First 60 seconds", "Anthropic long context 429", "Plugin install fails with missing openclaw extensions", and "Decision tree".

The link targets /help/troubleshooting#docsopenclawai-shows-an-ssl-error-comcastxfinity, but that anchor does not exist in troubleshooting.md.

The page has only these

  • sections: "First 60 seconds", "Anthropic long context 429", "Plugin install fails with missing openclaw extensions", and "Decision tree". On GitHub's file viewer,
  • clicking the link shows: "Error loading page — An unexpected error occured. Try reloading the page."

OpenClaw version

2026.3.3

Operating system

macOS 15.4

Install method

No response

Logs, screenshots, and evidence

Source: docs/help/faq.md line 452
Broken link: [Troubleshooting](/help/troubleshooting#docsopenclawai-shows-an-ssl-error-comcastxfinity)

grep result confirming anchor does not exist in target file:
$ grep -i "ssl\|xfinity\|comcast" docs/help/troubleshooting.md
(no matches)

When clicking the link from the GitHub repo file view:
"Error loading page — An unexpected error occured. Try reloading the page."

Impact and severity

Affected: Any user experiencing Comcast/Xfinity SSL blocks who follows the FAQ link
Severity: Low (docs-only, no runtime impact)
Frequency: 100% — the anchor simply does not exist
Consequence: Users land on the troubleshooting page with no scroll to relevant content; may assume the info is missing

Additional information

The FAQ section itself (line 448) already contains the full workaround (disable Xfinity Advanced Security or allowlist docs.openclaw.ai), so the cross-reference is redundant.
Removing the broken link is the simplest fix. I'll submit a PR shortly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingbug:behaviorIncorrect behavior without a crash

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions