@rowger_go/chatu 0.1.3

package/openclaw.plugin.json

@@ -0,0 +1,113 @@
+{
+  "id": "chatu",
+  "name": "Chatu",
+  "version": "0.1.0",
+  "description": "Connect OpenClaw to any Website via HTTP/WebSocket",
+  "kind": "channel",
+  "channels": [
+    "chatu"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable or disable the Chatu channel"
+      },
+      "apiUrl": {
+        "type": "string",
+        "description": "Default API base URL for Chatu service"
+      },
+      "channelId": {
+        "type": "string",
+        "description": "Channel ID from the Chatu service"
+      },
+      "secret": {
+        "type": "string",
+        "description": "Channel secret for registration (wh_secret_xxx)"
+      },
+      "accessToken": {
+        "type": "string",
+        "description": "Access token (auto-obtained via register, or set manually)"
+      },
+      "timeout": {
+        "type": "number",
+        "default": 30000,
+        "description": "Request timeout in milliseconds"
+      },
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "accountId": {
+              "type": "string",
+              "description": "Unique account identifier"
+            },
+            "apiUrl": {
+              "type": "string",
+              "description": "Account-specific API URL (overrides default)"
+            },
+            "channelId": {
+              "type": "string",
+              "description": "Account-specific Channel ID (overrides default)"
+            },
+            "secret": {
+              "type": "string",
+              "description": "Account-specific channel secret (overrides default)"
+            },
+            "accessToken": {
+              "type": "string",
+              "description": "Account-specific access token (overrides default)"
+            },
+            "timeout": {
+              "type": "number",
+              "description": "Account-specific request timeout in milliseconds"
+            }
+          },
+          "required": ["accountId"]
+        },
+        "description": "Multiple account configurations"
+      }
+    }
+  },
+  "uiHints": {
+    "enabled": {
+      "label": "Enabled",
+      "description": "Enable Chatu channel"
+    },
+    "apiUrl": {
+      "label": "API URL",
+      "placeholder": "https://your-webhub.example.com",
+      "description": "WebHub service base URL"
+    },
+    "channelId": {
+      "label": "Channel ID",
+      "placeholder": "wh_ch_xxxxxx",
+      "description": "Channel ID from the WebHub admin panel"
+    },
+    "secret": {
+      "label": "Channel Secret",
+      "sensitive": true,
+      "placeholder": "wh_secret_xxxxxxxxxx",
+      "description": "Channel secret for registration"
+    },
+    "accessToken": {
+      "label": "Access Token",
+      "sensitive": true,
+      "placeholder": "wh_xxxxxxxxxxxxxxxx",
+      "description": "Access token for API authentication"
+    },
+    "timeout": {
+      "label": "Timeout (ms)",
+      "placeholder": "30000",
+      "description": "Request timeout in milliseconds"
+    },
+    "accounts": {
+      "label": "Accounts",
+      "description": "Configure multiple Chatu accounts"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@rowger_go/chatu",
+  "version": "0.1.3",
+  "description": "OpenClaw Channel SDK - Build custom channel plugins",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "chatu",
+      "label": "Chatu",
+      "selectionLabel": "Chatu (HTTP/WebSocket)",
+      "docsPath": "/channels/chatu",
+      "docsLabel": "chatu",
+      "blurb": "Connect to any website via HTTP/WebSocket",
+      "order": 60,
+      "aliases": [
+        "chatu",
+        "http-channel"
+      ]
+    },
+    "install": {
+      "npmSpec": "@rowger_go/chatu",
+      "defaultChoice": "npm"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "prepare": "npm run build",
+    "test": "jest --no-coverage",
+    "release:patch": "npm version patch && git push --follow-tags",
+    "release:minor": "npm version minor && git push --follow-tags",
+    "release:major": "npm version major && git push --follow-tags"
+  },
+  "keywords": [
+    "openclaw",
+    "channel",
+    "sdk"
+  ],
+  "author": "OpenClaw Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chatu-ai/webhub.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chatu-ai/webhub/issues"
+  },
+  "homepage": "https://github.com/chatu-ai/webhub",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.32.0",
+    "@types/uuid": "^10.0.0",
+    "uuid": "^13.0.0",
+    "ws": "^8.14.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "jest": "^30.2.0",
+    "openclaw": "2026.2.19-2",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.3.0"
+  }
+}

package/run-poll.mjs

@@ -0,0 +1,209 @@
+/**
+ * Standalone poll loop for chatu channel.
+ * Runs when openclaw gateway doesn't auto-start the account.
+ *
+ * Usage: node run-poll.mjs
+ *        API_URL=http://localhost:3000 CHANNEL_ID=xxx ACCESS_TOKEN=yyy node run-poll.mjs
+ */
+import { readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+// --- Read config from ~/.openclaw/openclaw.json ---
+let cfg;
+try {
+  cfg = JSON.parse(readFileSync(join(homedir(), '.openclaw', 'openclaw.json'), 'utf8'));
+} catch {
+  cfg = {};
+}
+const chatuCfg = cfg?.channels?.chatu ?? {};
+
+const API_URL      = process.env.API_URL      || chatuCfg.apiUrl      || 'http://localhost:3000';
+const CHANNEL_ID   = process.env.CHANNEL_ID   || chatuCfg.channelId   || '';
+const ACCESS_TOKEN = process.env.ACCESS_TOKEN  || chatuCfg.accessToken || '';
+
+if (!CHANNEL_ID || !ACCESS_TOKEN) {
+  console.error('[poll] Missing CHANNEL_ID or ACCESS_TOKEN. Check ~/.openclaw/openclaw.json');
+  process.exit(1);
+}
+
+console.log(`[poll] Starting poll loop`);
+console.log(`[poll] API_URL    : ${API_URL}`);
+console.log(`[poll] CHANNEL_ID : ${CHANNEL_ID}`);
+
+// --- Load compiled plugin and dispatch via openclaw runtime API ---
+// We'll use a lightweight inline dispatcher instead of the full openclaw api:
+// Just forward messages to the gateway via the openclaw CLI `chat` command.
+
+const POLL_INTERVAL_MS = 2000;
+const MAX_BACKOFF_MS = 30_000;
+
+let lastCursor = '';
+let consecutiveErrors = 0;
+const MAX_ERRORS = 10;
+
+async function timedFetch(url, init, timeoutMs = 30000) {
+  const ctrl = new AbortController();
+  const id = setTimeout(() => ctrl.abort(), timeoutMs);
+  try {
+    return await fetch(url, { ...init, signal: ctrl.signal });
+  } finally {
+    clearTimeout(id);
+  }
+}
+
+async function ackMessage(msgId) {
+  try {
+    await timedFetch(
+      `${API_URL}/api/channel/messages/${msgId}/ack`,
+      {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Channel-Token': ACCESS_TOKEN },
+        body: JSON.stringify({ channelId: CHANNEL_ID }),
+      },
+      10000,
+    );
+  } catch (e) {
+    console.warn(`[poll] ack failed for ${msgId}: ${e.message}`);
+  }
+}
+
+async function dispatchToOpenClaw(msg) {
+  const content = msg.content || msg.text || '';
+  const sender = msg.senderName || msg.senderId || 'user';
+  if (!content) return;
+
+  console.log(`[poll] Dispatching to openclaw: "${content}" from ${sender}`);
+
+  // Use openclaw CLI to send the message and get AI reply
+  const { spawn } = await import('child_process');
+  return new Promise((resolve) => {
+    const proc = spawn('openclaw', [
+      'chat',
+      '--channel', 'chatu',
+      '--account', 'default',
+      '--message', content,
+      '--sender', CHANNEL_ID,
+      '--json',
+    ], { stdio: ['ignore', 'pipe', 'pipe'] });
+
+    let stdout = '';
+    let stderr = '';
+    proc.stdout.on('data', (d) => { stdout += d.toString(); });
+    proc.stderr.on('data', (d) => { stderr += d.toString(); });
+    proc.on('close', async (code) => {
+      if (code !== 0) {
+        console.error(`[poll] openclaw chat failed (code=${code}): ${stderr.slice(0, 200)}`);
+        resolve();
+        return;
+      }
+
+      // Parse JSON replies and deliver back to service
+      try {
+        const lines = stdout.trim().split('\n').filter(Boolean);
+        for (const line of lines) {
+          try {
+            const parsed = JSON.parse(line);
+            const reply = parsed?.reply || parsed?.text || parsed?.content || (typeof parsed === 'string' ? parsed : null);
+            if (reply) {
+              await deliverReply(reply, msg);
+            }
+          } catch { /* skip non-json lines */ }
+        }
+        // If no JSON, treat whole stdout as reply
+        if (stdout.trim() && !lines.some(l => { try { JSON.parse(l); return true; } catch { return false; } })) {
+          await deliverReply(stdout.trim(), msg);
+        }
+      } catch (e) {
+        console.error(`[poll] failed to parse reply: ${e.message}`);
+      }
+      resolve();
+    });
+  });
+}
+
+async function deliverReply(text, originalMsg) {
+  console.log(`[poll] Delivering reply: "${text.slice(0, 80)}..."`);
+  try {
+    const resp = await timedFetch(
+      `${API_URL}/api/channel/messages`,
+      {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Channel-Token': ACCESS_TOKEN },
+        body: JSON.stringify({
+          channelId: CHANNEL_ID,
+          content: text,
+          direction: 'inbound',
+          senderId: 'ai',
+          targetId: originalMsg.senderId || 'user',
+          metadata: {},
+        }),
+      },
+      30000,
+    );
+    if (resp.ok) {
+      console.log('[poll] Reply delivered OK');
+    } else {
+      const body = await resp.text();
+      console.error(`[poll] Reply delivery failed: ${resp.status} ${body.slice(0, 100)}`);
+    }
+  } catch (e) {
+    console.error(`[poll] Reply delivery error: ${e.message}`);
+  }
+}
+
+// Main poll loop
+async function pollLoop() {
+  console.log('[poll] Poll loop started');
+  while (true) {
+    const backoffMs = Math.min(POLL_INTERVAL_MS * Math.pow(2, consecutiveErrors), MAX_BACKOFF_MS);
+    await new Promise(r => setTimeout(r, backoffMs));
+
+    try {
+      const url =
+        `${API_URL}/api/channel/messages/pending` +
+        `?channelId=${encodeURIComponent(CHANNEL_ID)}` +
+        `&after=${encodeURIComponent(lastCursor)}`;
+
+      const resp = await timedFetch(url, {
+        method: 'GET',
+        headers: {
+          'X-Channel-Token': ACCESS_TOKEN,
+          'X-Channel-ID': 'default',
+        },
+      }, 15000);
+
+      if (!resp.ok) {
+        consecutiveErrors++;
+        console.warn(`[poll] HTTP ${resp.status} (errors=${consecutiveErrors})`);
+        continue;
+      }
+
+      consecutiveErrors = 0;
+      const data = await resp.json();
+      const messages = data?.data ?? [];
+
+      for (const msg of messages) {
+        lastCursor = msg.id ?? lastCursor;
+        await ackMessage(msg.id);
+
+        // Typing indicator
+        timedFetch(`${API_URL}/api/channel/typing`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'X-Channel-Token': ACCESS_TOKEN },
+          body: JSON.stringify({ channelId: CHANNEL_ID }),
+        }, 3000).catch(() => {});
+
+        await dispatchToOpenClaw(msg);
+      }
+    } catch (err) {
+      consecutiveErrors++;
+      console.warn(`[poll] Error (errors=${consecutiveErrors}): ${err.message}`);
+    }
+  }
+}
+
+pollLoop().catch(err => {
+  console.error('[poll] Fatal:', err);
+  process.exit(1);
+});

package/scripts/reload-plugin.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# ============================================================
+# reload-plugin.sh — Build & reload the openclaw-web-hub-channel plugin
+#
+# Usage:
+#   ./scripts/reload-plugin.sh [--no-build]
+#
+# What it does:
+#   1. Builds the plugin (unless --no-build is passed)
+#   2. Prints the new plugin version
+#   3. Guides you through clearing the cached accessToken so
+#      openclaw picks up the new build on next start
+# ============================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(dirname "$SCRIPT_DIR")"
+
+NO_BUILD=false
+for arg in "$@"; do
+  [[ "$arg" == "--no-build" ]] && NO_BUILD=true
+done
+
+echo ""
+echo "=== openclaw-web-hub-channel plugin reload ==="
+echo ""
+
+# ── Step 1: Build ────────────────────────────────────────────
+if [[ "$NO_BUILD" == "false" ]]; then
+  echo "▶  Building plugin..."
+  cd "$PLUGIN_ROOT"
+  npm run build
+  echo "✓  Build complete."
+else
+  echo "⚠  Skipping build (--no-build flag set)."
+fi
+
+# ── Step 2: Print version ────────────────────────────────────
+PLUGIN_VERSION=$(node -e "console.log(require('$PLUGIN_ROOT/package.json').version)")
+echo ""
+echo "✓  Plugin version: $PLUGIN_VERSION"
+
+# ── Step 3: Version detection via service API ─────────────────
+WEBHUB_URL="${WEBHUB_URL:-http://localhost:3000}"
+echo ""
+echo "▶  Checking service version endpoint..."
+if curl -sf "$WEBHUB_URL/api/channel/version" | grep -q "serviceVersion"; then
+  echo "✓  Service version response:"
+  curl -s "$WEBHUB_URL/api/channel/version" | python3 -m json.tool 2>/dev/null \
+    || curl -s "$WEBHUB_URL/api/channel/version"
+else
+  echo "⚠  Service at $WEBHUB_URL is not reachable or version endpoint unavailable."
+  echo "   Set WEBHUB_URL env var if the service runs on a different address."
+fi
+
+# ── Step 4: Reload instructions ──────────────────────────────
+echo ""
+echo "=== Manual reload steps ==="
+echo ""
+echo "To activate the new plugin version in openclaw:"
+echo ""
+echo "  Option A — full restart (recommended):"
+echo "    1. Stop openclaw"
+echo "    2. Run this script (already done if you're reading this)"
+echo "    3. Start openclaw"
+echo ""
+echo "  Option B — clear cached accessToken so plugin re-registers:"
+echo "    1. In openclaw config, remove the 'accessToken' field under"
+echo "       channels.chatu (or channels.chatu.accounts.<id>)"
+echo "    2. Keep 'channelId' and 'secret' in place"
+echo "    3. Restart openclaw — the plugin will exchange the secret for"
+echo "       a fresh token and report its new version on /api/channel/version"
+echo ""
+echo "  After restart, verify version via:"
+echo "    curl $WEBHUB_URL/api/channel/version"
+echo ""
+echo "=== Done ==="