@bitseek/claw 1.1.0-beta.2 → 1.2.1

package/dist/{workspace-CswOYN9T.js → workspace-D6mrCnXi.js}

@@ -1,12 +1,12 @@
-import { c as resolveStateDir } from "./paths-DKuX7-1L.js";
-import { c as danger, p as shouldLogVerbose } from "./subsystem-CAatx5oo.js";
+import { c as resolveStateDir } from "./paths-aGRLvQx9.js";
+import { c as danger, p as shouldLogVerbose } from "./subsystem-BRjuJbbM.js";
 import { b as isCronSessionKey, x as isSubagentSessionKey } from "./session-key-a6av96Fj.js";
-import { f as pathExists$1, h as resolveUserPath } from "./utils-Bo1RFF0l.js";
-import { n as logError, t as logDebug } from "./logger-DelEB7MK.js";
+import { f as pathExists$1, h as resolveUserPath } from "./utils-BFZnl-5N.js";
+import { n as logError, t as logDebug } from "./logger-BlH5MJiV.js";
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import fs$1 from "node:fs";
+import syncFs from "node:fs";
 import { promisify } from "node:util";
 import { execFile, spawn } from "node:child_process";
 import process$1 from "node:process";
@@ -314,7 +314,7 @@ function resolveBoundaryPathLexicalSync(params) {
 			rootCanonicalPath: params.rootCanonicalPath,
 			resolveParams: params.params,
 			absolutePath: params.absolutePath,
-			read: (cursor) => fs$1.lstatSync(cursor)
+			read: (cursor) => syncFs.lstatSync(cursor)
 		});
 		if (isPromiseLike(maybeStat)) throw new Error("Unexpected async lexical stat");
 		const stat = maybeStat;
@@ -460,15 +460,15 @@ function resolvePathViaExistingAncestorSync(targetPath) {
 	const normalized = path.resolve(targetPath);
 	let cursor = normalized;
 	const missingSuffix = [];
-	while (!isFilesystemRoot(cursor) && !fs$1.existsSync(cursor)) {
+	while (!isFilesystemRoot(cursor) && !syncFs.existsSync(cursor)) {
 		missingSuffix.unshift(path.basename(cursor));
 		const parent = path.dirname(cursor);
 		if (parent === cursor) break;
 		cursor = parent;
 	}
-	if (!fs$1.existsSync(cursor)) return normalized;
+	if (!syncFs.existsSync(cursor)) return normalized;
 	try {
-		const resolvedAncestor = path.resolve(fs$1.realpathSync(cursor));
+		const resolvedAncestor = path.resolve(syncFs.realpathSync(cursor));
 		if (missingSuffix.length === 0) return resolvedAncestor;
 		return path.resolve(resolvedAncestor, ...missingSuffix);
 	} catch {
@@ -493,7 +493,7 @@ function getPathKindSync(absolutePath, preserveFinalSymlink) {
 	try {
 		return {
 			exists: true,
-			kind: toResolvedKind(preserveFinalSymlink ? fs$1.lstatSync(absolutePath) : fs$1.statSync(absolutePath))
+			kind: toResolvedKind(preserveFinalSymlink ? syncFs.lstatSync(absolutePath) : syncFs.statSync(absolutePath))
 		};
 	} catch (error) {
 		if (isNotFoundPathError(error)) return {
@@ -553,10 +553,10 @@ async function resolveSymlinkHopPath(symlinkPath) {
 }
 function resolveSymlinkHopPathSync(symlinkPath) {
 	try {
-		return path.resolve(fs$1.realpathSync(symlinkPath));
+		return path.resolve(syncFs.realpathSync(symlinkPath));
 	} catch (error) {
 		if (!isNotFoundPathError(error)) throw error;
-		const linkTarget = fs$1.readlinkSync(symlinkPath);
+		const linkTarget = syncFs.readlinkSync(symlinkPath);
 		return resolvePathViaExistingAncestorSync(path.resolve(path.dirname(symlinkPath), linkTarget));
 	}
 }
@@ -582,7 +582,7 @@ function sameFileIdentity(left, right) {
 	return sameFileIdentity$1(left, right);
 }
 function openVerifiedFileSync(params) {
-	const ioFs = params.ioFs ?? fs$1;
+	const ioFs = params.ioFs ?? syncFs;
 	const allowedType = params.allowedType ?? "file";
 	const openReadFlags = ioFs.constants.O_RDONLY | (typeof ioFs.constants.O_NOFOLLOW === "number" ? ioFs.constants.O_NOFOLLOW : 0);
 	let fd = null;
@@ -659,7 +659,7 @@ function canUseBoundaryFileOpen(ioFs) {
 	return typeof ioFs.openSync === "function" && typeof ioFs.closeSync === "function" && typeof ioFs.fstatSync === "function" && typeof ioFs.lstatSync === "function" && typeof ioFs.realpathSync === "function" && typeof ioFs.readFileSync === "function" && typeof ioFs.constants === "object" && ioFs.constants !== null;
 }
 function openBoundaryFileSync(params) {
-	const ioFs = params.ioFs ?? fs$1;
+	const ioFs = params.ioFs ?? syncFs;
 	const resolved = resolveBoundaryFilePathGeneric({
 		absolutePath: params.absolutePath,
 		resolve: (absolutePath) => resolveBoundaryPathSync({
@@ -710,7 +710,7 @@ function finalizeBoundaryFileOpen(params) {
 	});
 }
 async function openBoundaryFile(params) {
-	const ioFs = params.ioFs ?? fs$1;
+	const ioFs = params.ioFs ?? syncFs;
 	const maybeResolved = resolveBoundaryFilePathGeneric({
 		absolutePath: params.absolutePath,
 		resolve: (absolutePath) => resolveBoundaryPath({
@@ -859,7 +859,7 @@ function resolveNpmArgvForWindows(argv) {
 	if (!cliName) return null;
 	const nodeDir = path.dirname(process$1.execPath);
 	const cliPath = path.join(nodeDir, "node_modules", "npm", "bin", cliName);
-	if (!fs$1.existsSync(cliPath)) return null;
+	if (!syncFs.existsSync(cliPath)) return null;
 	return [
 		process$1.execPath,
 		cliPath,
@@ -1065,7 +1065,7 @@ async function readPackageName(dir) {
 }
 function readPackageNameSync(dir) {
 	try {
-		const raw = fs$1.readFileSync(path.join(dir, "package.json"), "utf-8");
+		const raw = syncFs.readFileSync(path.join(dir, "package.json"), "utf-8");
 		const parsed = JSON.parse(raw);
 		return typeof parsed.name === "string" ? parsed.name : null;
 	} catch {
@@ -1099,7 +1099,7 @@ function candidateDirsFromArgv1(argv1) {
 	const normalized = path.resolve(argv1);
 	const candidates = [path.dirname(normalized)];
 	try {
-		const resolved = fs$1.realpathSync(normalized);
+		const resolved = syncFs.realpathSync(normalized);
 		if (resolved !== normalized) candidates.push(path.dirname(resolved));
 	} catch {}
 	const parts = normalized.split(path.sep);
@@ -1208,14 +1208,14 @@ async function readWorkspaceFileWithGuards(params) {
 	const identity = workspaceFileIdentity(opened.stat, opened.path);
 	const cached = workspaceFileCache.get(params.filePath);
 	if (cached && cached.identity === identity) {
-		fs$1.closeSync(opened.fd);
+		syncFs.closeSync(opened.fd);
 		return {
 			ok: true,
 			content: cached.content
 		};
 	}
 	try {
-		const content = fs$1.readFileSync(opened.fd, "utf-8");
+		const content = syncFs.readFileSync(opened.fd, "utf-8");
 		workspaceFileCache.set(params.filePath, {
 			content,
 			identity
@@ -1232,7 +1232,7 @@ async function readWorkspaceFileWithGuards(params) {
 			error
 		};
 	} finally {
-		fs$1.closeSync(opened.fd);
+		syncFs.closeSync(opened.fd);
 	}
 }
 function stripFrontMatter(content) {

package/dist/{workspace-BHfqkuYN.js → workspace-DzeL98px.js}

@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
 import path from "node:path";
 import os from "node:os";
 import fs from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsPromises from "node:fs/promises";
 
 //#region src/agents/skills/filter.ts
 function normalizeSkillFilter(skillFilter) {
@@ -292,7 +292,7 @@ async function resolveBoundaryPathLexicalAsync(params) {
 		const stat = await readLexicalStat({
 			...sharedStepParams,
 			missingFromIndex: idx,
-			read: (cursor) => fs$1.lstat(cursor)
+			read: (cursor) => fsPromises.lstat(cursor)
 		});
 		if (!stat) break;
 		const disposition = handleLexicalStatDisposition({
@@ -464,7 +464,7 @@ async function resolvePathViaExistingAncestor(targetPath) {
 	}
 	if (!await pathExists(cursor)) return normalized;
 	try {
-		const resolvedAncestor = path.resolve(await fs$1.realpath(cursor));
+		const resolvedAncestor = path.resolve(await fsPromises.realpath(cursor));
 		if (missingSuffix.length === 0) return resolvedAncestor;
 		return path.resolve(resolvedAncestor, ...missingSuffix);
 	} catch {
@@ -494,7 +494,7 @@ async function getPathKind(absolutePath, preserveFinalSymlink) {
 	try {
 		return {
 			exists: true,
-			kind: toResolvedKind(preserveFinalSymlink ? await fs$1.lstat(absolutePath) : await fs$1.stat(absolutePath))
+			kind: toResolvedKind(preserveFinalSymlink ? await fsPromises.lstat(absolutePath) : await fsPromises.stat(absolutePath))
 		};
 	} catch (error) {
 		if (isNotFoundPathError(error)) return {
@@ -550,7 +550,7 @@ function isFilesystemRoot(candidate) {
 }
 async function pathExists(targetPath) {
 	try {
-		await fs$1.lstat(targetPath);
+		await fsPromises.lstat(targetPath);
 		return true;
 	} catch (error) {
 		if (isNotFoundPathError(error)) return false;
@@ -559,10 +559,10 @@ async function pathExists(targetPath) {
 }
 async function resolveSymlinkHopPath(symlinkPath) {
 	try {
-		return path.resolve(await fs$1.realpath(symlinkPath));
+		return path.resolve(await fsPromises.realpath(symlinkPath));
 	} catch (error) {
 		if (!isNotFoundPathError(error)) throw error;
-		const linkTarget = await fs$1.readlink(symlinkPath);
+		const linkTarget = await fsPromises.readlink(symlinkPath);
 		return resolvePathViaExistingAncestor(path.resolve(path.dirname(symlinkPath), linkTarget));
 	}
 }
@@ -779,7 +779,7 @@ const CORE_PACKAGE_NAMES = new Set([
 ]);
 async function readPackageName(dir) {
 	try {
-		const raw = await fs$1.readFile(path.join(dir, "package.json"), "utf-8");
+		const raw = await fsPromises.readFile(path.join(dir, "package.json"), "utf-8");
 		const parsed = JSON.parse(raw);
 		return typeof parsed.name === "string" ? parsed.name : null;
 	} catch {
@@ -974,7 +974,7 @@ async function loadTemplate(name) {
 		const templateDir = await resolveWorkspaceTemplateDir();
 		const templatePath = path.join(templateDir, name);
 		try {
-			return stripFrontMatter(await fs$1.readFile(templatePath, "utf-8"));
+			return stripFrontMatter(await fsPromises.readFile(templatePath, "utf-8"));
 		} catch {
 			throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
 		}
@@ -989,7 +989,7 @@ async function loadTemplate(name) {
 }
 async function writeFileIfMissing(filePath, content) {
 	try {
-		await fs$1.writeFile(filePath, content, {
+		await fsPromises.writeFile(filePath, content, {
 			encoding: "utf-8",
 			flag: "wx"
 		});
@@ -1001,7 +1001,7 @@ async function writeFileIfMissing(filePath, content) {
 }
 async function fileExists(filePath) {
 	try {
-		await fs$1.access(filePath);
+		await fsPromises.access(filePath);
 		return true;
 	} catch {
 		return false;
@@ -1034,7 +1034,7 @@ function parseWorkspaceOnboardingState(raw) {
 }
 async function readWorkspaceOnboardingState(statePath) {
 	try {
-		return parseWorkspaceOnboardingState(await fs$1.readFile(statePath, "utf-8")) ?? { version: WORKSPACE_STATE_VERSION };
+		return parseWorkspaceOnboardingState(await fsPromises.readFile(statePath, "utf-8")) ?? { version: WORKSPACE_STATE_VERSION };
 	} catch (err) {
 		if (err.code !== "ENOENT") throw err;
 		return { version: WORKSPACE_STATE_VERSION };
@@ -1048,20 +1048,20 @@ async function isWorkspaceOnboardingCompleted(dir) {
 	return typeof state.onboardingCompletedAt === "string" && state.onboardingCompletedAt.trim().length > 0;
 }
 async function writeWorkspaceOnboardingState(statePath, state) {
-	await fs$1.mkdir(path.dirname(statePath), { recursive: true });
+	await fsPromises.mkdir(path.dirname(statePath), { recursive: true });
 	const payload = `${JSON.stringify(state, null, 2)}\n`;
 	const tmpPath = `${statePath}.tmp-${process.pid}-${Date.now().toString(36)}`;
 	try {
-		await fs$1.writeFile(tmpPath, payload, { encoding: "utf-8" });
-		await fs$1.rename(tmpPath, statePath);
+		await fsPromises.writeFile(tmpPath, payload, { encoding: "utf-8" });
+		await fsPromises.rename(tmpPath, statePath);
 	} catch (err) {
-		await fs$1.unlink(tmpPath).catch(() => {});
+		await fsPromises.unlink(tmpPath).catch(() => {});
 		throw err;
 	}
 }
 async function hasGitRepo(dir) {
 	try {
-		await fs$1.stat(path.join(dir, ".git"));
+		await fsPromises.stat(path.join(dir, ".git"));
 		return true;
 	} catch {
 		return false;
@@ -1091,7 +1091,7 @@ async function ensureGitRepo(dir, isBrandNewWorkspace) {
 }
 async function ensureAgentWorkspace(params) {
 	const dir = resolveUserPath(params?.dir?.trim() ? params.dir.trim() : DEFAULT_AGENT_WORKSPACE_DIR);
-	await fs$1.mkdir(dir, { recursive: true });
+	await fsPromises.mkdir(dir, { recursive: true });
 	if (!params?.ensureBootstrapFiles) return { dir };
 	const agentsPath = path.join(dir, DEFAULT_AGENTS_FILENAME);
 	const soulPath = path.join(dir, DEFAULT_SOUL_FILENAME);
@@ -1118,7 +1118,7 @@ async function ensureAgentWorkspace(params) {
 		const paths = [...templatePaths, ...userContentPaths];
 		return (await Promise.all(paths.map(async (p) => {
 			try {
-				await fs$1.access(p);
+				await fsPromises.access(p);
 				return true;
 			} catch {
 				return false;
@@ -1151,7 +1151,7 @@ async function ensureAgentWorkspace(params) {
 	if (!state.bootstrapSeededAt && bootstrapExists) markState({ bootstrapSeededAt: nowIso() });
 	if (!state.onboardingCompletedAt && state.bootstrapSeededAt && !bootstrapExists) markState({ onboardingCompletedAt: nowIso() });
 	if (!state.bootstrapSeededAt && !state.onboardingCompletedAt && !bootstrapExists) {
-		const [identityContent, userContent] = await Promise.all([fs$1.readFile(identityPath, "utf-8"), fs$1.readFile(userPath, "utf-8")]);
+		const [identityContent, userContent] = await Promise.all([fsPromises.readFile(identityPath, "utf-8"), fsPromises.readFile(userPath, "utf-8")]);
 		const hasUserContent = await (async () => {
 			const indicators = [
 				path.join(dir, "memory"),
@@ -1159,7 +1159,7 @@ async function ensureAgentWorkspace(params) {
 				path.join(dir, ".git")
 			];
 			for (const indicator of indicators) try {
-				await fs$1.access(indicator);
+				await fsPromises.access(indicator);
 				return true;
 			} catch {}
 			return false;
@@ -1190,7 +1190,7 @@ async function resolveMemoryBootstrapEntries(resolvedDir) {
 	for (const name of candidates) {
 		const filePath = path.join(resolvedDir, name);
 		try {
-			await fs$1.access(filePath);
+			await fsPromises.access(filePath);
 			entries.push({
 				name,
 				filePath
@@ -1203,7 +1203,7 @@ async function resolveMemoryBootstrapEntries(resolvedDir) {
 	for (const entry of entries) {
 		let key = entry.filePath;
 		try {
-			key = await fs$1.realpath(entry.filePath);
+			key = await fsPromises.realpath(entry.filePath);
 		} catch {}
 		if (seen.has(key)) continue;
 		seen.add(key);

package/dist/{workspace-dirs-BOgNOBjy.js → workspace-dirs-Bevk6X_8.js}

@@ -1,4 +1,4 @@
-import { d as resolveDefaultAgentId, u as resolveAgentWorkspaceDir } from "./agent-scope-CJelRKYY.js";
+import { d as resolveDefaultAgentId, u as resolveAgentWorkspaceDir } from "./agent-scope-CY2-lUIY.js";
 
 //#region src/agents/workspace-dirs.ts
 function listAgentWorkspaceDirs(cfg) {

package/dist/{wsl-BDRu1-pk.js → wsl-DksyFTBT.js}

@@ -1,5 +1,5 @@
 import { readFileSync } from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsPromises from "node:fs/promises";
 
 //#region src/infra/wsl.ts
 let wslCached = null;
@@ -40,7 +40,7 @@ async function isWSL() {
 		return wslCached;
 	}
 	try {
-		const release = await fs$1.readFile("/proc/sys/kernel/osrelease", "utf8");
+		const release = await fsPromises.readFile("/proc/sys/kernel/osrelease", "utf8");
 		wslCached = release.toLowerCase().includes("microsoft") || release.toLowerCase().includes("wsl");
 	} catch {
 		wslCached = false;

package/docs/install/index.md

@@ -75,15 +75,15 @@ For VPS/cloud hosts, avoid third-party "1-click" marketplace images when possibl
     <Tabs>
       <Tab title="npm">
         ```bash
-        npm install -g openclaw@latest
-        openclaw onboard --install-daemon
+        npm install -g @bitseek/claw@latest
+        bitseek-claw onboard --install-daemon
         ```
 
         <Accordion title="sharp build errors?">
           If you have libvips installed globally (common on macOS via Homebrew) and `sharp` fails, force prebuilt binaries:
 
           ```bash
-          SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
+          SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g @bitseek/claw@latest
           ```
 
           If you see `sharp: Please add node-gyp to your dependencies`, either install build tooling (macOS: Xcode CLT + `npm install -g node-gyp`) or use the env var above.
@@ -91,9 +91,9 @@ For VPS/cloud hosts, avoid third-party "1-click" marketplace images when possibl
       </Tab>
       <Tab title="pnpm">
         ```bash
-        pnpm add -g openclaw@latest
-        pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
-        openclaw onboard --install-daemon
+        pnpm add -g @bitseek/claw@latest
+        pnpm approve-builds -g        # approve @bitseek/claw, node-llama-cpp, sharp, etc.
+        bitseek-claw onboard --install-daemon
         ```
 
         <Note>
@@ -130,7 +130,7 @@ For VPS/cloud hosts, avoid third-party "1-click" marketplace images when possibl
       </Step>
       <Step title="Run onboarding">
         ```bash
-        openclaw onboard --install-daemon
+        bitseek-claw onboard --install-daemon
         ```
       </Step>
     </Steps>
@@ -165,9 +165,9 @@ For VPS/cloud hosts, avoid third-party "1-click" marketplace images when possibl
 Verify everything is working:
 
 ```bash
-openclaw doctor         # check for config issues
-openclaw status         # gateway status
-openclaw dashboard      # open the browser UI
+bitseek-claw doctor         # check for config issues
+bitseek-claw status         # gateway status
+bitseek-claw dashboard      # open the browser UI
 ```
 
 If you need custom runtime paths, use:
@@ -178,7 +178,7 @@ If you need custom runtime paths, use:
 
 See [Environment vars](/help/environment) for precedence and full details.
 
-## Troubleshooting: `openclaw` not found
+## Troubleshooting: `bitseek-claw` not found
 
 <Accordion title="PATH diagnosis and fix">
   Quick diagnosis:
@@ -190,7 +190,7 @@ npm prefix -g
 echo "$PATH"
 ```
 
-If `$(npm prefix -g)/bin` (macOS/Linux) or `$(npm prefix -g)` (Windows) is **not** in your `$PATH`, your shell can't find global npm binaries (including `openclaw`).
+If `$(npm prefix -g)/bin` (macOS/Linux) or `$(npm prefix -g)` (Windows) is **not** in your `$PATH`, your shell can't find global npm binaries (including `bitseek-claw`).
 
 Fix — add it to your shell startup file (`~/.zshrc` or `~/.bashrc`):
 

package/docs/install/updating.md

@@ -31,7 +31,6 @@ Notes:
 
   The installer will `git pull --rebase` **only** if the repo is clean.
 
-- For **global installs**, the script uses `npm install -g openclaw@latest` under the hood.
 - Legacy note: `clawdbot` remains available as a compatibility shim.
 
 ## Before you update
@@ -48,11 +47,11 @@ Notes:
 Global install (pick one):
 
 ```bash
-npm i -g openclaw@latest
+npm i -g @bitseek/claw@latest
 ```
 
 ```bash
-pnpm add -g openclaw@latest
+pnpm add -g @bitseek/claw@latest
 ```
 
 We do **not** recommend Bun for the Gateway runtime (WhatsApp/Telegram bugs).
@@ -60,9 +59,9 @@ We do **not** recommend Bun for the Gateway runtime (WhatsApp/Telegram bugs).
 To switch update channels (git + npm installs):
 
 ```bash
-openclaw update --channel beta
-openclaw update --channel dev
-openclaw update --channel stable
+bitseek-claw update --channel beta
+bitseek-claw update --channel dev
+bitseek-claw update --channel stable
 ```
 
 Use `--tag <dist-tag|version>` for a one-off install tag/version.
@@ -95,27 +94,27 @@ Behavior:
 - `beta`: checks on `betaCheckIntervalHours` cadence (default: hourly) and applies when an update is available.
 - `dev`: no automatic apply; use manual `openclaw update`.
 
-Use `openclaw update --dry-run` to preview update actions before enabling automation.
+Use `bitseek-claw update --dry-run` to preview update actions before enabling automation.
 
 Then:
 
 ```bash
-openclaw doctor
-openclaw gateway restart
-openclaw health
+bitseek-claw doctor
+bitseek-claw gateway restart
+bitseek-claw health
 ```
 
 Notes:
 
-- If your Gateway runs as a service, `openclaw gateway restart` is preferred over killing PIDs.
+- If your Gateway runs as a service, `bitseek-claw gateway restart` is preferred over killing PIDs.
 - If you’re pinned to a specific version, see “Rollback / pinning” below.
 
-## Update (`openclaw update`)
+## Update (`bitseek-claw update`)
 
 For **source installs** (git checkout), prefer:
 
 ```bash
-openclaw update
+bitseek-claw update
 ```
 
 It runs a safe-ish update flow:
@@ -123,16 +122,16 @@ It runs a safe-ish update flow:
 - Requires a clean worktree.
 - Switches to the selected channel (tag or branch).
 - Fetches + rebases against the configured upstream (dev channel).
-- Installs deps, builds, builds the Control UI, and runs `openclaw doctor`.
+- Installs deps, builds, builds the Control UI, and runs `bitseek-claw doctor`.
 - Restarts the gateway by default (use `--no-restart` to skip).
 
-If you installed via **npm/pnpm** (no git metadata), `openclaw update` will try to update via your package manager. If it can’t detect the install, use “Update (global install)” instead.
+If you installed via **npm/pnpm** (no git metadata), `bitseek-claw update` will try to update via your package manager. If it can’t detect the install, use “Update (global install)” instead.
 
 ## Update (Control UI / RPC)
 
 The Control UI has **Update & Restart** (RPC: `update.run`). It:
 
-1. Runs the same source-update flow as `openclaw update` (git checkout only).
+1. Runs the same source-update flow as `bitseek-claw update` (git checkout only).
 2. Writes a restart sentinel with a structured report (stdout/stderr tail).
 3. Restarts the gateway and pings the last active session with the report.
 
@@ -145,7 +144,7 @@ From the repo checkout:
 Preferred:
 
 ```bash
-openclaw update
+bitseek-claw update
 ```
 
 Manual (equivalent-ish):
@@ -155,8 +154,8 @@ git pull
 pnpm install
 pnpm build
 pnpm ui:build # auto-installs UI deps on first run
-openclaw doctor
-openclaw health
+bitseek-claw doctor
+bitseek-claw health
 ```
 
 Notes:
@@ -164,13 +163,13 @@ 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.
-- 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.
+- Switching between global and git installs is easy: install the other flavor, then run `bitseek-claw doctor` so the gateway service entrypoint is rewritten to the current install.
 
-## Always Run: `openclaw doctor`
+## Always Run: `bitseek-claw doctor`
 
 Doctor is the “safe update” command. It’s intentionally boring: repair + migrate + warn.
 
-Note: if you’re on a **source install** (git checkout), `openclaw doctor` will offer to run `openclaw update` first.
+Note: if you’re on a **source install** (git checkout), `bitseek-claw doctor` will offer to run `bitseek-claw update` first.
 
 Typical things it does:
 
@@ -187,11 +186,11 @@ Details: [Doctor](/gateway/doctor)
 CLI (works regardless of OS):
 
 ```bash
-openclaw gateway status
-openclaw gateway stop
-openclaw gateway restart
-openclaw gateway --port 18789
-openclaw logs --follow
+bitseek-claw gateway status
+bitseek-claw gateway stop
+bitseek-claw gateway restart
+bitseek-claw gateway --port 18789
+bitseek-claw logs --follow
 ```
 
 If you’re supervised:
@@ -199,7 +198,7 @@ If you’re supervised:
 - macOS launchd (app-bundled LaunchAgent): `launchctl kickstart -k gui/$UID/ai.openclaw.gateway` (use `ai.openclaw.<profile>`; legacy `com.openclaw.*` still works)
 - Linux systemd user service: `systemctl --user restart openclaw-gateway[-<profile>].service`
 - Windows (WSL2): `systemctl --user restart openclaw-gateway[-<profile>].service`
-  - `launchctl`/`systemctl` only work if the service is installed; otherwise run `openclaw gateway install`.
+  - `launchctl`/`systemctl` only work if the service is installed; otherwise run `bitseek-claw gateway install`.
 
 Runbook + exact service labels: [Gateway runbook](/gateway)
 
@@ -210,20 +209,20 @@ Runbook + exact service labels: [Gateway runbook](/gateway)
 Install a known-good version (replace `<version>` with the last working one):
 
 ```bash
-npm i -g openclaw@<version>
+npm i -g @bitseek/claw@<version>
 ```
 
 ```bash
-pnpm add -g openclaw@<version>
+pnpm add -g @bitseek/claw@<version>
 ```
 
-Tip: to see the current published version, run `npm view openclaw version`.
+Tip: to see the current published version, run `npm view @bitseek/claw version`.
 
 Then restart + re-run doctor:
 
 ```bash
-openclaw doctor
-openclaw gateway restart
+bitseek-claw doctor
+bitseek-claw gateway restart
 ```
 
 ### Pin (source) by date

package/docs/plans/2026-03-11-bitseek-update-package-design.md

@@ -0,0 +1,25 @@
+# BitSeek Update Package Design
+
+## Context
+
+BitSeek Claw now publishes from the npm package `@bitseek/claw`, but the core
+update flow and top-level installation docs still point users to `openclaw`.
+That mismatch can make `bitseek-claw update` suggest or execute the wrong npm
+package spec.
+
+## Decisions
+
+- Make `@bitseek/claw` the default npm package target for package-manager
+  updates.
+- Preserve detection of legacy package roots such as `openclaw` so existing
+  installs can still be recognized safely.
+- Update CLI dry-run output and failure hints to show the BitSeek package spec.
+- Update the main English install and update docs to use `@bitseek/claw`.
+
+## Guardrails
+
+- Do not change the CLI binary name; it remains `bitseek-claw`.
+- Do not touch generated `docs/zh-CN/**`.
+- Do not modify the separate website installer repo in this change.
+- Keep old package-name detection in update helpers so legacy installs do not
+  become invisible to the updater.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitseek/claw",
-  "version": "1.1.0-beta.2",
+  "version": "1.2.1",
   "description": "BitSeek-branded OpenClaw distribution with a multi-channel AI gateway",
   "keywords": [],
   "homepage": "https://github.com/adv-org/bitseek-claw#readme",