From f2b3b3d912b9a54692488b5adfae7d0e8d113275 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 4 Apr 2026 13:34:02 +0100
Subject: [PATCH] docs: clarify setup node-manager refs

---
 docs/cli/index.md                  | 2 +-
 docs/reference/wizard.md           | 2 ++
 docs/start/wizard-cli-reference.md | 2 ++
 docs/tools/skills-config.md        | 3 +++
 4 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/cli/index.md b/docs/cli/index.md
index e3c6a7042b5..1f2cf65f3eb 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -546,7 +546,7 @@ Options:
 - `--skip-ui`
 - `--cloudflare-ai-gateway-account-id <id>`
 - `--cloudflare-ai-gateway-gateway-id <id>`
-- `--node-manager <npm|pnpm|yarn|bun>` (node manager for skills; pnpm recommended, bun and yarn also supported)
+- `--node-manager <npm|pnpm|bun>` (setup/onboarding node manager for skills; pnpm recommended, bun also supported)
 - `--json`
 
 ### `configure`
diff --git a/docs/reference/wizard.md b/docs/reference/wizard.md
index 608518e49d0..95afa248506 100644
--- a/docs/reference/wizard.md
+++ b/docs/reference/wizard.md
@@ -220,6 +220,8 @@ Typical fields in `~/.openclaw/openclaw.json`:
 - `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
 - Channel allowlists (Slack/Discord/Matrix/Microsoft Teams) when you opt in during the prompts (names resolve to IDs when possible).
 - `skills.install.nodeManager`
+  - `setup --node-manager` accepts `npm`, `pnpm`, or `bun`.
+  - Manual config can still use `yarn` by setting `skills.install.nodeManager` directly.
 - `wizard.lastRunAt`
 - `wizard.lastRunVersion`
 - `wizard.lastRunCommit`
diff --git a/docs/start/wizard-cli-reference.md b/docs/start/wizard-cli-reference.md
index d4de1b3c741..a6ed512b078 100644
--- a/docs/start/wizard-cli-reference.md
+++ b/docs/start/wizard-cli-reference.md
@@ -281,6 +281,8 @@ Typical fields in `~/.openclaw/openclaw.json`:
 - `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
 - Channel allowlists (Slack, Discord, Matrix, Microsoft Teams) when you opt in during prompts (names resolve to IDs when possible)
 - `skills.install.nodeManager`
+  - The `setup --node-manager` flag accepts `npm`, `pnpm`, or `bun`.
+  - Manual config can still set `skills.install.nodeManager: "yarn"` later.
 - `wizard.lastRunAt`
 - `wizard.lastRunVersion`
 - `wizard.lastRunCommit`
diff --git a/docs/tools/skills-config.md b/docs/tools/skills-config.md
index 1c9ce800918..84dfbdadc00 100644
--- a/docs/tools/skills-config.md
+++ b/docs/tools/skills-config.md
@@ -95,6 +95,9 @@ Rules:
 - `install.nodeManager`: node installer preference (`npm` | `pnpm` | `yarn` | `bun`, default: npm).
   This only affects **skill installs**; the Gateway runtime should still be Node
   (Bun not recommended for WhatsApp/Telegram).
+  - `openclaw setup --node-manager` is narrower and currently accepts `npm`,
+    `pnpm`, or `bun`. Set `skills.install.nodeManager: "yarn"` manually if you
+    want Yarn-backed skill installs.
 - `entries.<skillKey>`: per-skill overrides.
 - `agents.defaults.skills`: optional default skill allowlist inherited by agents
   that omit `agents.list[].skills`.