diff --git a/.github/instructions/copilot.instructions.md b/.github/instructions/copilot.instructions.md
index 8686521cfc..4536a95269 100644
--- a/.github/instructions/copilot.instructions.md
+++ b/.github/instructions/copilot.instructions.md
@@ -55,7 +55,7 @@
 ## Stack & Commands
 
 - **Package manager**: pnpm (`pnpm install`)
-- **Dev**: `pnpm openclaw ...` or `pnpm dev`
+- **Dev**: `pnpm mirror ...` or `pnpm dev`
 - **Type-check**: `pnpm tsgo`
 - **Lint/format**: `pnpm check`
 - **Tests**: `pnpm test`
diff --git a/docs/help/debugging.md b/docs/help/debugging.md
index 61539ec39a..307a1e91c8 100644
--- a/docs/help/debugging.md
+++ b/docs/help/debugging.md
@@ -63,7 +63,7 @@ pnpm gateway:dev
 OPENCLAW_PROFILE=dev openclaw tui
 ```
 
-If you don’t have a global install yet, run the CLI via `pnpm openclaw ...`.
+If you don’t have a global install yet, run the canonical repo CLI via `pnpm mirror ...`.
 
 What this does:
 
diff --git a/docs/install/index.md b/docs/install/index.md
index 285324ed6b..9f92089bf4 100644
--- a/docs/install/index.md
+++ b/docs/install/index.md
@@ -126,7 +126,7 @@ For VPS/cloud hosts, avoid third-party "1-click" marketplace images when possibl
         pnpm link --global
         ```
 
-        Alternatively, skip the link and run commands via `pnpm openclaw ...` from inside the repo.
+        Alternatively, skip the link and run canonical repo commands via `pnpm mirror ...` from inside the repo.
       </Step>
       <Step title="Run onboarding">
         ```bash
diff --git a/docs/install/updating.md b/docs/install/updating.md
index f94c260077..f5a363804b 100644
--- a/docs/install/updating.md
+++ b/docs/install/updating.md
@@ -161,9 +161,9 @@ openclaw health
 
 Notes:
 
-- `pnpm build` matters when you run the packaged `openclaw` binary ([`openclaw.mjs`](https://github.com/openclaw/openclaw/blob/main/openclaw.mjs)) or use Node to run `dist/`.
-- If you run from a repo checkout without a global install, use `pnpm openclaw ...` for CLI commands.
-- If you run directly from TypeScript (`pnpm openclaw ...`), a rebuild is usually unnecessary, but **config migrations still apply** → run doctor.
+- `pnpm build` matters when you run the packaged CLI from a global install or use Node to run `dist/`.
+- If you run from a repo checkout without a global install, use `pnpm mirror ...` for canonical CLI commands.
+- If you run directly from the repo (`pnpm mirror ...`), a rebuild is usually unnecessary, but **config migrations still apply** → run doctor.
 - Switching between global and git installs is easy: install the other flavor, then run `openclaw doctor` so the gateway service entrypoint is rewritten to the current install.
 
 ## Always Run: `openclaw doctor`