openclaw/docs/help/faq-first-run.md
Vincent Koc fa3bc9a244
docs: fix and reciprocate cross-page links across install, help, reference, start, and web (#143773)
Closes link-kind audit findings for docs/install/, docs/help/, docs/reference/,
docs/start/, docs/web/ and docs/nodes/.

- start/hubs: point the Model providers hub entry at the provider directory
  (/providers) instead of the /providers/models quickstart duplicate.
- Add the missing reciprocal links the audit found: Cloudflare Containers,
  Kubernetes and Ansible from Docker and the Linux server page; macOS VMs from
  iMessage and the Linux server page; Podman from the sandbox Podman backend;
  Updating from Migrating; Docker from the Configuration page; Backups,
  Bootstrapping and Default AGENTS.md from Agent workspace; Bootstrapping from
  the BOOTSTRAP template; Tests from the two help testing pages; Session
  management deep dive from Context engine; Transcript hygiene from Session and
  Session pruning; SecretRef credential surface from Auth credential semantics;
  Device model database from the Nodes macOS section; RPC adapters from Signal
  and iMessage; Personal assistant setup from Getting started; Onboarding from
  the macOS platform page; The Lobster from Control UI settings; Release
  performance sweep from Dependency locking; Release policy from Release
  channels; Full release validation and Update and plugin tests from RELEASING.
- help/index: list the Scripts page under Testing.
- help/faq-first-run: add the Models FAQ to Related (was one-directional).
- reference/credits: replace the two off-topic Related links with the lore and
  pull-request-review-flow pages.
- reference/rich-output-protocol: replace the unrelated RPC adapters link with
  the Control UI hosted-embeds section that actually renders [embed ...].
- web/lobster: add a Related section.
- glossary: 17 append-only zh-CN sources for the new list-item link labels, each
  inserted beside a related existing term rather than at the end of the array.
2026-09-10 15:35:25 +09:00

12 KiB

summary read_when title sidebarTitle
FAQ: quick-start and first-run setup — install, onboard, auth, subscriptions, initial failures
New install, onboarding stuck, or first-run errors
Choosing auth and provider subscriptions
Cannot access docs.openclaw.ai, cannot open dashboard, install stuck
FAQ: first-run setup First-run FAQ

Quick-start and first-run Q&A. For everyday operations, models, auth, sessions, and troubleshooting see the main FAQ.

This page is an index. The first-run Q&A is documented on two pages, one per reader job. Open the page that matches your task.

Page Read it when
Quick start and first-run setup You are installing, onboarding, or hitting an error on the first run.
Providers, hardware, and hosting You are picking provider auth or a model, or deciding what machine to run this on.

Where each section moved

Every anchor from the previous single-page version keeps its target here, so an existing link such as /help/faq-first-run#why-am-i-seeing-http-429-ratelimiterror-from-anthropic still resolves. Each entry points at the page that now holds the content.