chore(sync): mirror docs from openclaw/openclaw@925d11d890

This commit is contained in:
openclaw-docs-sync[bot] 2026-04-24 06:44:29 +00:00
parent a9431a972e
commit ffac44a313
5 changed files with 35 additions and 27 deletions

View File

@ -1,5 +1,5 @@
{
"repository": "openclaw/openclaw",
"sha": "972c7112a292f2776b8008b8c0e311e64569236f",
"syncedAt": "2026-04-24T06:38:26.026Z"
"sha": "925d11d89054c5dd1ba31de5537d2ee3cb5cdd3b",
"syncedAt": "2026-04-24T06:43:03.131Z"
}

View File

@ -76,9 +76,8 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
## Quick start and first-run setup
First-run setup Q&A — install, onboard, auth routes, subscriptions, initial
failures — moved to a dedicated page:
[FAQ — quick start and first-run setup](/help/faq-first-run).
First-run Q&A — install, onboard, auth routes, subscriptions, initial failures —
lives on the [First-run FAQ](/help/faq-first-run).
## What is OpenClaw?
@ -1380,8 +1379,7 @@ failures — moved to a dedicated page:
## Models, failover, and auth profiles
Model Q&A — defaults, selection, aliases, switching, failover, auth profiles —
moved to a dedicated page:
[FAQ — models and auth profiles](/help/faq-models).
lives on the [Models FAQ](/help/faq-models).
## Gateway: ports, "already running", and remote mode
@ -1970,6 +1968,6 @@ Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHu
## Related
- [FAQ — quick start and first-run setup](/help/faq-first-run)
- [FAQ — models and auth profiles](/help/faq-models)
- [Troubleshooting](/help/troubleshooting)
- [First-run FAQ](/help/faq-first-run) — install, onboard, auth, subscriptions, early failures
- [Models FAQ](/help/faq-models) — model selection, failover, auth profiles
- [Troubleshooting](/help/troubleshooting) — symptom-first triage

View File

@ -1,26 +1,38 @@
---
summary: "Help hub: common fixes, install sanity, and where to look when something breaks"
read_when:
- Youre new and want the “what do I click/run” guide
- You are new and want a "what do I click/run" guide
- Something broke and you want the fastest path to a fix
title: "Help"
---
If you want a quick “get unstuck” flow, start here:
Quick "get unstuck" path for the most common problems:
- **Troubleshooting:** [Start here](/help/troubleshooting)
- **Install sanity (Node/npm/PATH):** [Install](/install/node#troubleshooting)
- **Gateway issues:** [Gateway troubleshooting](/gateway/troubleshooting)
- **Logs:** [Logging](/logging) and [Gateway logging](/gateway/logging)
- **Repairs:** [Doctor](/gateway/doctor)
- [Troubleshooting](/help/troubleshooting) — symptom-first decision tree
- [Debugging](/help/debugging) — watch mode, raw streams, dev profile
- [Install sanity](/install/node#troubleshooting) — Node / npm / PATH checks
- [Gateway troubleshooting](/gateway/troubleshooting) — gateway-specific issues
- [Doctor](/gateway/doctor) — automated repair + diagnostic bundle
If youre looking for conceptual questions (not “something broke”):
## FAQ
- [FAQ (concepts)](/help/faq)
- [FAQ](/help/faq) — day-to-day concepts and operational questions
- [First-run FAQ](/help/faq-first-run) — install, onboard, auth, subscriptions, early failures
- [Models FAQ](/help/faq-models) — model selection, failover, auth profiles
## Environment and debugging
## Diagnostics
- **Environment variables:** [Where OpenClaw loads env vars and precedence](/help/environment)
- **Debugging:** [Watch mode, raw streams, and dev profile](/help/debugging)
- **Testing:** [Test suites, live tests, and Docker runners](/help/testing)
- **Scripts:** [Repository helper scripts](/help/scripts)
- [Environment variables](/help/environment) — where OpenClaw loads env vars and precedence
- [Diagnostics flags](/diagnostics/flags) — runtime diagnostics and verbose modes
- [Node + tsx crash](/debug/node-issue) — specific Node / tsx runtime crash scenarios
## Testing
- [Testing](/help/testing) — test suites and Docker runners
- [Live tests](/help/testing-live) — network-touching provider and CLI smokes
## Community and meta
- [OpenClaw lore](/start/lore) — the story
- [Docs hubs](/start/hubs) — how this documentation is organized
- [Docs directory](/start/docs-directory) — full file map

View File

@ -6,8 +6,6 @@ read_when:
title: "General troubleshooting"
---
# Troubleshooting
If you only have 2 minutes, use this page as a triage front door.
## First 60 seconds

View File

@ -189,7 +189,7 @@ For the plugin authoring guide, see [Plugin SDK overview](/plugins/sdk-overview)
| `plugin-sdk/models-provider-runtime` | `/models` command/provider reply helpers |
| `plugin-sdk/skill-commands-runtime` | Skill command listing helpers |
| `plugin-sdk/native-command-registry` | Native command registry/build/serialize helpers |
| `plugin-sdk/agent-harness` | Experimental trusted-plugin surface for low-level agent harnesses: harness types, active-run steer/abort helpers, OpenClaw tool bridge helpers, and attempt result utilities |
| `plugin-sdk/agent-harness` | Experimental trusted-plugin surface for low-level agent harnesses: harness types, active-run steer/abort helpers, OpenClaw tool bridge helpers, tool progress formatting/detail helpers, and attempt result utilities |
| `plugin-sdk/provider-zai-endpoint` | Z.AI endpoint detection helpers |
| `plugin-sdk/infra-runtime` | System event/heartbeat helpers |
| `plugin-sdk/collection-runtime` | Small bounded cache helpers |