@leoqlin/openclaw-qqbot 1.6.7-alpha1

package/node_modules/ws/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "ws",
+  "version": "8.20.0",
+  "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
+  "keywords": [
+    "HyBi",
+    "Push",
+    "RFC-6455",
+    "WebSocket",
+    "WebSockets",
+    "real-time"
+  ],
+  "homepage": "https://github.com/websockets/ws",
+  "bugs": "https://github.com/websockets/ws/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/websockets/ws.git"
+  },
+  "author": "Einar Otto Stangvik <einaros@gmail.com> (http://2x.io)",
+  "license": "MIT",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "browser": "./browser.js",
+      "import": "./wrapper.mjs",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "browser": "browser.js",
+  "engines": {
+    "node": ">=10.0.0"
+  },
+  "files": [
+    "browser.js",
+    "index.js",
+    "lib/*.js",
+    "wrapper.mjs"
+  ],
+  "scripts": {
+    "test": "nyc --reporter=lcov --reporter=text mocha --throw-deprecation test/*.test.js",
+    "integration": "mocha --throw-deprecation test/*.integration.js",
+    "lint": "eslint . && prettier --check --ignore-path .gitignore \"**/*.{json,md,yaml,yml}\""
+  },
+  "peerDependencies": {
+    "bufferutil": "^4.0.1",
+    "utf-8-validate": ">=5.0.2"
+  },
+  "peerDependenciesMeta": {
+    "bufferutil": {
+      "optional": true
+    },
+    "utf-8-validate": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "benchmark": "^2.1.4",
+    "bufferutil": "^4.0.1",
+    "eslint": "^10.0.1",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.0.0",
+    "globals": "^17.0.0",
+    "mocha": "^8.4.0",
+    "nyc": "^15.0.0",
+    "prettier": "^3.0.0",
+    "utf-8-validate": "^6.0.0"
+  }
+}

package/node_modules/ws/wrapper.mjs

@@ -0,0 +1,21 @@
+import createWebSocketStream from './lib/stream.js';
+import extension from './lib/extension.js';
+import PerMessageDeflate from './lib/permessage-deflate.js';
+import Receiver from './lib/receiver.js';
+import Sender from './lib/sender.js';
+import subprotocol from './lib/subprotocol.js';
+import WebSocket from './lib/websocket.js';
+import WebSocketServer from './lib/websocket-server.js';
+
+export {
+  createWebSocketStream,
+  extension,
+  PerMessageDeflate,
+  Receiver,
+  Sender,
+  subprotocol,
+  WebSocket,
+  WebSocketServer
+};
+
+export default WebSocket;

package/openclaw.plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "openclaw-qqbot",
+  "name": "OpenClaw QQ Bot",
+  "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
+  "channels": ["qqbot"],
+  "extensions": ["./preload.cjs"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media"],
+  "capabilities": {
+    "proactiveMessaging": true,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@leoqlin/openclaw-qqbot",
+  "version": "1.6.7-alpha1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openclaw-qqbot": "./bin/qqbot-cli.js",
+    "qqbot": "./bin/qqbot-cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src",
+    "skills",
+    "scripts",
+    "index.ts",
+    "preload.cjs",
+    "tsconfig.json",
+    "openclaw.plugin.json"
+  ],
+  "openclaw": {
+    "id": "openclaw-qqbot",
+    "extensions": [
+      "./preload.cjs"
+    ],
+    "channel": {
+      "id": "qqbot",
+      "label": "QQ Bot"
+    }
+  },
+  "scripts": {
+    "build": "tsc || true",
+    "postbuild": "node -e \"const fs=require('fs'),p=require('path'),ext=p.join(require('os').homedir(),'.openclaw/extensions/openclaw-qqbot');if(fs.existsSync(ext)&&!fs.lstatSync(ext).isSymbolicLink()){const d=p.join(ext,'dist'),pr=p.join(ext,'preload.cjs');fs.cpSync('dist',d,{recursive:true});fs.copyFileSync('preload.cjs',pr);console.log('[postbuild] synced to',ext)}\"",
+    "dev": "tsc --watch",
+    "prepack": "npm install --omit=dev",
+    "postinstall": ""
+  },
+  "dependencies": {
+    "mpg123-decoder": "^1.0.3",
+    "silk-wasm": "^3.7.1",
+    "ws": "^8.18.0"
+  },
+  "bundledDependencies": [
+    "mpg123-decoder",
+    "silk-wasm",
+    "ws"
+  ],
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "homepage": "https://github.com/tencent-connect/openclaw-qqbot",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tencent-connect/openclaw-qqbot.git"
+  },
+  "bundleDependencies": [
+    "mpg123-decoder",
+    "silk-wasm",
+    "ws"
+  ]
+}

package/preload.cjs

@@ -0,0 +1,33 @@
+/**
+ * 插件预加载入口（CJS 格式）。
+ *
+ * openclaw 框架通过 require() 加载插件，因此需要 .cjs 后缀
+ * 确保在 "type": "module" 的 package 中也能被正确 require()。
+ *
+ * 在 require 真正的插件代码（依赖 openclaw/plugin-sdk）之前，
+ * 先同步确保 node_modules/openclaw symlink 存在。
+ */
+"use strict";
+
+const { ensurePluginSdkSymlink } = require("./scripts/link-sdk-core.cjs");
+
+// 1) 同步创建 symlink
+ensurePluginSdkSymlink(__dirname, "[preload]");
+
+// 2) Node 22 原生支持 CJS require() 加载 ESM 模块
+//    同步加载插件入口，确保框架同步检查 register/activate 时能找到
+const _pluginModule = require("./dist/index.js");
+
+// 3) 展平 default export：框架检查 register/activate 在顶级属性
+//    ESM 的 export default 在 require() 后变成 { default: plugin, ... }
+const _default = _pluginModule.default;
+const merged = Object.assign({}, _pluginModule);
+if (_default && typeof _default === "object") {
+  for (const key of Object.keys(_default)) {
+    if (!(key in merged)) {
+      merged[key] = _default[key];
+    }
+  }
+}
+
+module.exports = merged;

package/scripts/cleanup-legacy-plugins.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# qqbot 插件升级脚本
+# 用于清理旧版本插件并重新安装
+# 兼容 clawdbot 和 openclaw 两种安装
+
+set -e
+
+echo "=== qqbot 插件升级脚本 ==="
+
+# 检测使用的是 clawdbot 还是 openclaw
+detect_installation() {
+  if [ -d "$HOME/.clawdbot" ]; then
+    echo "clawdbot"
+  elif [ -d "$HOME/.openclaw" ]; then
+    echo "openclaw"
+  else
+    echo ""
+  fi
+}
+
+# 可能的扩展目录名（原仓库 qqbot + 本仓库框架推断名 openclaw-qq）
+EXTENSION_DIRS=("qqbot" "openclaw-qq" "openclaw-qqbot")
+
+# 清理指定目录的函数
+cleanup_installation() {
+  local APP_NAME="$1"
+  local APP_DIR="$HOME/.$APP_NAME"
+  local CONFIG_FILE="$APP_DIR/$APP_NAME.json"
+
+  echo ""
+  echo ">>> 处理 $APP_NAME 安装..."
+
+  # 1. 删除所有可能的旧扩展目录
+  for dir_name in "${EXTENSION_DIRS[@]}"; do
+    local ext_dir="$APP_DIR/extensions/$dir_name"
+    if [ -d "$ext_dir" ]; then
+      echo "删除旧版本插件: $ext_dir"
+      rm -rf "$ext_dir"
+    fi
+  done
+
+  # 2. 清理配置文件中所有可能的插件 ID 相关字段
+  if [ -f "$CONFIG_FILE" ]; then
+    echo "清理配置文件中的插件字段..."
+    
+    # 使用 node 处理 JSON（比 jq 更可靠处理复杂结构）
+    node -e "
+      const fs = require('fs');
+      const config = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+      const ids = ['qqbot', 'openclaw-qq', '@sliverp/qqbot', '@tencent-connect/qqbot', '@tencent-connect/openclaw-qq', '@tencent-connect/openclaw-qqbot', 'openclaw-qqbot'];
+      
+      for (const id of ids) {
+        // 注意: 不删除 channels.<id>，因为里面保存了用户的 appid/secret 凭证
+        // 凭证与插件版本无关，清理插件时不应清除凭证
+
+        // 删除 plugins.entries.<id>
+        if (config.plugins && config.plugins.entries && config.plugins.entries[id]) {
+          delete config.plugins.entries[id];
+          console.log('  - 已删除 plugins.entries.' + id);
+        }
+        
+        // 删除 plugins.installs.<id>
+        if (config.plugins && config.plugins.installs && config.plugins.installs[id]) {
+          delete config.plugins.installs[id];
+          console.log('  - 已删除 plugins.installs.' + id);
+        }
+
+        // 删除 plugins.allow 中的 <id>
+        if (config.plugins && Array.isArray(config.plugins.allow)) {
+          const before = config.plugins.allow.length;
+          config.plugins.allow = config.plugins.allow.filter((x) => x !== id);
+          if (config.plugins.allow.length !== before) {
+            console.log('  - 已删除 plugins.allow 项: ' + id);
+          }
+        }
+      }
+      
+      fs.writeFileSync('$CONFIG_FILE', JSON.stringify(config, null, 2));
+      console.log('配置文件已更新');
+    "
+  else
+    echo "未找到配置文件: $CONFIG_FILE"
+  fi
+}
+
+# 检测并处理所有可能的安装
+FOUND_INSTALLATION=""
+
+# 检查 clawdbot
+if [ -d "$HOME/.clawdbot" ]; then
+  cleanup_installation "clawdbot"
+  FOUND_INSTALLATION="clawdbot"
+fi
+
+# 检查 openclaw
+if [ -d "$HOME/.openclaw" ]; then
+  cleanup_installation "openclaw"
+  FOUND_INSTALLATION="openclaw"
+fi
+
+# 检查 moltbot
+if [ -d "$HOME/.moltbot" ]; then
+  cleanup_installation "moltbot"
+  FOUND_INSTALLATION="moltbot"
+fi
+
+# 如果都没找到
+if [ -z "$FOUND_INSTALLATION" ]; then
+  echo "未找到 clawdbot / openclaw / moltbot 安装目录"
+  echo "请确认已安装其中之一"
+  exit 1
+fi
+
+# 使用检测到的安装类型作为命令
+CMD="$FOUND_INSTALLATION"
+
+echo ""
+echo "=== 清理完成 ==="
+echo ""
+echo "接下来将执行以下命令重新安装插件:"
+echo "  cd /path/to/openclaw-qqbot"
+echo "  $CMD plugins install ."
+echo "  $CMD channels add --channel qqbot --token \"appid:appsecret\""
+echo "  $CMD gateway restart"

package/scripts/link-sdk-core.cjs

@@ -0,0 +1,185 @@
+/**
+ * 公共模块：openclaw plugin-sdk symlink 创建逻辑。
+ *
+ * 被 preload.cjs 和 postinstall-link-sdk.js 共同使用，避免代码重复。
+ * 必须是 CJS 格式，因为 preload.cjs 需要同步 require()。
+ */
+"use strict";
+
+const path = require("node:path");
+const fs = require("node:fs");
+const { execSync } = require("node:child_process");
+
+const CLI_NAMES = ["openclaw", "clawdbot", "moltbot"];
+
+/**
+ * 比较版本号是否 >= target
+ * Strip pre-release suffix (e.g. "2026.3.23-2" → "2026.3.23")
+ */
+function compareVersionGte(version, target) {
+  const parts = version.replace(/-.*$/, "").split(".").map(Number);
+  for (let i = 0; i < target.length; i++) {
+    const v = parts[i] || 0;
+    const t = target[i];
+    if (v > t) return true;
+    if (v < t) return false;
+  }
+  return true;
+}
+
+/**
+ * 检查 openclaw 版本是否 >= 2026.3.22（需要 symlink 的最低版本）。
+ * 如果无法检测版本，返回 true（保守策略：宁可多创建也不遗漏）。
+ */
+function isOpenclawVersionRequiresSymlink() {
+  const REQUIRED = [2026, 3, 22];
+
+  // Strategy 1: 从全局 openclaw 的 package.json 读取版本
+  try {
+    const globalRoot = execSync("npm root -g", { encoding: "utf-8", timeout: 5000 }).trim();
+    for (const name of CLI_NAMES) {
+      const pkgPath = path.join(globalRoot, name, "package.json");
+      if (fs.existsSync(pkgPath)) {
+        const v = JSON.parse(fs.readFileSync(pkgPath, "utf-8")).version;
+        if (v) return compareVersionGte(v, REQUIRED);
+      }
+    }
+  } catch {}
+
+  // Strategy 2: 从 CLI 命令获取版本
+  for (const name of CLI_NAMES) {
+    try {
+      const out = execSync(`${name} --version`, {
+        encoding: "utf-8",
+        timeout: 5000,
+        stdio: ["pipe", "pipe", "pipe"],
+      }).trim();
+      const m = out.match(/(\d+\.\d+\.\d+)/);
+      if (m) return compareVersionGte(m[1], REQUIRED);
+    } catch {}
+  }
+
+  return true;
+}
+
+/**
+ * 查找全局 openclaw 安装路径。
+ * 三种策略依次尝试：npm root -g、which <cli>、从 extensions 目录推断。
+ */
+function findOpenclawRoot(pluginRoot) {
+  // Strategy 1: npm root -g
+  try {
+    const globalRoot = execSync("npm root -g", { encoding: "utf-8", timeout: 5000 }).trim();
+    for (const name of CLI_NAMES) {
+      const candidate = path.join(globalRoot, name);
+      if (fs.existsSync(path.join(candidate, "package.json"))) return candidate;
+    }
+  } catch {}
+
+  // Strategy 2: which <cli>
+  const whichCmd = process.platform === "win32" ? "where" : "which";
+  for (const name of CLI_NAMES) {
+    try {
+      const bin = execSync(`${whichCmd} ${name}`, {
+        encoding: "utf-8",
+        timeout: 5000,
+        stdio: ["pipe", "pipe", "pipe"],
+      }).trim().split("\n")[0];
+      if (!bin) continue;
+      const realBin = fs.realpathSync(bin);
+      const c1 = path.resolve(path.dirname(realBin), "..", "lib", "node_modules", name);
+      if (fs.existsSync(path.join(c1, "package.json"))) return c1;
+      const c2 = path.resolve(path.dirname(realBin), "..");
+      if (fs.existsSync(path.join(c2, "package.json")) && fs.existsSync(path.join(c2, "plugin-sdk"))) return c2;
+    } catch {}
+  }
+
+  // Strategy 3: 从 extensions 目录推断
+  const extensionsDir = path.dirname(pluginRoot);
+  const dataDir = path.dirname(extensionsDir);
+  const dataDirName = path.basename(dataDir);
+  const cliName = dataDirName.replace(/^\./, "");
+  if (cliName) {
+    try {
+      const globalRoot = execSync("npm root -g", { encoding: "utf-8", timeout: 5000 }).trim();
+      const candidate = path.join(globalRoot, cliName);
+      if (fs.existsSync(path.join(candidate, "package.json"))) return candidate;
+    } catch {}
+  }
+
+  return null;
+}
+
+/**
+ * 验证现有 node_modules/openclaw 是否完整可用。
+ *
+ * openclaw plugins install 可能安装了不完整的 peerDep 副本
+ * （只有 dist/plugin-sdk/index.js，缺少 core.js 等子模块），覆盖了之前的 symlink。
+ *
+ * 判断标准：
+ * - symlink → 只需确认 dist/plugin-sdk 目录存在（target 有完整文件树）
+ * - 真实目录 → 必须检查 dist/plugin-sdk/core.js 是否存在
+ */
+function isLinkValid(linkTarget) {
+  try {
+    const stat = fs.lstatSync(linkTarget);
+    if (stat.isSymbolicLink()) {
+      return fs.existsSync(path.join(linkTarget, "dist", "plugin-sdk"))
+        || fs.existsSync(path.join(linkTarget, "plugin-sdk"));
+    }
+    // 真实目录
+    return fs.existsSync(path.join(linkTarget, "dist", "plugin-sdk", "core.js"));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 确保 plugin-sdk symlink 存在。
+ *
+ * @param {string} pluginRoot - 插件根目录路径
+ * @param {string} [tag="[link-sdk]"] - 日志前缀
+ * @returns {boolean} true 如果 symlink 已存在或成功创建
+ */
+function ensurePluginSdkSymlink(pluginRoot, tag) {
+  tag = tag || "[link-sdk]";
+  try {
+    if (!pluginRoot.includes("extensions")) return true;
+
+    const linkTarget = path.join(pluginRoot, "node_modules", "openclaw");
+
+    if (fs.existsSync(linkTarget)) {
+      if (isLinkValid(linkTarget)) return true;
+      // 无效/不完整 → 删除后重建
+      try {
+        fs.rmSync(linkTarget, { recursive: true, force: true });
+        console.log(`${tag} removed incomplete node_modules/openclaw`);
+      } catch {}
+    }
+
+    if (!isOpenclawVersionRequiresSymlink()) return true;
+
+    const openclawRoot = findOpenclawRoot(pluginRoot);
+    if (!openclawRoot) {
+      console.error(`${tag} WARNING: could not find openclaw global installation, symlink not created`);
+      return false;
+    }
+
+    fs.mkdirSync(path.join(pluginRoot, "node_modules"), { recursive: true });
+    fs.symlinkSync(openclawRoot, linkTarget, "junction");
+    console.log(`${tag} symlink created: node_modules/openclaw -> ${openclawRoot}`);
+    return true;
+  } catch (e) {
+    console.error(`${tag} WARNING: symlink check failed: ${e.message || e}`);
+    return false;
+  }
+}
+
+module.exports = {
+  CLI_NAMES,
+  compareVersionGte,
+  isOpenclawVersionRequiresSymlink,
+  findOpenclawRoot,
+  isLinkValid,
+  ensurePluginSdkSymlink,
+};

package/scripts/postinstall-link-sdk.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+
+// When installed as an openclaw extension under ~/.openclaw/extensions/,
+// the plugin needs access to `openclaw/plugin-sdk` at runtime.
+// openclaw's jiti loader resolves this via alias by walking up from the plugin
+// path to find the openclaw package root — but ~/.openclaw/extensions/ is not
+// under the openclaw package tree, so the alias lookup fails.
+//
+// This script creates a symlink from the plugin's node_modules/openclaw to the
+// globally installed openclaw package, allowing Node's native ESM resolver
+// (used by jiti with tryNative:true for .js files) to find `openclaw/plugin-sdk`.
+
+import { existsSync, lstatSync, symlinkSync, unlinkSync, rmSync, mkdirSync, realpathSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pluginRoot = resolve(__dirname, "..");
+
+const linkTarget = join(pluginRoot, "node_modules", "openclaw");
+
+// Check if already a valid symlink pointing to a directory with plugin-sdk/core
+if (existsSync(linkTarget)) {
+  try {
+    const stat = lstatSync(linkTarget);
+    if (stat.isSymbolicLink()) {
+      // Symlink exists — verify it has plugin-sdk/core
+      if (existsSync(join(linkTarget, "plugin-sdk", "core.js"))) {
+        process.exit(0);
+      }
+      // Symlink is stale or points to wrong target, remove and re-create
+      unlinkSync(linkTarget);
+    } else if (existsSync(join(linkTarget, "plugin-sdk", "core.js"))) {
+      // Real directory with correct structure (e.g. npm installed a good version)
+      process.exit(0);
+    } else {
+      // Real directory from npm install but missing plugin-sdk/core — replace with symlink
+      rmSync(linkTarget, { recursive: true, force: true });
+    }
+  } catch {
+    // If stat fails, try to remove and re-create
+    try { rmSync(linkTarget, { recursive: true, force: true }); } catch {}
+  }
+}
+
+// CLI names to try (openclaw and its aliases)
+const CLI_NAMES = ["openclaw", "clawdbot", "moltbot"];
+
+// Find the global openclaw installation
+let openclawRoot = null;
+
+// Strategy 1: npm root -g → look for any known CLI package name
+if (!openclawRoot) {
+  try {
+    const globalRoot = execSync("npm root -g", { encoding: "utf-8" }).trim();
+    for (const name of CLI_NAMES) {
+      const candidate = join(globalRoot, name);
+      if (existsSync(join(candidate, "package.json"))) {
+        openclawRoot = candidate;
+        break;
+      }
+    }
+  } catch {}
+}
+
+// Strategy 2: resolve from the CLI binary (which openclaw / clawdbot / moltbot)
+if (!openclawRoot) {
+  const whichCmd = process.platform === "win32" ? "where" : "which";
+  for (const name of CLI_NAMES) {
+    try {
+      const bin = execSync(`${whichCmd} ${name}`, { encoding: "utf-8" }).trim().split("\n")[0];
+      if (!bin) continue;
+      // Resolve symlinks to get actual binary location
+      const realBin = realpathSync(bin);
+      // bin is typically <prefix>/bin/<name> -> ../lib/node_modules/<name>/...
+      const candidate = resolve(dirname(realBin), "..", "lib", "node_modules", name);
+      if (existsSync(join(candidate, "package.json"))) {
+        openclawRoot = candidate;
+        break;
+      }
+      // Also try: binary might be inside the package itself (e.g. .../node_modules/<name>/bin/<name>)
+      const candidate2 = resolve(dirname(realBin), "..");
+      if (existsSync(join(candidate2, "package.json")) && existsSync(join(candidate2, "plugin-sdk"))) {
+        openclawRoot = candidate2;
+        break;
+      }
+    } catch {}
+  }
+}
+
+// Strategy 3: walk up from the extensions directory to find the CLI's data root,
+// then look for a global node_modules sibling
+if (!openclawRoot) {
+  // pluginRoot is like /home/user/.openclaw/extensions/openclaw-qqbot
+  // The CLI data dir is /home/user/.openclaw (or .clawdbot, .moltbot)
+  const extensionsDir = dirname(pluginRoot);
+  const dataDir = dirname(extensionsDir);
+  const dataDirName = dataDir.split("/").pop() || dataDir.split("\\").pop() || "";
+  // dataDirName is like ".openclaw" → strip the dot to get "openclaw"
+  const cliName = dataDirName.replace(/^\./, "");
+  if (cliName) {
+    try {
+      const globalRoot = execSync("npm root -g", { encoding: "utf-8" }).trim();
+      const candidate = join(globalRoot, cliName);
+      if (existsSync(join(candidate, "package.json"))) {
+        openclawRoot = candidate;
+      }
+    } catch {}
+  }
+}
+
+if (!openclawRoot) {
+  // Not fatal — plugin may work if openclaw loads it with proper alias resolution
+  // But log a warning so upgrade scripts can detect the failure
+  console.error("[postinstall-link-sdk] WARNING: could not find openclaw/clawdbot/moltbot global installation, symlink not created");
+  process.exit(0);
+}
+
+try {
+  mkdirSync(join(pluginRoot, "node_modules"), { recursive: true });
+  symlinkSync(openclawRoot, linkTarget, "junction");
+  console.log(`[postinstall-link-sdk] symlink created: node_modules/openclaw -> ${openclawRoot}`);
+} catch (e) {
+  console.error(`[postinstall-link-sdk] WARNING: symlink creation failed: ${e.message}`);
+}