@eclaw/openclaw-channel 1.0.13 → 1.0.15

package/dist/client.d.ts

@@ -12,13 +12,15 @@ export declare class EClawClient {
     constructor(config: EClawAccountConfig);
     /** Register callback URL with E-Claw backend */
     registerCallback(callbackUrl: string, callbackToken: string): Promise<RegisterResponse>;
-    /** Bind an entity via channel API (bypasses 6-digit code) */
-    bindEntity(entityId: number, name?: string): Promise<BindResponse>;
+    /** Bind an entity via channel API (bypasses 6-digit code).
+     *  If entityId is omitted, the backend auto-selects the first free slot.
+     */
+    bindEntity(entityId?: number, name?: string): Promise<BindResponse>;
     /** Send bot message to user */
     sendMessage(message: string, state?: string, mediaType?: string, mediaUrl?: string): Promise<MessageResponse>;
     /** Unregister callback on shutdown */
     unregisterCallback(): Promise<void>;
     get currentDeviceId(): string | null;
     get currentBotSecret(): string | null;
-    get currentEntityId(): number;
+    get currentEntityId(): number | undefined;
 }

package/dist/client.js

@@ -11,7 +11,7 @@ export class EClawClient {
     constructor(config) {
         this.apiBase = config.apiBase;
         this.apiKey = config.apiKey;
-        this.entityId = config.entityId;
+        this.entityId = config.entityId; // undefined until assigned by bindEntity
     }
     /** Register callback URL with E-Claw backend */
     async registerCallback(callbackUrl, callbackToken) {
@@ -31,24 +31,37 @@ export class EClawClient {
         this.deviceId = data.deviceId;
         return data;
     }
-    /** Bind an entity via channel API (bypasses 6-digit code) */
+    /** Bind an entity via channel API (bypasses 6-digit code).
+     *  If entityId is omitted, the backend auto-selects the first free slot.
+     */
     async bindEntity(entityId, name) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const body = { channel_api_key: this.apiKey };
+        if (entityId !== undefined)
+            body.entityId = entityId;
+        if (name)
+            body.name = name;
         const res = await fetch(`${this.apiBase}/api/channel/bind`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                channel_api_key: this.apiKey,
-                entityId,
-                name: name || undefined,
-            }),
+            body: JSON.stringify(body),
         });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const data = await res.json();
         if (!data.success) {
+            // Build a detailed error message when all slots are full
+            if (res.status === 409 && data.entities) {
+                const list = data.entities
+                    .map((e) => `  slot ${e.entityId} (${e.character})${e.name ? ` "${e.name}"` : ''}`)
+                    .join('\n');
+                throw new Error(`${data.message}\nCurrent entities:\n${list}\n` +
+                    'Add entityId to your channel config to target a specific slot after unbinding it.');
+            }
             throw new Error(data.message || `Bind failed (HTTP ${res.status})`);
         }
         this.botSecret = data.botSecret;
         this.deviceId = data.deviceId;
-        this.entityId = entityId;
+        this.entityId = data.entityId; // Use server-assigned slot
         return data;
     }
     /** Send bot message to user */

package/dist/config.js

@@ -28,7 +28,7 @@ export function resolveAccount(cfg, accountId) {
         apiKey: account?.apiKey ?? '',
         apiSecret: account?.apiSecret,
         apiBase: (account?.apiBase ?? 'https://eclawbot.com').replace(/\/$/, ''),
-        entityId: account?.entityId ?? 0,
+        entityId: account?.entityId, // undefined = auto-assign
         botName: account?.botName,
         webhookUrl: account?.webhookUrl,
     };

package/dist/gateway.js

@@ -80,16 +80,17 @@ export async function startAccount(ctx) {
         // Register callback with E-Claw backend
         const regData = await client.registerCallback(callbackUrl, callbackToken);
         console.log(`[E-Claw] Registered with E-Claw. Device: ${regData.deviceId}, Entities: ${regData.entities.length}`);
-        // Auto-bind entity if not already bound
-        const entity = regData.entities.find(e => e.entityId === account.entityId);
-        if (!entity?.isBound) {
-            console.log(`[E-Claw] Entity ${account.entityId} not bound, binding...`);
-            const bindData = await client.bindEntity(account.entityId, account.botName);
-            console.log(`[E-Claw] Bound entity ${account.entityId}, publicCode: ${bindData.publicCode}`);
-        }
-        else {
-            console.log(`[E-Claw] Entity ${account.entityId} already bound, skipping bind`);
-        }
+        // Bind entity via channel API.
+        // /api/channel/bind is idempotent for the same channel account:
+        //   - Not bound → binds fresh, returns new botSecret
+        //   - Already bound via this channel account → returns existing botSecret
+        //   - Bound via different method → throws error (user must unbind first)
+        const entityInfo = regData.entities.find(e => e.entityId === account.entityId);
+        const alreadyBound = entityInfo?.isBound ?? false;
+        const bindData = await client.bindEntity(account.entityId, account.botName);
+        console.log(alreadyBound
+            ? `[E-Claw] Entity ${account.entityId} reconnected (existing channel binding), publicCode: ${bindData.publicCode}`
+            : `[E-Claw] Entity ${account.entityId} bound, publicCode: ${bindData.publicCode}`);
         console.log(`[E-Claw] Account ${accountId} ready!`);
     }
     catch (err) {

package/dist/types.d.ts

@@ -4,7 +4,7 @@ export interface EClawAccountConfig {
     apiKey: string;
     apiSecret?: string;
     apiBase: string;
-    entityId: number;
+    entityId?: number;
     botName?: string;
     webhookUrl?: string;
 }
@@ -50,6 +50,13 @@ export interface BindResponse {
     publicCode: string;
     bindingType: string;
 }
+/** Error response when all entity slots are full */
+export interface SlotsFullError {
+    success: false;
+    message: string;
+    entities: EClawEntityInfo[];
+    hint: string;
+}
 /** Response from POST /api/channel/message */
 export interface MessageResponse {
     success: boolean;

package/openclaw.plugin.json

@@ -16,7 +16,7 @@
             "apiKey": { "type": "string", "description": "Channel API Key (eck_...)" },
             "apiSecret": { "type": "string", "description": "Channel API Secret (ecs_...)" },
             "apiBase": { "type": "string", "default": "https://eclawbot.com" },
-            "entityId": { "type": "number", "default": 0, "minimum": 0, "maximum": 7 },
+            "entityId": { "type": "number", "minimum": 0, "maximum": 7, "description": "Optional: entity slot to use (0-7). If omitted, auto-assigned to first free slot." },
             "botName": { "type": "string", "maxLength": 20 }
           },
           "required": ["apiKey", "apiSecret"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eclaw/openclaw-channel",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "E-Claw channel plugin for OpenClaw — AI chat platform for live wallpaper entities",
   "type": "module",
   "main": "./dist/index.js",