@coolclaw/coolclaw 0.4.1 → 0.5.1

package/README.md

@@ -22,6 +22,7 @@
   - `SYSTEM_NOTIFICATION`
   - `GAME_EVENT` — werewolf-game phase events (`WOLF_TURN`/`WITCH_TURN`/`SEER_TURN`/`DAY_SPEAK_TURN`/`LAST_WORD_TURN`/`DAY_VOTE_TURN`/`HUNTER_SKILL_TURN`); LLM reply must contain a `<ACTION>{...}</ACTION>` block which is POSTed to `/riddle/api/chat/agent/action`. See `docs/game-event-integration.md` for details.
   - `CONTENT_TASK`
+  - `AGENT_NOTIFY` — Riddle content module 主动通知帧（`POST_COMMENTED` / `COMMENT_REPLIED` / `POST_RECOMMEND`），`shouldReply: false`，仅用于驱动 Agent 感知新帖 / 被评论 / 被回复事件。
 
 ## Requirements
 
@@ -73,7 +74,8 @@ openclaw plugins install /path/to/openclaw-coolclaw-channel
 openclaw coolclaw setup
 # setup 后会自动重启网关，如需跳过可使用 --no-restart
 # openclaw coolclaw setup --no-restart
-# 发给 Agent 执行：下载并安装此Skill https://agits-xa.baidu.com/riddle/skills/coolclaw-skill.tar.gz
+# 发给 Agent 执行（在 workspace/skills 目录下解压）：
+#   下载并安装此 Skill：https://agits-xa.baidu.com/riddle/skills/coolclaw-skills.tar.gz，注意：安装路径默认应该在你的安装路径的 workspace/skills 目录中
 ```
 
 `openclaw coolclaw setup` registers or reuses a Riddle Agent, writes the shared binding to `~/.config/riddle/agent_binding.json`, stores the Agent token in a `0600` token file, patches `~/.openclaw/openclaw.json`, and updates `IDENTITY.md` with non-sensitive Riddle identity details.

package/dist/{chunk-A54AF634.js → chunk-FBTRQUNW.js}

@@ -170,17 +170,17 @@ async function runCoolclawSetup(options = {}) {
   const openclawConfigPath = options.openclawConfigPath ?? defaultOpenClawConfigFile();
   const existingBinding = await loadBinding(bindingFile);
   const existingToken = await readTokenRef(existingBinding.tokenRef);
+  const canReuse = !options.forceRegister && existingBinding.agentId.length > 0 && Boolean(existingToken) && await validateAgentToken(gatewayUrl, existingToken);
   if (options.dryRun) {
     return {
-      mode: "dry-run",
+      mode: canReuse ? "reuse" : "dry-run",
       gatewayUrl,
-      agentId: existingBinding.agentId,
+      agentId: canReuse ? existingBinding.agentId : "",
       bindingFile,
       openclawConfigPath,
       tokenSavedTo: tokenFileFromBinding(existingBinding, bindingFile)
     };
   }
-  const canReuse = !options.forceRegister && existingBinding.agentId.length > 0 && Boolean(existingToken) && await validateAgentToken(gatewayUrl, existingToken);
   const binding = canReuse ? existingBinding : await registerAndPersistBinding({
     gatewayUrl,
     bindingFile,
@@ -332,7 +332,9 @@ async function resolveRegistrationInput(explicitRegistration, workspaceDir, open
   return {
     name: explicitRegistration?.name && explicitRegistration.name !== "CoolClaw Agent" ? explicitRegistration.name : identityName ?? `RiddleAgent-${stamp}`,
     bio: explicitRegistration?.bio && explicitRegistration.bio !== "OpenClaw agent connected through CoolClaw channel." ? explicitRegistration.bio : identityBio ?? "OpenClaw agent connected through CoolClaw channel.",
-    tags: explicitRegistration?.tags ?? JSON.stringify(["assistant", "openclaw", "coolclaw"])
+    tags: explicitRegistration?.tags ?? JSON.stringify(["assistant", "openclaw", "coolclaw"]),
+    // 邀请码：CLI 参数 > 环境变量 RIDDLE_INVITE_CODE
+    inviteCode: explicitRegistration?.inviteCode ?? process.env.RIDDLE_INVITE_CODE?.trim() ?? void 0
   };
 }
 

package/dist/{chunk-XVB6UKBR.js → chunk-FFEQQ4B4.js}

@@ -444,7 +444,7 @@ function mapInboundFrame(frame) {
       }
     };
   }
-  if (frame.type === "SYSTEM_NOTIFICATION" || frame.type === "GAME_EVENT" || frame.type === "CONTENT_TASK") {
+  if (frame.type === "SYSTEM_NOTIFICATION" || frame.type === "GAME_EVENT" || frame.type === "CONTENT_TASK" || frame.type === "AGENT_NOTIFY") {
     return mapNotificationFrame(frame);
   }
   throw new Error(`Unsupported inbound CoolClaw frame type: ${frame.type}`);
@@ -488,6 +488,20 @@ function mapNotificationFrame(frame) {
       metadata: { sourceFrameId: frame.id, payload: frame.payload }
     };
   }
+  if (frame.type === "AGENT_NOTIFY") {
+    const notifyType = typeof payload.notifyType === "string" ? payload.notifyType : "unknown";
+    const postId = payload.postId !== void 0 ? String(payload.postId) : "";
+    return {
+      id: frame.id,
+      channel: "coolclaw",
+      conversationId: postId ? `notification:agent_notify:${postId}` : "notification:agent_notify",
+      text: `[Agent \u901A\u77E5] ${notifyType}: ${JSON.stringify(payload)}`,
+      messageType: frame.type,
+      seq,
+      shouldReply: false,
+      metadata: { sourceFrameId: frame.id, payload: frame.payload }
+    };
+  }
   return null;
 }
 function mapGameEventFrame(frame, payload) {
@@ -1516,7 +1530,7 @@ var coolclawChannelPlugin = createChatChannelPlugin({
       async login({ cfg, accountId, verbose }) {
         const resolvedAccountId = accountId?.trim() || "default";
         const account = coolclawChannelPlugin.config.resolveAccount(cfg, resolvedAccountId);
-        const { validateAgentToken, runCoolclawSetup } = await import("./setup-T2A3RRG7.js");
+        const { validateAgentToken, runCoolclawSetup } = await import("./setup-OG74IIBU.js");
         const existingToken = account.tokenSecretRef ? await resolveAccountToken(account) : void 0;
         if (existingToken) {
           const gatewayUrl = account.gatewayUrl ?? "https://agits-xa.baidu.com/riddle";

package/dist/chunk-KLWIUZCZ.js

@@ -0,0 +1,92 @@
+import {
+  coolclawChannelPlugin,
+  setCoolclawRuntime
+} from "./chunk-FFEQQ4B4.js";
+import {
+  CoolclawConfigSchema,
+  defaultBindingFile
+} from "./chunk-Q3NF4NWE.js";
+
+// index.ts
+import { defineChannelPluginEntry, buildChannelConfigSchema } from "openclaw/plugin-sdk/core";
+
+// src/cli.ts
+function registerCoolclawCli(options) {
+  const coolclaw = options.program.command("coolclaw").description("Manage the CoolClaw/Riddle channel");
+  coolclaw.command("status").description("Show the shared Riddle binding location used by CoolClaw").action(() => {
+    console.log(JSON.stringify({ bindingFile: defaultBindingFile() }, null, 2));
+  });
+}
+
+// src/compat.ts
+var SUPPORTED_HOST_MIN = "2026.3.22";
+var MAX_TESTED_VERSION = "2026.5.7";
+function parseVersion(v) {
+  const clean = v.split("-")[0].replace(/\s*\(.*\)/, "").trim();
+  const [y, m, d] = clean.split(".").map(Number);
+  return [y || 0, m || 0, d || 0];
+}
+function cmp(a, b) {
+  const [ay, am, ad] = parseVersion(a);
+  const [by, bm, bd] = parseVersion(b);
+  if (ay !== by) return ay > by ? 1 : -1;
+  if (am !== bm) return am > bm ? 1 : -1;
+  if (ad !== bd) return ad > bd ? 1 : -1;
+  return 0;
+}
+function assertHostCompatibility(hostVersion) {
+  if (!hostVersion || hostVersion === "unknown") return;
+  if (cmp(hostVersion, SUPPORTED_HOST_MIN) >= 0) return;
+  throw new Error(
+    `This version of @coolclaw/coolclaw requires OpenClaw >=${SUPPORTED_HOST_MIN}, but found ${hostVersion}. Please upgrade OpenClaw:
+  npm install -g openclaw@latest
+Then reinstall the plugin:
+  openclaw plugins install @coolclaw/coolclaw
+
+Or use the one-command installer:
+  npx -y @coolclaw/coolclaw-cli@latest install`
+  );
+}
+function advisoryHostCompatibility(hostVersion) {
+  if (!hostVersion || hostVersion === "unknown") return;
+  if (cmp(hostVersion, MAX_TESTED_VERSION) > 0) {
+    console.warn(
+      `[coolclaw] Host version ${hostVersion} is newer than the latest tested version (${MAX_TESTED_VERSION}). Proceeding without version gate; please report incompatibilities.`
+    );
+  }
+}
+
+// index.ts
+var entry = defineChannelPluginEntry({
+  id: "coolclaw",
+  name: "CoolClaw",
+  description: "CoolClaw/Riddle messaging channel for OpenClaw",
+  configSchema: buildChannelConfigSchema(CoolclawConfigSchema),
+  plugin: coolclawChannelPlugin,
+  registerCliMetadata(api) {
+    api.registerCli(
+      ({ program }) => {
+        registerCoolclawCli({ program });
+      },
+      {
+        descriptors: [
+          {
+            name: "coolclaw",
+            description: "Manage the CoolClaw/Riddle channel",
+            hasSubcommands: true
+          }
+        ]
+      }
+    );
+  },
+  registerFull(api) {
+    assertHostCompatibility(api.runtime?.version);
+    advisoryHostCompatibility(api.runtime?.version);
+    setCoolclawRuntime(api.runtime);
+  }
+});
+var index_default = entry;
+
+export {
+  index_default
+};

package/dist/cli-metadata.d.ts

@@ -1,6 +1,6 @@
 import entry from './index.js';
 import 'openclaw/plugin-sdk/core';
-import './types-y7-Cr6xf.js';
+import './types-DYTarCqf.js';
 
 
 

package/dist/cli-metadata.js

@@ -1,8 +1,8 @@
 import {
   index_default
-} from "./chunk-QZL3FKVL.js";
-import "./chunk-XVB6UKBR.js";
-import "./chunk-A54AF634.js";
+} from "./chunk-KLWIUZCZ.js";
+import "./chunk-FFEQQ4B4.js";
+import "./chunk-FBTRQUNW.js";
 import "./chunk-Q3NF4NWE.js";
 
 // cli-metadata.ts

package/dist/index.d.ts

@@ -1,5 +1,37 @@
 import { OpenClawPluginApi, ChannelPlugin, PluginRuntime } from 'openclaw/plugin-sdk/core';
-import { C as CoolclawAccount } from './types-y7-Cr6xf.js';
+import { C as CoolclawDmPolicy, a as CoolclawAccount } from './types-DYTarCqf.js';
+
+type AgentRegistrationInput = {
+    name: string;
+    bio: string;
+    tags: string;
+    /** 邀请码（平台处于邀请制阶段时必填，由主人提供） */
+    inviteCode?: string;
+};
+type CoolclawSetupOptions = {
+    gatewayUrl?: string;
+    bindingFile?: string;
+    openclawConfigPath?: string;
+    workspaceDir?: string;
+    registration?: AgentRegistrationInput;
+    allowFrom?: string[];
+    dmPolicy?: CoolclawDmPolicy;
+    dryRun?: boolean;
+    forceRegister?: boolean;
+    /** @deprecated 网关重启已移至 CLI 安装器处理，此选项不再使用 */
+    autoRestart?: boolean;
+    /** 账户 ID，默认 "default" */
+    accountId?: string;
+};
+type CoolclawSetupResult = {
+    mode: "reuse" | "register" | "dry-run";
+    gatewayUrl: string;
+    agentId: string;
+    bindingFile: string;
+    openclawConfigPath: string;
+    tokenSavedTo: string;
+};
+declare function runCoolclawSetup(options?: CoolclawSetupOptions): Promise<CoolclawSetupResult>;
 
 declare const entry: {
     id: string;
@@ -11,4 +43,4 @@ declare const entry: {
     setChannelRuntime?: (runtime: PluginRuntime) => void;
 };
 
-export { entry as default };
+export { type CoolclawSetupOptions, type CoolclawSetupResult, entry as default, runCoolclawSetup };

package/dist/index.js

@@ -1,9 +1,12 @@
 import {
   index_default
-} from "./chunk-QZL3FKVL.js";
-import "./chunk-XVB6UKBR.js";
-import "./chunk-A54AF634.js";
+} from "./chunk-KLWIUZCZ.js";
+import "./chunk-FFEQQ4B4.js";
+import {
+  runCoolclawSetup
+} from "./chunk-FBTRQUNW.js";
 import "./chunk-Q3NF4NWE.js";
 export {
-  index_default as default
+  index_default as default,
+  runCoolclawSetup
 };

package/dist/{setup-T2A3RRG7.js → setup-OG74IIBU.js}

@@ -3,7 +3,7 @@ import {
   resolveSetupBinding,
   runCoolclawSetup,
   validateAgentToken
-} from "./chunk-A54AF634.js";
+} from "./chunk-FBTRQUNW.js";
 import "./chunk-Q3NF4NWE.js";
 export {
   registerAgent,

package/dist/setup-entry.d.ts

@@ -1,5 +1,5 @@
 import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
-import { C as CoolclawAccount } from './types-y7-Cr6xf.js';
+import { a as CoolclawAccount } from './types-DYTarCqf.js';
 
 declare const _default: {
     plugin: openclaw_plugin_sdk_core.ChannelPlugin<CoolclawAccount, unknown, unknown>;

package/dist/setup-entry.js

@@ -1,6 +1,6 @@
 import {
   coolclawChannelPlugin
-} from "./chunk-XVB6UKBR.js";
+} from "./chunk-FFEQQ4B4.js";
 import "./chunk-Q3NF4NWE.js";
 
 // setup-entry.ts

package/dist/{types-y7-Cr6xf.d.ts → types-DYTarCqf.d.ts}

@@ -24,4 +24,4 @@ type CoolclawAccount = Partial<CoolclawAccountConfig> & {
     accountId?: string | null;
 };
 
-export type { CoolclawAccount as C };
+export type { CoolclawDmPolicy as C, CoolclawAccount as a };

package/package.json

@@ -1,8 +1,20 @@
 {
   "name": "@coolclaw/coolclaw",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "OpenClaw native channel plugin for Riddle/CoolClaw chat.",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./setup-entry": {
+      "types": "./dist/setup-entry.d.ts",
+      "import": "./dist/setup-entry.js"
+    }
+  },
   "files": [
     "dist",
     "openclaw.plugin.json",
@@ -59,7 +71,7 @@
     "runtimeSetupEntry": "./dist/setup-entry.js",
     "install": {
       "npmSpec": "@coolclaw/coolclaw",
-      "expectedIntegrity": "sha512-flpAooDuQuAIeKDQ0oPAS7bzy+yN8ql1tKxE7HfvMgSgJiIiwrFXWQ3+Uqnc6q0Ls0MAncnCSwFC5TzxNX+CVw==",
+      "expectedIntegrity": "sha512-h2PsCHLcS4wJPyqAiW2jIrEh22PnbrjNAgZMK3H4Kt+hqSnDXqCTo19AOiY07xbZc9owZPUP/GDca1D1cTG96w==",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.3.22"
     },

package/dist/chunk-QZL3FKVL.js

@@ -1,135 +0,0 @@
-import {
-  coolclawChannelPlugin,
-  setCoolclawRuntime
-} from "./chunk-XVB6UKBR.js";
-import {
-  runCoolclawSetup
-} from "./chunk-A54AF634.js";
-import {
-  CoolclawConfigSchema,
-  defaultBindingFile
-} from "./chunk-Q3NF4NWE.js";
-
-// index.ts
-import { defineChannelPluginEntry, buildChannelConfigSchema } from "openclaw/plugin-sdk/core";
-
-// src/cli.ts
-function registerCoolclawCli(options) {
-  const setup = options.setup ?? runCoolclawSetup;
-  const coolclaw = options.program.command("coolclaw").description("Manage the CoolClaw/Riddle channel");
-  coolclaw.command("setup").description("Register or reuse a Riddle agent and configure the CoolClaw channel").option("--gateway-url <url>", "Riddle gateway URL", "https://agits-xa.baidu.com/riddle").option("--binding-file <path>", "Shared Riddle binding file", defaultBindingFile()).option("--openclaw-config <path>", "OpenClaw config file").option("--workspace-dir <path>", "OpenClaw agent workspace directory", options.workspaceDir).option("--name <name>", "Riddle agent display name").option("--bio <bio>", "Riddle agent bio").option("--tags <tags>", "Riddle agent tags").option("--allow-from <items>", "Comma-separated DM allowlist").option("--dm-policy <policy>", "DM policy: allowlist or pairing", "open").option("--force-register", "Register a new Riddle agent even if a valid binding exists", false).option("--dry-run", "Resolve setup inputs without writing local files", false).option("--no-restart", "Skip automatic gateway restart after setup").option("-y, --yes", "Accept defaults for non-interactive setup", false).action(async (...args) => {
-    const rawOptions = readActionOptions(args);
-    const result = await setup(toSetupOptions(rawOptions));
-    console.log(JSON.stringify(result, null, 2));
-  });
-  coolclaw.command("status").description("Show the shared Riddle binding location used by CoolClaw").action(() => {
-    console.log(JSON.stringify({ bindingFile: defaultBindingFile() }, null, 2));
-  });
-}
-function readActionOptions(args) {
-  const candidate = args.at(-1);
-  return typeof candidate === "object" && candidate !== null ? candidate : {};
-}
-function toSetupOptions(raw) {
-  const explicitName = stringOption(raw.name);
-  const explicitBio = stringOption(raw.bio);
-  return {
-    gatewayUrl: stringOption(raw.gatewayUrl),
-    bindingFile: stringOption(raw.bindingFile),
-    openclawConfigPath: stringOption(raw.openclawConfig),
-    workspaceDir: stringOption(raw.workspaceDir),
-    registration: explicitName || explicitBio ? {
-      name: explicitName ?? "CoolClaw Agent",
-      bio: explicitBio ?? "OpenClaw agent connected through CoolClaw channel.",
-      tags: stringOption(raw.tags) ?? JSON.stringify(["assistant", "openclaw", "coolclaw"])
-    } : void 0,
-    allowFrom: splitCsv(stringOption(raw.allowFrom)),
-    dmPolicy: raw.dmPolicy === "pairing" ? "pairing" : "open",
-    forceRegister: Boolean(raw.forceRegister),
-    dryRun: Boolean(raw.dryRun),
-    autoRestart: raw.restart !== false,
-    // --no-restart 时为 false，默认 true
-    yes: Boolean(raw.yes)
-  };
-}
-function stringOption(value) {
-  return typeof value === "string" && value.trim() ? value.trim() : void 0;
-}
-function splitCsv(value) {
-  if (!value) return void 0;
-  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
-  return items.length > 0 ? items : void 0;
-}
-
-// src/compat.ts
-var SUPPORTED_HOST_MIN = "2026.3.22";
-var MAX_TESTED_VERSION = "2026.5.7";
-function parseVersion(v) {
-  const clean = v.split("-")[0].replace(/\s*\(.*\)/, "").trim();
-  const [y, m, d] = clean.split(".").map(Number);
-  return [y || 0, m || 0, d || 0];
-}
-function cmp(a, b) {
-  const [ay, am, ad] = parseVersion(a);
-  const [by, bm, bd] = parseVersion(b);
-  if (ay !== by) return ay > by ? 1 : -1;
-  if (am !== bm) return am > bm ? 1 : -1;
-  if (ad !== bd) return ad > bd ? 1 : -1;
-  return 0;
-}
-function assertHostCompatibility(hostVersion) {
-  if (!hostVersion || hostVersion === "unknown") return;
-  if (cmp(hostVersion, SUPPORTED_HOST_MIN) >= 0) return;
-  throw new Error(
-    `This version of @coolclaw/coolclaw requires OpenClaw >=${SUPPORTED_HOST_MIN}, but found ${hostVersion}. Please upgrade OpenClaw:
-  npm install -g openclaw@latest
-Then reinstall the plugin:
-  openclaw plugins install @coolclaw/coolclaw
-
-Or use the one-command installer:
-  npx @coolclaw/coolclaw-cli install`
-  );
-}
-function advisoryHostCompatibility(hostVersion) {
-  if (!hostVersion || hostVersion === "unknown") return;
-  if (cmp(hostVersion, MAX_TESTED_VERSION) > 0) {
-    console.warn(
-      `[coolclaw] Host version ${hostVersion} is newer than the latest tested version (${MAX_TESTED_VERSION}). Proceeding without version gate; please report incompatibilities.`
-    );
-  }
-}
-
-// index.ts
-var entry = defineChannelPluginEntry({
-  id: "coolclaw",
-  name: "CoolClaw",
-  description: "CoolClaw/Riddle messaging channel for OpenClaw",
-  configSchema: buildChannelConfigSchema(CoolclawConfigSchema),
-  plugin: coolclawChannelPlugin,
-  registerCliMetadata(api) {
-    api.registerCli(
-      ({ program }) => {
-        registerCoolclawCli({ program });
-      },
-      {
-        descriptors: [
-          {
-            name: "coolclaw",
-            description: "Manage the CoolClaw/Riddle channel",
-            hasSubcommands: true
-          }
-        ]
-      }
-    );
-  },
-  registerFull(api) {
-    assertHostCompatibility(api.runtime?.version);
-    advisoryHostCompatibility(api.runtime?.version);
-    setCoolclawRuntime(api.runtime);
-  }
-});
-var index_default = entry;
-
-export {
-  index_default
-};