mirror of
https://github.com/openclaw/openclaw.git
synced 2026-10-04 10:10:01 +00:00
c5af6a25ba
Each fix replaces a statement that contradicts the code, the CLI reference,
or the config schema. Authorities are quoted with file:line.
1. docs/start/setup.md:64 - bare `openclaw setup` routing
Said: "Bare `openclaw setup`, without `--baseline`, is an alias for
`openclaw onboard` and runs the full interactive wizard."
Authority: src/cli/program/register.setup.ts:23-40 `resolveSetupCommandRoute`
returns "system-agent" when `input.configured && (input.interactive ||
input.json)`, and falls to "onboarding" otherwise. docs/cli/setup.md:13-16
states the same routing. Corrected to the chat-first routing with a link to
the CLI reference.
2. docs/install/installer.md:238 - Alpine container tag
Said: "use an official `node:24-alpine` container".
Authority: scripts/install.sh:19 `NODE_DEFAULT_MAJOR=26` and
scripts/install.sh:2263 `echo "Use an official node:${NODE_DEFAULT_MAJOR}-alpine
container ..."`. docs/install/installer.md:104 already says `node:26-alpine`
for the same vulnerable-SQLite fallback. Changed 24 to 26.
3. docs/specs/codex-supervision.md:178 - `codex sessions` synopsis
The synopsis omitted `[--agent <id>]` while line 191 of the same page says all
three commands accept it.
Authority: extensions/codex/src/session-cli.ts:318-320 registers
`.command("sessions")` with `.option("--agent <id>", "Agent id that owns the
Codex sessions")`. docs/plugins/codex-supervision.md:220 shows the flag.
Added `[--agent <id>]`.
4. docs/providers/moonshot.md:38-40 - Kimi K3 thinking levels
Said: "OpenClaw exposes those exact levels and maps `/think xhigh` to `max`"
after listing the vendor's `low`, `high`, and `max` reasoning efforts.
Authority: extensions/moonshot/provider-policy-api.ts:8-12 registers
ALWAYS_THINKING_PROFILES with `[KIMI_K3_MODEL_ID]: { id: "max", label: "max" }`,
and lines 32-41 return `levels: [profile]` with `defaultLevel: profile.id`, so
only `max` is exposed. src/llm/providers/stream-wrappers/moonshot-thinking.ts:13-17
maps `"kimi-k3": "max"` and lines 62-70 overwrite the outgoing payload with
`payload.reasoning_effort = effort` after deleting `thinking` and
`reasoningEffort`. The accordion at line 320 already stated the max-only
behavior correctly and is left unchanged; the contradicting sentence at the top
of the page was corrected instead. The catalog thinkingLevelMap in
extensions/moonshot/openclaw.plugin.json is model metadata and does not make the
lower efforts usable on the direct Moonshot route.
5. docs/providers/perplexity-provider.md:82 - `count` transport
The filter table marked `count` "Native only" while line 90 says native-only
filters return an error on the chat-completions path.
Authority: extensions/perplexity/src/perplexity-web-search-provider.runtime.ts:305-316
`unsupportedOptions` covers country, language, date_after/date_before,
domain_filter, and max_tokens/max_tokens_per_page - `count` is absent, so it
does not error. Line 375 of the same file passes count only on the structured
path. docs/tools/perplexity-search.md:144-146 says count is accepted and
compatibility-only on the Sonar path. Changed the row to "Both" and noted that
the chat-completions path ignores it.
6. docs/providers/qianfan.md:76 - onboarding default model
Said the config example "explicitly selects the current DeepSeek flagship
instead of the onboarding compatibility default", but it selects
`qianfan/deepseek-v4-pro`, which is the onboarding default.
Authority: extensions/qianfan/provider-catalog.ts:7
`export const QIANFAN_DEFAULT_MODEL_ID = "deepseek-v4-pro";`, consumed at
extensions/qianfan/onboard.ts:49 as `defaultModelId`. The same page states this
at lines 17 and 44.
7. docs/help/faq.md:821 - Gateway host platforms
Said: "The Gateway runs on macOS/Linux (Windows via WSL2)".
Authority: docs/platforms/windows.md:118 "## Native Windows CLI and Gateway"
with the PowerShell install and `openclaw gateway status` runbook;
docs/help/faq.md:1319 documents "Native Windows CLI/Gateway: runs directly in
Windows". Corrected to macOS, Linux, and Windows (native or WSL2).
8. docs/help/faq.md:900 - node local tools by platform
Said: "Local node tools are currently macOS-only."
Authority: docs/nodes/index.md:772-779 gives default node command allowlists for
iOS, watchOS, Android, macOS, Windows, and Linux, including `camera.list` and
`location.get` on iOS/Android/Windows and `computer.act` on Windows and Linux.
docs/help/faq.md:719 says Macs/iOS/Android nodes expose local tools. Replaced
with a platform-dependent statement plus a link to /nodes.
9. docs/concepts/features.md:35 - channels shipped in core
Said only Telegram and WebChat ship with the core install.
Authority: package.json `files` excludes non-bundled plugins as
`!dist/extensions/<id>/**` (for example `!dist/extensions/discord/**`,
`!dist/extensions/slack/**`); `a2a`, `reef`, and `telegram` carry no such
exclusion, so they ship in the package. docs/channels/index.md:12 defines
"bundled plugin"/"included in core" as shipping with the core install, and
lines 38, 54, 59, and 62 mark A2A, Reef, Telegram, and WebChat that way.
10. docs/gateway/logging.md:142 - settable console styles
Said: "Console styles: `pretty` | `compact` | `json`."
Authority: src/config/zod-schema.root-shape.ts:117
`consoleStyle: z.union([z.literal("pretty"), z.literal("json")]).optional()`
and src/config/types.base.ts:287 `consoleStyle?: "pretty" | "json";`.
docs/gateway/logging.md:82 already says `compact` is no longer settable and is
applied automatically off a TTY.
11. docs/gateway/multiple-gateways.md:34 - rescue-profile port spacing
Said: "Use a base port at least 20 higher than the main bot", while line 20 of
the same page requires 120.
Authority: extensions/browser/src/config/port-defaults.ts:27-29
`deriveDefaultBrowserControlPort` returns `gatewayPort + 2`, and lines 32-34
`deriveDefaultBrowserCdpPortRange` returns `start = controlPort + 9`,
`end = start + DEFAULT_BROWSER_CDP_PORT_RANGE_SPAN` where the span is
18899 - 18800 = 99. Each Gateway therefore reaches base + 110, so 20-port
spacing overlaps. Changed 20 to 120.
Closes audit findings: r3-0772, r3-0428, r3-0754, r3-0671, r5-0045, r3-0682, r3-0393, r3-0394, r3-0278, r3-0386, r5-0004
|
||
|---|---|---|
| .. | ||
| bootstrapping.md | ||
| docs-directory.md | ||
| getting-started.md | ||
| hubs.md | ||
| lore.md | ||
| onboarding-overview.md | ||
| onboarding.md | ||
| openclaw.md | ||
| setup.md | ||
| showcase.md | ||
| teams.md | ||
| why-openclaw.md | ||
| wizard-cli-automation.md | ||
| wizard-cli-reference.md | ||
| wizard.md | ||