@myclaw163/openclaw-clawclaw 0.1.42

package/openclaw.plugin.json

@@ -0,0 +1,177 @@
+{
+  "id": "clawclaw",
+  "name": "ClawClaw (龙虾杀)",
+  "description": "Play ClawClaw (龙虾杀) social deduction game via clawclaw-cli — exposes ccl subcommands as native OpenClaw tools and bundles the play skill.",
+  "skills": [
+    "./skills"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "cclPath": {
+        "type": "string",
+        "description": "Override path to the clawclaw-cli executable (ccl). Defaults to PATH lookup, then node_modules/.bin/ccl."
+      },
+      "workspaceDir": {
+        "type": "string",
+        "description": "Override CLAWCLAW_WORKSPACE_DIR for ccl child processes. Defaults to ccl's own resolution (~/.clawclaw)."
+      },
+      "spawnTimeoutMs": {
+        "type": "number",
+        "minimum": 1000,
+        "default": 30000,
+        "description": "Per-call timeout for ccl child processes (ms)."
+      },
+      "streamOpenclawCli": {
+        "type": "string",
+        "description": "Override path to the openclaw CLI used by stream tools for `agent --deliver` injection. Defaults to PATH lookup."
+      },
+      "streamAgentTimeoutMs": {
+        "type": "number",
+        "minimum": 1000,
+        "default": 180000,
+        "description": "Timeout for each `openclaw agent --deliver` injection call (stream module)."
+      },
+      "streamDebounceMs": {
+        "type": "number",
+        "minimum": 50,
+        "maximum": 5000,
+        "default": 300,
+        "description": "Debounce window (ms) for batching stream stdout lines before injection."
+      },
+      "streamMinIntervalMs": {
+        "type": "number",
+        "minimum": 0,
+        "default": 1000,
+        "description": "Minimum gap (ms) between two consecutive stream injections."
+      },
+      "streamMaxBatchLines": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 150,
+        "description": "Max lines drained into a single injection batch."
+      },
+      "streamMaxQueueLines": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 1000,
+        "description": "Max pending lines buffered before the oldest are dropped (backpressure cap)."
+      },
+      "streamMaxBatchAgeMs": {
+        "type": "number",
+        "minimum": 0,
+        "default": 3000,
+        "description": "Force-flush a partial batch once its oldest pending line reaches this age (ms)."
+      },
+      "streamMaxInstances": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 8,
+        "description": "Max concurrent background streams."
+      },
+      "streamMaxConcurrentInjects": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 1,
+        "description": "Max concurrent `openclaw agent --deliver` injections across all streams."
+      },
+      "streamEmitLifecycleEvents": {
+        "type": "boolean",
+        "default": true,
+        "description": "Inject [STREAM_EXIT] / [STREAM_STOPPED] sentinel lines when a stream ends."
+      },
+      "streamAutoRestart": {
+        "type": "boolean",
+        "default": true,
+        "description": "Auto-restart a stream's child process on non-zero exit (clean exit code 0 never restarts)."
+      },
+      "streamMaxRestarts": {
+        "type": "integer",
+        "minimum": 0,
+        "default": 5,
+        "description": "Absolute cap on auto-restarts per stream instance over its lifetime."
+      },
+      "streamRestartBackoffBaseMs": {
+        "type": "number",
+        "minimum": 0,
+        "default": 1000,
+        "description": "Base delay for exponential restart backoff (ms)."
+      },
+      "streamRestartBackoffMaxMs": {
+        "type": "number",
+        "minimum": 0,
+        "default": 30000,
+        "description": "Maximum delay for exponential restart backoff (ms)."
+      },
+      "streamIdleTimeoutMs": {
+        "type": "number",
+        "minimum": 0,
+        "default": 120000,
+        "description": "Idle watchdog: emit a notice if a stream produces no output for this long (ms). 0 disables."
+      },
+      "streamSessionNotFoundMaxRetries": {
+        "type": "integer",
+        "minimum": 0,
+        "default": 2,
+        "description": "Consecutive session_not_found inject failures tolerated before the stream self-stops."
+      },
+      "streamPerfLogDir": {
+        "type": "string",
+        "description": "Directory for per-game perf log files. Each watch session writes a perf-<id>.log under this dir. Disabled when unset."
+      },
+      "streamSentryDsn": {
+        "type": "string",
+        "default": "https://8414ec3f56f24bd1b29ce87660f87d33@sentry.fuxi.netease.com/86",
+        "description": "Sentry DSN for monitor lifecycle event reporting (monitor.started, game.started, game.exited, etc.). Disabled when unset."
+      }
+    }
+  },
+  "contracts": {
+    "tools": [
+      "clawclaw_account_history",
+      "clawclaw_account_info",
+      "clawclaw_account_leaderboard",
+      "clawclaw_account_list",
+      "clawclaw_account_register",
+      "clawclaw_account_rename",
+      "clawclaw_account_settlement",
+      "clawclaw_account_switch",
+      "clawclaw_do",
+      "clawclaw_events",
+      "clawclaw_game_leave",
+      "clawclaw_game_map",
+      "clawclaw_game_quit",
+      "clawclaw_game_role",
+      "clawclaw_game_start",
+      "clawclaw_game_status",
+      "clawclaw_game_stop",
+      "clawclaw_game_tasks",
+      "clawclaw_game_watch",
+      "clawclaw_history_meetings",
+      "clawclaw_history_player",
+      "clawclaw_hub_info",
+      "clawclaw_hub_install",
+      "clawclaw_hub_installed",
+      "clawclaw_hub_search",
+      "clawclaw_hub_uninstall",
+      "clawclaw_load",
+      "clawclaw_memory_load",
+      "clawclaw_memory_path",
+      "clawclaw_peek",
+      "clawclaw_persona_list",
+      "clawclaw_persona_load",
+      "clawclaw_persona_path",
+      "clawclaw_persona_use",
+      "clawclaw_run",
+      "clawclaw_setup_openclaw",
+      "clawclaw_skill_install",
+      "clawclaw_skill_uninstall",
+      "clawclaw_state",
+      "clawclaw_strategy",
+      "clawclaw_tts_config",
+      "clawclaw_tts_list",
+      "clawclaw_tts_request"
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@myclaw163/openclaw-clawclaw",
+  "version": "0.1.42",
+  "type": "module",
+  "description": "OpenClaw plugin for ClawClaw (龙虾杀) — wraps clawclaw-cli as native OpenClaw tools and skill",
+  "license": "MIT",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist/",
+    "scripts/",
+    "skills/",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "sync-manifest": "node scripts/sync-manifest.mjs",
+    "prepublishOnly": "npm run sync-manifest && npm run build",
+    "postinstall": "node scripts/postinstall.mjs",
+    "release:patch": "npm version patch && npm publish --registry https://registry.npmjs.org --access public",
+    "release:minor": "npm version minor && npm publish --registry https://registry.npmjs.org --access public",
+    "release:major": "npm version major && npm publish --registry https://registry.npmjs.org --access public"
+  },
+  "dependencies": {
+    "@sentry/node": "^10.55.0",
+    "@myclaw163/clawclaw-cli": "^0.6.54"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsdown": "^0.21.4",
+    "typescript": "^5.4.0",
+    "vitest": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.mjs"
+    ],
+    "runtimeExtensions": [
+      "./dist/index.mjs"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.5.7",
+      "minGatewayVersion": "2026.5.7"
+    },
+    "install": {
+      "npmSpec": "@myclaw163/openclaw-clawclaw",
+      "localPath": "extensions/clawclaw",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * postinstall — 把 clawclaw-cli 的 SKILL.md 同步到本插件 skills/clawclaw/
+ * (skill 内容的单一来源是 clawclaw-cli;本插件安装期复制一份)
+ *
+ * 失败打 warning 不报错(exit 0),让本插件仍可加载。
+ */
+
+import { createRequire } from 'node:module';
+import { copyFileSync, existsSync, mkdirSync, renameSync, rmSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(__dirname, '..');
+const targetDir = join(repoRoot, 'skills', 'clawclaw');
+const targetFile = join(targetDir, 'SKILL.md');
+
+function warn(msg) {
+  console.warn(`[openclaw-clawclaw postinstall] ${msg}`);
+}
+
+function findPackageRoot(startFile) {
+  let dir = dirname(startFile);
+  while (dir && dir !== dirname(dir)) {
+    if (existsSync(join(dir, 'package.json'))) return dir;
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+// ─── 1. 确保 clawclaw-cli 为 latest ─────────────────────────────────────
+// npm pack 只从 registry 下载 tarball,不解依赖、不读 lock 文件,完全绕开
+// OpenClaw 的 package-lock.json 锁版本问题。
+// registry 默认走 group(同时代理内部 + 公共包),可用 CLAWCLAW_NPM_REGISTRY 或 npm_config_registry 覆盖。
+// 失败仅告警(保持 exit 0):父依赖安装已留下兜底版本的 cli,插件仍可加载。
+try {
+  const registry =
+    process.env.CLAWCLAW_NPM_REGISTRY ||
+    process.env.npm_config_registry ||
+    'https://registry.npmjs.org';
+  console.log(`[openclaw-clawclaw postinstall] ensuring @myclaw163/clawclaw-cli@latest via ${registry} ...`);
+  const tgzName = execSync(
+    `npm pack @myclaw163/clawclaw-cli@latest --pack-destination "${repoRoot}" --registry ${registry}`,
+    { cwd: repoRoot, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'inherit'] },
+  ).trim();
+  const tgz = join(repoRoot, tgzName);
+  const dest = join(repoRoot, 'node_modules', '@myclaw163', 'clawclaw-cli');
+  if (existsSync(dest)) rmSync(dest, { recursive: true, force: true });
+  const nodeModulesDir = join(repoRoot, 'node_modules');
+  mkdirSync(nodeModulesDir, { recursive: true });
+  execSync(`tar --force-local -xzf "${tgz}"`, { cwd: nodeModulesDir, stdio: 'inherit' });
+  renameSync(join(nodeModulesDir, 'package'), dest);
+  rmSync(tgz, { force: true });
+  console.log(`[openclaw-clawclaw postinstall] @myclaw163/clawclaw-cli updated to latest`);
+} catch (e) {
+  warn(
+    `@myclaw163/clawclaw-cli@latest install failed: ${e?.message ?? e}. ` +
+    `Falling back to the version from the normal dependency install. ` +
+    `Override the registry via CLAWCLAW_NPM_REGISTRY if needed.`,
+  );
+}
+
+// ─── 2. SKILL.md sync(在 cli 就绪后,确保同步的是当前 cli 版本的 skill)──────
+try {
+  const req = createRequire(import.meta.url);
+  let mainPath;
+  try {
+    mainPath = req.resolve('@myclaw163/clawclaw-cli');
+  } catch (e) {
+    warn(`@myclaw163/clawclaw-cli not resolvable (${e?.message ?? e}) — skipping SKILL sync.`);
+  }
+  if (mainPath) {
+    const cliRoot = findPackageRoot(mainPath);
+    if (!cliRoot) {
+      warn(`could not locate clawclaw-cli package root from ${mainPath} — skipping SKILL sync.`);
+    } else {
+      const sourceFile = join(cliRoot, 'skills', 'clawclaw', 'SKILL.md');
+      if (!existsSync(sourceFile) || !statSync(sourceFile).isFile()) {
+        warn(`source SKILL.md not found at ${sourceFile} — skipping SKILL sync.`);
+      } else {
+        if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
+        copyFileSync(sourceFile, targetFile);
+        const sz = statSync(targetFile).size;
+        console.log(`[openclaw-clawclaw postinstall] synced SKILL.md from @myclaw163/clawclaw-cli (${sz} B)`);
+      }
+    }
+  }
+} catch (e) {
+  warn(`SKILL sync error: ${e?.message ?? e}`);
+}

package/scripts/sync-manifest.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * sync-manifest — 把 `openclaw.plugin.json` 的 contracts.tools 数组与
+ * 当前 `ccl _schema` 输出 + 插件侧手写工具同步。
+ *
+ * 为什么需要:OpenClaw runtime 要求 plugin 注册的工具必须预先在 manifest 的
+ * contracts.tools 里声明,否则会被标记 "undeclared" 拒绝透传给 LLM。
+ *
+ * 何时跑:
+ *   - clawclaw-cli 加 / 删 / 重命名了子命令 → 跑这个脚本 → commit manifest
+ *   - 在 src/index.ts 或 src/stream.ts 里增删插件侧手写工具 → 同步修改下方的
+ *     PLUGIN_ONLY_TOOLS,然后跑一次
+ *
+ * 流程:`npm run sync-manifest && npm run build && git diff openclaw.plugin.json`
+ */
+
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(__dirname, '..');
+const manifestPath = join(repoRoot, 'openclaw.plugin.json');
+
+// ─── 插件侧手写工具:不对应任何 ccl 子命令,所以无法从 schema 推导 ────────
+// 增删 src/index.ts / src/stream.ts 里的 registerTool 时同步改这里。
+const PLUGIN_ONLY_TOOLS = [
+  'clawclaw_run',           // raw passthrough (src/index.ts)
+  'clawclaw_game_status',   // 查看后台游戏流状态 (src/stream.ts)
+];
+
+// 不暴露为 typed tool 的 ccl 子命令路径。
+// 必须与 src/index.ts 中的 SKIP_PATHS 保持一致。
+//   - upgrade:    CLI 自升级,LLM 不应触发
+//   - watch:      长期运行的流,通过 PLUGIN_ONLY_TOOLS 里的 clawclaw_watch_* 系列暴露
+//   - game join:  已废弃 — `ccl game start` 内部已覆盖 join + queue + 流式事件
+//   - game queue: 已废弃 — `ccl game start` 的流式输出涵盖匹配等待
+const SKIP_PATHS = new Set(['upgrade', 'watch', 'game join', 'game queue']);;
+
+// ─── 找 ccl bin ─────────────────────────────────────────────────────────
+function findCclBin() {
+  try {
+    const req = createRequire(import.meta.url);
+    const main = req.resolve('clawclaw-cli');
+    let dir = main;
+    while (dir && dir !== dirname(dir)) {
+      const next = dirname(dir);
+      if (next === dir) break;
+      dir = next;
+      if (existsSync(join(dir, 'package.json'))) break;
+    }
+    const bin = join(dir, 'bin', 'clawclaw-cli.mjs');
+    if (existsSync(bin)) return bin;
+  } catch {}
+  throw new Error('clawclaw-cli not found in node_modules; run `npm install` first');
+}
+
+function fetchSchema() {
+  const bin = findCclBin();
+  const r = spawnSync(process.execPath, [bin, '_schema'], {
+    env: { ...process.env, NO_COLOR: '1' },
+    timeout: 15_000,
+    encoding: 'utf-8',
+    windowsHide: true,
+  });
+  if (r.status !== 0) {
+    throw new Error(`ccl _schema failed (exit ${r.status}): ${r.stderr?.slice(0, 500)}`);
+  }
+  return JSON.parse(r.stdout);
+}
+
+// 遍历 schema 树,产出所有 leaf 子命令对应的 typed tool 名
+function collectAutoGenTools(schema) {
+  const names = new Set();
+  const visit = (node) => {
+    if (node.leaf && node.path && !SKIP_PATHS.has(node.path)) {
+      names.add(`clawclaw_${node.path.replace(/\s+/g, '_')}`);
+    }
+    for (const sub of (node.subcommands ?? [])) visit(sub);
+  };
+  visit(schema);
+  return names;
+}
+
+// ─── 主流程 ─────────────────────────────────────────────────────────────
+const schema = fetchSchema();
+const autoGen = collectAutoGenTools(schema);
+const allTools = [...new Set([...autoGen, ...PLUGIN_ONLY_TOOLS])].sort();
+
+const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+const before = manifest.contracts?.tools ?? [];
+manifest.contracts = manifest.contracts ?? {};
+manifest.contracts.tools = allTools;
+
+writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+
+const added = allTools.filter((t) => !before.includes(t));
+const removed = before.filter((t) => !allTools.includes(t));
+console.log(`[sync-manifest] auto-gen=${autoGen.size}  plugin-only=${PLUGIN_ONLY_TOOLS.length}  total=${allTools.length}`);
+if (added.length)   console.log(`[sync-manifest] +${added.length}: ${added.join(', ')}`);
+if (removed.length) console.log(`[sync-manifest] -${removed.length}: ${removed.join(', ')}`);
+if (!added.length && !removed.length) console.log('[sync-manifest] manifest already in sync ✓');

package/skills/clawclaw/.gitkeep

@@ -0,0 +1 @@
+# keep dir; SKILL.md is synced from clawclaw-cli by scripts/postinstall.mjs