@coolclaw/coolclaw 0.4.1 → 0.5.0

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-DHGATALZ.js}

@@ -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-QZL3FKVL.js → chunk-I6SQ5S34.js}

@@ -1,10 +1,10 @@
 import {
   coolclawChannelPlugin,
   setCoolclawRuntime
-} from "./chunk-XVB6UKBR.js";
+} from "./chunk-P2I7XHZL.js";
 import {
   runCoolclawSetup
-} from "./chunk-A54AF634.js";
+} from "./chunk-DHGATALZ.js";
 import {
   CoolclawConfigSchema,
   defaultBindingFile
@@ -17,7 +17,7 @@ import { defineChannelPluginEntry, buildChannelConfigSchema } from "openclaw/plu
 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) => {
+  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("--invite-code <code>", "Riddle invite code (required during invite-only phase; ask your \u4E3B\u4EBA)").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));
@@ -33,15 +33,17 @@ function readActionOptions(args) {
 function toSetupOptions(raw) {
   const explicitName = stringOption(raw.name);
   const explicitBio = stringOption(raw.bio);
+  const explicitInviteCode = stringOption(raw.inviteCode) ?? stringOption(process.env.RIDDLE_INVITE_CODE);
   return {
     gatewayUrl: stringOption(raw.gatewayUrl),
     bindingFile: stringOption(raw.bindingFile),
     openclawConfigPath: stringOption(raw.openclawConfig),
     workspaceDir: stringOption(raw.workspaceDir),
-    registration: explicitName || explicitBio ? {
+    registration: explicitName || explicitBio || explicitInviteCode ? {
       name: explicitName ?? "CoolClaw Agent",
       bio: explicitBio ?? "OpenClaw agent connected through CoolClaw channel.",
-      tags: stringOption(raw.tags) ?? JSON.stringify(["assistant", "openclaw", "coolclaw"])
+      tags: stringOption(raw.tags) ?? JSON.stringify(["assistant", "openclaw", "coolclaw"]),
+      inviteCode: explicitInviteCode
     } : void 0,
     allowFrom: splitCsv(stringOption(raw.allowFrom)),
     dmPolicy: raw.dmPolicy === "pairing" ? "pairing" : "open",
@@ -87,7 +89,7 @@ Then reinstall the plugin:
   openclaw plugins install @coolclaw/coolclaw
 
 Or use the one-command installer:
-  npx @coolclaw/coolclaw-cli install`
+  npx -y @coolclaw/coolclaw-cli@latest install`
   );
 }
 function advisoryHostCompatibility(hostVersion) {

package/dist/{chunk-XVB6UKBR.js → chunk-P2I7XHZL.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-HS3PWYJK.js");
         const existingToken = account.tokenSecretRef ? await resolveAccountToken(account) : void 0;
         if (existingToken) {
           const gatewayUrl = account.gatewayUrl ?? "https://agits-xa.baidu.com/riddle";

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-I6SQ5S34.js";
+import "./chunk-P2I7XHZL.js";
+import "./chunk-DHGATALZ.js";
 import "./chunk-Q3NF4NWE.js";
 
 // cli-metadata.ts

package/dist/index.js

@@ -1,8 +1,8 @@
 import {
   index_default
-} from "./chunk-QZL3FKVL.js";
-import "./chunk-XVB6UKBR.js";
-import "./chunk-A54AF634.js";
+} from "./chunk-I6SQ5S34.js";
+import "./chunk-P2I7XHZL.js";
+import "./chunk-DHGATALZ.js";
 import "./chunk-Q3NF4NWE.js";
 export {
   index_default as default

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

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

package/dist/setup-entry.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coolclaw/coolclaw",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "OpenClaw native channel plugin for Riddle/CoolClaw chat.",
   "type": "module",
   "files": [
@@ -59,7 +59,7 @@
     "runtimeSetupEntry": "./dist/setup-entry.js",
     "install": {
       "npmSpec": "@coolclaw/coolclaw",
-      "expectedIntegrity": "sha512-flpAooDuQuAIeKDQ0oPAS7bzy+yN8ql1tKxE7HfvMgSgJiIiwrFXWQ3+Uqnc6q0Ls0MAncnCSwFC5TzxNX+CVw==",
+      "expectedIntegrity": "sha512-HI/uadGwTrDPoM8FJ47+0F5bix6X49i7TUPQ/3x+e12BzyyCgE5gHrQsv2qic5VjHmbPoQ/IAfnejecmxl7Lsw==",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.3.22"
     },