@coclaw/openclaw-coclaw 0.11.5 → 0.12.0

package/README.md

@@ -98,7 +98,7 @@ openclaw coclaw enroll [--server <url>]
 {
   "default": {
     "serverUrl": "https://coclaw.net",
-    "botId": "bot-xxx",
+    "clawId": "claw-xxx",
     "token": "token-xxx",
     "boundAt": "2026-03-05T..."
   }

package/index.js

@@ -1,4 +1,4 @@
-import { bindBot, unbindBot, enrollBot, waitForClaimAndSave } from './src/common/bot-binding.js';
+import { bindClaw, unbindClaw, enrollClaw, waitForClaimAndSave } from './src/common/claw-binding.js';
 import { registerCoclawCli } from './src/cli-registrar.js';
 import { resolveErrorMessage } from './src/common/errors.js';
 import { notBound, bindOk, unbindOk, claimCodeCreated } from './src/common/messages.js';
@@ -116,7 +116,7 @@ const plugin = {
 			await stopRealtimeBridge();
 			let result;
 			try {
-				result = await bindBot({
+				result = await bindClaw({
 					code,
 					serverUrl: serverUrl ?? api.pluginConfig?.serverUrl,
 				});
@@ -133,7 +133,7 @@ const plugin = {
 		}
 
 		async function doUnbind({ serverUrl }) {
-			const result = await unbindBot({
+			const result = await unbindClaw({
 				serverUrl: serverUrl ?? api.pluginConfig?.serverUrl,
 			});
 			await stopRealtimeBridge();
@@ -153,9 +153,9 @@ const plugin = {
 				});
 				respond(true, {
 					status: {
-						botId: result.botId,
+						clawId: result.clawId,
 						rebound: result.rebound,
-						previousBotId: result.previousBotId,
+						previousClawId: result.previousClawId,
 					},
 				});
 			}
@@ -167,7 +167,7 @@ const plugin = {
 		api.registerGatewayMethod('coclaw.unbind', async ({ params, respond }) => {
 			try {
 				const result = await doUnbind({ serverUrl: params?.serverUrl });
-				respond(true, { status: { botId: result.botId } });
+				respond(true, { status: { clawId: result.clawId } });
 			}
 			catch (err) {
 				respondError(respond, err);
@@ -187,7 +187,7 @@ const plugin = {
 				activeEnrollAbort = abortController;
 
 				const serverUrl = params?.serverUrl ?? api.pluginConfig?.serverUrl;
-				const result = await enrollBot({ serverUrl });
+				const result = await enrollClaw({ serverUrl });
 
 				const rawMinutes = Math.round(
 					(new Date(result.expiresAt).getTime() - Date.now()) / 60_000,
@@ -552,7 +552,7 @@ const plugin = {
 						activeEnrollAbort = abortController;
 
 						const serverUrl = options.server ?? api.pluginConfig?.serverUrl;
-						const result = await enrollBot({ serverUrl });
+						const result = await enrollClaw({ serverUrl });
 						const rawMinutes = Math.round(
 							(new Date(result.expiresAt).getTime() - Date.now()) / 60_000,
 						);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coclaw/openclaw-coclaw",
-  "version": "0.11.5",
+  "version": "0.12.0",
   "type": "module",
   "license": "Apache-2.0",
   "description": "OpenClaw CoClaw channel plugin for remote chat",

package/src/api.js

@@ -31,7 +31,7 @@ const CLAIM_CODE_TIMEOUT = 15_000;
 const CLAIM_WAIT_TIMEOUT = 30_000;
 
 export async function bindWithServer({ baseUrl, code, name }) {
-	return requestJson(baseUrl, '/api/v1/bots/bind', {
+	return requestJson(baseUrl, '/api/v1/claws/bind', {
 		method: 'POST',
 		headers: { 'content-type': 'application/json' },
 		body: { code, name },
@@ -40,7 +40,7 @@ export async function bindWithServer({ baseUrl, code, name }) {
 }
 
 export async function unbindWithServer({ baseUrl, token, timeout = UNBIND_TIMEOUT }) {
-	return requestJson(baseUrl, '/api/v1/bots/unbind', {
+	return requestJson(baseUrl, '/api/v1/claws/unbind', {
 		method: 'POST',
 		headers: {
 			Authorization: `Bearer ${token}`,

package/src/common/{bot-binding.js → claw-binding.js}

@@ -8,14 +8,14 @@ function resolveServerUrl(serverUrl) {
 	return serverUrl ?? process.env.COCLAW_SERVER_URL ?? DEFAULT_SERVER_URL;
 }
 
-// 这些 HTTP 状态码表示 bot 在 server 端已不存在，视为解绑成功
+// 这些 HTTP 状态码表示 claw 在 server 端已不存在，视为解绑成功
 const ALREADY_UNBOUND_STATUSES = new Set([401, 404, 410]);
 
 function isAlreadyUnbound(err) {
 	return ALREADY_UNBOUND_STATUSES.has(err?.response?.status);
 }
 
-export async function bindBot({ code, serverUrl }, deps = {}) {
+export async function bindClaw({ code, serverUrl }, deps = {}) {
 	const {
 		readCfg = readConfig,
 		clearCfg = clearConfig,
@@ -30,10 +30,10 @@ export async function bindBot({ code, serverUrl }, deps = {}) {
 
 	const config = await readCfg();
 
-	// 已绑定时必须先解绑旧 bot，避免产生孤儿记录
-	let previousBotId;
+	// 已绑定时必须先解绑旧 claw，避免产生孤儿记录
+	let previousClawId;
 	if (config?.token) {
-		previousBotId = config.botId || 'unknown';
+		previousClawId = config.clawId || 'unknown';
 		const oldBaseUrl = config.serverUrl;
 		if (oldBaseUrl) {
 			try {
@@ -41,7 +41,7 @@ export async function bindBot({ code, serverUrl }, deps = {}) {
 			} catch (err) {
 				if (!isAlreadyUnbound(err)) {
 					const rebindErr = new Error(
-						`Failed to unbind previous bot (${previousBotId}): ${err.message}. ` +
+						`Failed to unbind previous claw (${previousClawId}): ${err.message}. ` +
 						'Unbind manually first, then retry.',
 					);
 					rebindErr.code = 'UNBIND_FAILED';
@@ -59,25 +59,25 @@ export async function bindBot({ code, serverUrl }, deps = {}) {
 		code,
 	});
 
-	if (!data?.botId || !data?.token) {
+	if (!data?.clawId || !data?.token) {
 		throw new Error('invalid bind response');
 	}
 
 	await writeCfg({
 		serverUrl: baseUrl,
-		botId: data.botId,
+		clawId: data.clawId,
 		token: data.token,
 		boundAt: new Date().toISOString(),
 	});
 
 	return {
-		botId: data.botId,
+		clawId: data.clawId,
 		rebound: Boolean(data.rebound),
-		previousBotId,
+		previousClawId,
 	};
 }
 
-export async function enrollBot({ serverUrl }, deps = {}) {
+export async function enrollClaw({ serverUrl }, deps = {}) {
 	const { createClaimCode = createClaimCodeOnServer, readCfg = readConfig } = deps;
 
 	const config = await readCfg();
@@ -129,14 +129,14 @@ export async function waitForClaimAndSave({ serverUrl, code, waitToken, signal }
 		}
 
 		// 已认领
-		if (data?.botId && data?.token) {
+		if (data?.clawId && data?.token) {
 			await writeCfg({
 				serverUrl: baseUrl,
-				botId: data.botId,
+				clawId: data.clawId,
 				token: data.token,
 				boundAt: new Date().toISOString(),
 			});
-			return { botId: data.botId };
+			return { clawId: data.clawId };
 		}
 
 		// PENDING — 延迟后继续轮询
@@ -150,7 +150,7 @@ export async function waitForClaimAndSave({ serverUrl, code, waitToken, signal }
 	}
 }
 
-export async function unbindBot({ serverUrl }, deps = {}) {
+export async function unbindClaw({ serverUrl }, deps = {}) {
 	const {
 		readCfg = readConfig,
 		clearCfg = clearConfig,
@@ -170,7 +170,7 @@ export async function unbindBot({ serverUrl }, deps = {}) {
 		try {
 			await unbindServer({ baseUrl, token: config.token });
 		} catch (err) {
-			// bot 在 server 已不存在 — 视为解绑成功，继续清理本地
+			// claw 在 server 已不存在 — 视为解绑成功，继续清理本地
 			if (!isAlreadyUnbound(err)) {
 				throw err;
 			}
@@ -179,5 +179,5 @@ export async function unbindBot({ serverUrl }, deps = {}) {
 
 	await clearCfg();
 
-	return { botId: config.botId };
+	return { clawId: config.clawId };
 }

package/src/common/errors.js

@@ -3,7 +3,7 @@ const ERROR_TEXT_MAP = {
 	BINDING_CODE_INVALID: 'Binding code is invalid',
 	BINDING_CODE_EXPIRED: 'Binding code has expired, please get a new one',
 	BINDING_CODE_EXHAUSTED: 'Server cannot generate binding code right now, please try again later',
-	BOT_BLOCKED: 'Claw is blocked, please contact the admin',
+	CLAW_BLOCKED: 'Claw is blocked, please contact the admin',
 	UNAUTHORIZED: 'Auth failed, please check token or re-bind',
 	INTERNAL_SERVER_ERROR: 'Server error, please try again later',
 };

package/src/common/messages.js

@@ -1,15 +1,15 @@
 // bind/unbind CLI 及 command 的用户提示文案（统一出口）
 
-export function bindOk({ botId, rebound, previousBotId }) {
+export function bindOk({ clawId, rebound, previousClawId }) {
 	const action = rebound ? 're-bound' : 'bound';
-	const prev = previousBotId
-		? ` (previous Claw ${previousBotId} was auto-unbound)`
+	const prev = previousClawId
+		? ` (previous Claw ${previousClawId} was auto-unbound)`
 		: '';
-	return `OK. Claw (${botId}) ${action} to CoClaw.${prev}`;
+	return `OK. Claw (${clawId}) ${action} to CoClaw.${prev}`;
 }
 
-export function unbindOk({ botId }) {
-	const id = botId ?? 'unknown';
+export function unbindOk({ clawId }) {
+	const id = clawId ?? 'unknown';
 	return `OK. Claw (${id}) unbound from CoClaw.`;
 }
 

package/src/config.js

@@ -58,7 +58,12 @@ const bindingsMutex = createMutex();
 export async function readConfig(accountId = DEFAULT_ACCOUNT_ID) {
 	const bindingsPath = getBindingsPath();
 	const bindings = await readJson(bindingsPath);
-	return toRecord(bindings[accountId]);
+	const record = toRecord(bindings[accountId]);
+	// 向后兼容：旧 bindings.json 使用 botId，映射到 clawId
+	if (record.botId && !record.clawId) {
+		record.clawId = record.botId;
+	}
+	return record;
 }
 
 export async function writeConfig(nextConfig, accountId = DEFAULT_ACCOUNT_ID) {
@@ -69,7 +74,7 @@ export async function writeConfig(nextConfig, accountId = DEFAULT_ACCOUNT_ID) {
 
 		const next = { ...current };
 		if (nextConfig.serverUrl !== undefined) next.serverUrl = nextConfig.serverUrl;
-		if (nextConfig.botId !== undefined) next.botId = nextConfig.botId;
+		if (nextConfig.clawId !== undefined) next.clawId = nextConfig.clawId;
 		if (nextConfig.token !== undefined) next.token = nextConfig.token;
 		if (nextConfig.boundAt !== undefined) next.boundAt = nextConfig.boundAt;
 

package/src/realtime-bridge.js

@@ -24,7 +24,7 @@ const SERVER_HB_MAX_MISS = 4; // 连续 4 次无响应才断连（~3 分钟）
 function toServerWsUrl(baseUrl, token) {
 	const url = new URL(baseUrl);
 	url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
-	url.pathname = '/api/v1/bots/stream';
+	url.pathname = '/api/v1/claws/stream';
 	url.searchParams.set('token', token);
 	return url.toString();
 }
@@ -176,13 +176,13 @@ export class RealtimeBridge {
 			?? DEFAULT_GATEWAY_WS_URL;
 	}
 
-	async __clearTokenLocal(unboundBotId) {
+	async __clearTokenLocal(unboundClawId) {
 		const cfg = await this.__readConfig();
 		if (!cfg?.token) {
 			return;
 		}
-		// 只清除匹配的 bot，避免新绑定被误清
-		if (unboundBotId && cfg.botId && cfg.botId !== unboundBotId) {
+		// 只清除匹配的 claw，避免新绑定被误清
+		if (unboundClawId && cfg.clawId && cfg.clawId !== unboundClawId) {
 			return;
 		}
 		await this.__clearConfig();
@@ -824,10 +824,10 @@ export class RealtimeBridge {
 			this.__resetServerHbTimeout(sock);
 			try {
 				const payload = JSON.parse(String(event.data ?? '{}'));
-				if (payload?.type === 'bot.unbound') {
-					remoteLog('ws.bot-unbound');
-					await this.__clearTokenLocal(payload.botId);
-					try { sock.close(4001, 'bot_unbound'); }
+				if (payload?.type === 'claw.unbound') {
+					remoteLog('ws.claw-unbound');
+					await this.__clearTokenLocal(payload.clawId);
+					try { sock.close(4001, 'claw_unbound'); }
 					/* c8 ignore next */
 					catch {}
 					return;
@@ -994,7 +994,7 @@ export class RealtimeBridge {
 		if (sock) {
 			this.intentionallyClosed = true;
 			this.serverWs = null;
-			// 等待 WebSocket 真正关闭，避免残留连接收到 bot.unbound 等消息
+			// 等待 WebSocket 真正关闭，避免残留连接收到 claw.unbound 等消息
 			/* c8 ignore next -- readyState === 3 时跳过 */
 			if (sock.readyState === 3) return;
 			await new Promise((resolve) => {

package/src/webrtc/ndc-preloader.js

@@ -110,7 +110,7 @@ export async function preloadNdc(deps = {}) {
 	const log = deps.remoteLog ?? defaultRemoteLog;
 	const platform = deps.platform ?? process.platform;
 	const arch = deps.arch ?? process.arch;
-	const pluginRoot = deps.pluginRoot ?? nodePath.resolve(import.meta.dirname, '..');
+	const pluginRoot = deps.pluginRoot ?? nodePath.resolve(import.meta.dirname, '../..');
 	const resolvePaths = deps.resolvePaths ?? defaultResolvePaths;
 	const importTimeout = deps.importTimeout ?? DEFAULT_IMPORT_TIMEOUT_MS;