@xfxstudio/claworld 2026.4.22-testing.5 → 2026.4.22-testing.6

package/openclaw.plugin.json

@@ -8,7 +8,7 @@
   ],
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.4.22-testing.5",
+  "version": "2026.4.22-testing.6",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -50,7 +50,7 @@
           "world",
           "full"
         ],
-        "description": "Legacy ignored field retained for backward-compatible config parsing."
+        "description": "Optional ignored profile selector. Current tool exposure is backend-defined."
       },
       "heartbeatSeconds": {
         "type": "integer",
@@ -128,12 +128,12 @@
           "agentId": {
             "type": "string",
             "minLength": 1,
-            "description": "Legacy relay agent id hint. Canonical flow resolves the binding from appToken at runtime."
+            "description": "Optional relay agent id hint. The current flow resolves the binding from appToken at runtime."
           },
           "credentialToken": {
             "type": "string",
             "minLength": 1,
-            "description": "Legacy alias for appToken."
+            "description": "Optional credential token for this account. appToken is the current field."
           },
           "defaultTargetAgentId": {
             "type": "string",
@@ -197,7 +197,7 @@
                 "world",
                 "full"
               ],
-              "description": "Legacy ignored field retained for backward-compatible config parsing."
+              "description": "Optional ignored profile selector. Current tool exposure is backend-defined."
             },
             "heartbeatSeconds": {
               "type": "integer",
@@ -275,12 +275,12 @@
                 "agentId": {
                   "type": "string",
                   "minLength": 1,
-                  "description": "Legacy relay agent id hint. Canonical flow resolves the binding from appToken at runtime."
+                  "description": "Optional relay agent id hint. The current flow resolves the binding from appToken at runtime."
                 },
                 "credentialToken": {
                   "type": "string",
                   "minLength": 1,
-                  "description": "Legacy alias for appToken."
+                  "description": "Optional credential token for this account. appToken is the current field."
                 },
                 "defaultTargetAgentId": {
                   "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.4.22-testing.5",
+  "version": "2026.4.22-testing.6",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",

package/skills/claworld-join-and-chat/SKILL.md

@@ -215,7 +215,7 @@ ANNOUNCE_SKIP
 
 常见下一步是 `claworld_get_world_detail`，但不是写死的唯一下一步。
 
-`claworld_list_worlds` 现在只是 compatibility browse alias。除非已有旧流程明确要求，否则优先用 `claworld_search_worlds`。
+`claworld_list_worlds` 用于无关键词浏览 world。用户带有主题、意图、爱好、地点等关键词时，优先用 `claworld_search_worlds`。
 
 ## `claworld_get_world_detail`
 

package/src/lib/relay/kickoff-progress.js

@@ -121,6 +121,8 @@ export async function markAcceptedChatKickoffProgressWithDeps(deps, {
   turnId = null,
   deliveryId = null,
   conversationKey = null,
+  sessionKey = null,
+  localSessionKey = null,
   senderKickoffDeliveredAt = null,
   openerAcceptedAt = null,
   openerDeliveredAt = null,
@@ -141,6 +143,12 @@ export async function markAcceptedChatKickoffProgressWithDeps(deps, {
     ...(normalizeOptionalText(turnId) ? { turnId: normalizeOptionalText(turnId) } : {}),
     ...(normalizeOptionalText(deliveryId) ? { deliveryId: normalizeOptionalText(deliveryId) } : {}),
     ...(normalizeOptionalText(conversationKey) ? { conversationKey: normalizeOptionalText(conversationKey) } : {}),
+    ...(normalizeOptionalText(sessionKey) ? { sessionKey: normalizeOptionalText(sessionKey) } : {}),
+    ...(normalizeOptionalText(localSessionKey)
+      ? { localSessionKey: normalizeOptionalText(localSessionKey) }
+      : normalizeOptionalText(sessionKey)
+        ? { localSessionKey: normalizeOptionalText(sessionKey) }
+        : {}),
     ...(normalizeOptionalText(senderKickoffDeliveredAt)
       ? {
           senderKickoffDeliveredAt: normalizeOptionalText(senderKickoffDeliveredAt),

package/src/openclaw/plugin/config-schema.js

@@ -40,12 +40,12 @@ export const MANUAL_RELAY_BINDING_SCHEMA = {
     agentId: {
       type: 'string',
       minLength: 1,
-      description: 'Legacy relay agent id hint. Canonical flow resolves the binding from appToken at runtime.',
+      description: 'Optional relay agent id hint. The current flow resolves the binding from appToken at runtime.',
     },
     credentialToken: {
       type: 'string',
       minLength: 1,
-      description: 'Legacy alias for appToken.',
+      description: 'Optional credential token for this account. appToken is the current field.',
     },
     defaultTargetAgentId: {
       type: 'string',
@@ -85,7 +85,7 @@ const SINGLE_ACCOUNT_PROPERTIES = {
   toolProfile: {
     type: 'string',
     enum: ['minimal', 'default', 'world', 'full'],
-    description: 'Legacy ignored field retained for backward-compatible config parsing.',
+    description: 'Optional ignored profile selector. Current tool exposure is backend-defined.',
   },
   heartbeatSeconds: {
     type: 'integer',

package/src/openclaw/plugin/register.js

@@ -203,7 +203,6 @@ function buildRegisteredTools(api, plugin) {
           'This is the main public discovery surface for worlds.',
           'Leave query empty to browse by hot or latest; provide a query to search by free-form intent such as hobby, location, or relationship goal.',
           'Expected behavior: returns paginated world summaries plus structured follow-up actions for detail and join.',
-          'claworld_list_worlds is only the compatibility browse alias for the empty-query branch.',
         ],
         examples: [
           {
@@ -278,12 +277,12 @@ function buildRegisteredTools(api, plugin) {
     {
       name: 'claworld_list_worlds',
       label: 'Claworld List Worlds',
-      description: 'Compatibility browse alias for the search_worlds browse branch. Prefer claworld_search_worlds for all new world discovery flows.',
+      description: 'Browse worlds without a query. Use claworld_search_worlds when the user supplies topic, intent, hobby, location, or other keywords.',
       metadata: buildToolMetadata({
         category: 'world_discovery',
         usageNotes: [
-          'Compatibility-only wrapper around claworld_search_worlds with an empty query.',
-          'Prefer claworld_search_worlds unless an existing workflow explicitly asks for list_worlds.',
+          'This tool returns the no-query world browse result.',
+          'Use claworld_search_worlds when the user supplies topic, intent, hobby, location, or other keywords.',
         ],
         examples: [
           {

package/src/openclaw/plugin/relay-client.js

@@ -683,6 +683,7 @@ export class ClaworldRelayClient extends EventEmitter {
       const cleanup = () => {
         if (timeout) clearTimeout(timeout);
         this.off('reply.accepted', onReplyAccepted);
+        this.off('command.accepted', onCommandAccepted);
         this.off('disconnect', onDisconnect);
         this.off('close', onDisconnect);
       };
@@ -707,6 +708,20 @@ export class ClaworldRelayClient extends EventEmitter {
         settleResolve(message);
       };
 
+      const onCommandAccepted = (message = {}) => {
+        const command = message?.data?.command && typeof message.data.command === 'object'
+          ? message.data.command
+          : {};
+        if (normalizeOptionalText(command.name) !== 'delivery.reply.requested') return;
+        const commandDeliveryId = [
+          command.deliveryId,
+          command.aggregateId,
+          command.partitionKey,
+        ].map((value) => normalizeOptionalText(value)).find(Boolean) || null;
+        if (commandDeliveryId !== normalizedDeliveryId) return;
+        settleResolve(message);
+      };
+
       const onDisconnect = (info = {}) => {
         settleReject(createRuntimeBoundaryError({
           code: 'relay_reply_ack_disconnected',
@@ -725,6 +740,7 @@ export class ClaworldRelayClient extends EventEmitter {
       };
 
       this.on('reply.accepted', onReplyAccepted);
+      this.on('command.accepted', onCommandAccepted);
       this.on('disconnect', onDisconnect);
       this.on('close', onDisconnect);
 

package/src/openclaw/runtime/tool-contracts.js

@@ -589,7 +589,12 @@ function projectToolWorldBroadcastFailureItem(item = {}) {
 export function projectToolWorldBroadcastResponse(payload = {}, { accountId = null } = {}) {
   return {
     accountId: normalizeText(accountId, null),
+    accepted: payload.accepted === true,
     status: normalizeText(payload.status, null),
+    commandId: normalizeText(payload.commandId, null),
+    command: payload.command && typeof payload.command === 'object' && !Array.isArray(payload.command)
+      ? payload.command
+      : null,
     worldId: normalizeText(payload.worldId, null),
     senderAgentId: normalizeText(payload.senderAgentId, null),
     senderRole: projectWorldRole(payload.senderRole, null),
@@ -597,6 +602,7 @@ export function projectToolWorldBroadcastResponse(payload = {}, { accountId = nu
     excludeSelf: normalizeOptionalBoolean(payload.excludeSelf, null),
     eligibility: normalizeText(payload.eligibility, null),
     broadcastId: normalizeText(payload.broadcastId, null),
+    fanoutStatus: normalizeText(payload.fanoutStatus, null),
     totalTargets: normalizeOptionalInteger(payload.totalTargets, null),
     createdCount: normalizeOptionalInteger(payload.createdCount, null),
     failedCount: normalizeOptionalInteger(payload.failedCount, null),

package/src/openclaw/runtime/world-moderation-helper.js

@@ -167,7 +167,12 @@ function normalizeWorldBroadcastFailureItem(item = {}) {
 
 function normalizeWorldBroadcastResponse(payload = {}) {
   return {
+    accepted: payload.accepted === true,
     status: normalizeText(payload.status, null),
+    commandId: normalizeText(payload.commandId, null),
+    command: payload.command && typeof payload.command === 'object' && !Array.isArray(payload.command)
+      ? payload.command
+      : null,
     worldId: normalizeText(payload.worldId, null),
     senderAgentId: normalizeText(payload.senderAgentId, null),
     senderRole: normalizeWorldRole(payload.senderRole, null),
@@ -175,6 +180,7 @@ function normalizeWorldBroadcastResponse(payload = {}) {
     excludeSelf: normalizeOptionalBoolean(payload.excludeSelf, null),
     eligibility: normalizeText(payload.eligibility, null),
     broadcastId: normalizeText(payload.broadcastId, null),
+    fanoutStatus: normalizeText(payload.fanoutStatus, null),
     totalTargets: normalizeOptionalInteger(payload.totalTargets, null),
     createdCount: normalizeOptionalInteger(payload.createdCount, null),
     failedCount: normalizeOptionalInteger(payload.failedCount, null),
@@ -504,5 +510,9 @@ export async function broadcastModeratedWorld({
     });
   }
 
-  return normalizeWorldBroadcastResponse(result.body);
+  return normalizeWorldBroadcastResponse({
+    ...result.body,
+    worldId: resolvedWorldId,
+    senderAgentId: resolvedAgentId,
+  });
 }