@eclaw/openclaw-channel 1.1.2 → 1.1.4

package/README.md

@@ -6,6 +6,16 @@ This plugin enables OpenClaw bots to communicate with E-Claw users as a native c
 
 ## Installation
 
+**In OpenClaw terminal (Zeabur / Railway SSH):**
+
+```bash
+openclaw plugins install @eclaw/openclaw-channel
+```
+
+> ⚠️ Do **not** use `npm install` directly — OpenClaw uses pnpm internally, and mixing package managers will cause a crash (`Cannot read properties of null`).
+
+**In a standalone Node.js project:**
+
 ```bash
 npm install @eclaw/openclaw-channel
 ```
@@ -207,8 +217,11 @@ fs.writeFileSync(p, JSON.stringify(cfg, null, 2));
 // 3. Remove old plugin files
 execSync('rm -rf /home/node/.openclaw/extensions/openclaw-channel');
 
-// 4. Install new version (update version number below)
-var out = execSync('openclaw plugins install @eclaw/openclaw-channel@1.0.18 2>&1', { encoding: 'utf8' });
+// 4. Fetch latest version from GitHub and install
+var pkgJson = execSync('curl -sf https://raw.githubusercontent.com/HankHuang0516/openclaw-channel-eclaw/main/package.json', { encoding: 'utf8' });
+var latestVersion = JSON.parse(pkgJson).version;
+console.log('Installing @eclaw/openclaw-channel@' + latestVersion + ' ...');
+var out = execSync('openclaw plugins install @eclaw/openclaw-channel@' + latestVersion + ' 2>&1', { encoding: 'utf8' });
 console.log(out);
 
 // 5. Restore channel config
@@ -239,6 +252,28 @@ In-process restart validates the config before loading plugins, so `channels.ecl
 3. In E-Claw Portal, confirm the entity shows as channel-bound (green dot)
 4. Check server logs: `curl "https://eclawbot.com/api/logs?deviceId=...&deviceSecret=...&limit=20"`
 
+## Major Fix History
+
+A record of critical bug fixes, when they occurred, the problem, and the countermeasure.
+
+---
+
+### 2026-03-08 — v1.1.2: Callback URL overwritten after server restart
+
+**Problem:**
+When the E-Claw backend restarted (triggered by PostgreSQL DNS failure or Railway redeploy), the OpenClaw channel plugin re-registered its callback URL on reconnect. If `ECLAW_WEBHOOK_URL` or `account.webhookUrl` was misconfigured (e.g. `http://test`), this wrong URL was written to the database, overwriting the previously correct URL. The bot then stopped receiving messages silently — no error, no alert.
+
+**Root cause:**
+- `POST /api/channel/register` in the backend had no URL validation (no format check, no localhost rejection, no placeholder detection, no handshake test)
+- The plugin re-registers unconditionally on every startup with whatever URL it has configured
+
+**Countermeasure:**
+- Validate `ECLAW_WEBHOOK_URL` / `webhookUrl` before starting: ensure it is a reachable HTTPS URL (not `localhost`, not `http://test`, not empty)
+- If URL is invalid, log a clear error and refuse to register rather than writing a broken URL to the database
+- Users should verify `ECLAW_WEBHOOK_URL` is set to their OpenClaw's public URL in Zeabur environment variables
+
+---
+
 ## License
 
 MIT

package/dist/onboarding.js

@@ -33,15 +33,6 @@ export const eclawOnboardingAdapter = {
             initialValue: resolved.apiKey || '',
             validate: (v) => (String(v ?? '').trim() ? undefined : 'Required'),
         });
-        const entityIdStr = await prompter.text({
-            message: 'Entity ID (0–3)',
-            placeholder: '0',
-            initialValue: String(resolved.entityId ?? 0),
-            validate: (v) => {
-                const n = Number(v);
-                return Number.isInteger(n) && n >= 0 && n <= 3 ? undefined : 'Must be 0–3';
-            },
-        });
         const botName = await prompter.text({
             message: 'Bot display name (optional)',
             placeholder: 'My Bot',
@@ -63,7 +54,7 @@ export const eclawOnboardingAdapter = {
                         [accountId]: {
                             apiKey: String(apiKey).trim(),
                             apiBase: resolved.apiBase || 'https://eclawbot.com',
-                            entityId: Number(entityIdStr),
+                            entityId: resolved.entityId, // keep existing if re-configuring, else undefined = auto-assign
                             botName: String(botName).trim() || undefined,
                             webhookUrl: String(webhookUrl).trim() || undefined,
                             enabled: true,

package/package.json

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