@xfxstudio/claworld 0.2.24 → 2026.4.14-testing.1

package/src/openclaw/plugin/claworld-channel-plugin.js

@@ -1,5 +1,4 @@
 import { randomUUID } from 'node:crypto';
-import claworldPackageJson from '../../../package.json' with { type: 'json' };
 
 import {
   applyRuntimeIdentity,
@@ -34,10 +33,17 @@ import { createOutboundSessionBridge } from '../runtime/outbound-session-bridge.
 import { createCanonicalResultBuilder } from '../runtime/canonical-result-builder.js';
 import { createDemoSessionBootstrap } from '../runtime/demo-session-bootstrap.js';
 import {
+  broadcastModeratedWorld,
   createModeratedWorld,
   fetchOwnedWorlds,
   manageModeratedWorld,
 } from '../runtime/world-moderation-helper.js';
+import {
+  fetchWorldMembership,
+  fetchWorldMemberships,
+  leaveWorldMembership,
+  updateWorldMembershipProfile,
+} from '../runtime/world-membership-helper.js';
 import { submitFeedbackReport } from '../runtime/feedback-helper.js';
 import {
   buildWorldSelectionPrompt,
@@ -46,11 +52,16 @@ import {
   fetchWorldCandidateFeed,
   fetchWorldDetail,
   joinWorld,
+  searchWorldMembers,
+  searchWorlds,
   resolveWorldSelection,
   resolveWorldSelectionFlow,
 } from '../runtime/product-shell-helper.js';
 import { extractBackendErrorContext } from '../runtime/backend-error-context.js';
 import { getClaworldRuntime } from './runtime.js';
+import {
+  CLAWORLD_PLUGIN_CURRENT_VERSION,
+} from '../plugin-version.js';
 import {
   createRuntimeBoundaryError,
   normalizeRuntimeBoundaryError,
@@ -58,8 +69,6 @@ import {
 } from '../../lib/runtime-errors.js';
 import { PUBLIC_IDENTITY_STATUS } from '../../lib/public-identity.js';
 
-const CLAWORLD_PLUGIN_VERSION = claworldPackageJson.version;
-
 function normalizeRelayHttpBaseUrl(serverUrl) {
   const parsed = new URL(serverUrl);
   if (parsed.protocol === 'ws:') parsed.protocol = 'http:';
@@ -439,6 +448,10 @@ function buildRelayContinuationText({
   };
 }
 
+function isExactNoReplyToken(text) {
+  return String(text || '').trim() === 'NO_REPLY';
+}
+
 function resolveContinuationState(turnData = {}) {
   const continuation = turnData?.continuation;
   if (!continuation || typeof continuation !== 'object' || Array.isArray(continuation)) {
@@ -1618,7 +1631,11 @@ function createDeliveryReplyDispatcher({
       runtimeOutputSummary.relayContinuationPreview = safeContinuation.text
         ? previewRuntimeOutputText(safeContinuation.text)
         : null;
-      if (safeContinuation.text) {
+      if (safeContinuation.text && isExactNoReplyToken(safeContinuation.text)) {
+        runtimeOutputSummary.relayContinuationSource = 'no_reply_token';
+        runtimeOutputSummary.relayContinuationPreview = 'NO_REPLY';
+        await flushKeptSilent('no_reply_token');
+      } else if (safeContinuation.text) {
         await flushReply(safeContinuation.text);
       } else {
         const silentReason = resolveRelaySilentReason(runtimeOutputSummary, safeContinuation);
@@ -2603,7 +2620,7 @@ export function createClaworldChannelPlugin({
     return {
       ok: true,
       pluginId: 'claworld',
-      version: CLAWORLD_PLUGIN_VERSION,
+      version: CLAWORLD_PLUGIN_CURRENT_VERSION,
       defaultAccountId: null,
       accounts: accountSnapshots,
       relayClients: Object.fromEntries(
@@ -2752,7 +2769,7 @@ async function generateRuntimeProfileCard(context = {}) {
       docsPath: '/channels/claworld',
       docsLabel: 'claworld',
       blurb: 'Claworld relay channel backed by the Claworld backend.',
-      version: CLAWORLD_PLUGIN_VERSION,
+      version: CLAWORLD_PLUGIN_CURRENT_VERSION,
       forceAccountBinding: true,
     },
     onboarding: claworldOnboardingAdapter,
@@ -2976,6 +2993,20 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        searchWorlds: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return searchWorlds({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            query: context.query ?? context.queryText ?? null,
+            limit: context.limit ?? null,
+            sort: context.sort || null,
+            page: context.page ?? null,
+            fetchImpl,
+            logger,
+          });
+        },
         joinWorld: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return joinWorld({
@@ -2989,6 +3020,21 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        searchWorldMembers: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return searchWorldMembers({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            worldId: context.worldId || null,
+            agentId: resolvedContext.agentId || null,
+            query: context.query ?? context.queryText ?? null,
+            sort: context.sort || null,
+            limit: context.limit ?? null,
+            fetchImpl,
+            logger,
+          });
+        },
         fetchWorldCandidateFeed: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return fetchWorldCandidateFeed({
@@ -3031,6 +3077,7 @@ async function generateRuntimeProfileCard(context = {}) {
             agentId: resolvedContext.agentId || null,
             displayName: context.displayName || null,
             worldContextText: context.worldContextText || null,
+            participantContextText: context.participantContextText || null,
             enabled: typeof context.enabled === 'boolean' ? context.enabled : true,
             fetchImpl,
             logger,
@@ -3048,6 +3095,21 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        broadcastWorld: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return broadcastModeratedWorld({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            announcementText: context.announcementText || null,
+            audience: context.audience || null,
+            excludeSelf: Object.prototype.hasOwnProperty.call(context, 'excludeSelf') ? context.excludeSelf : null,
+            fetchImpl,
+            logger,
+          });
+        },
         manageWorld: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return manageModeratedWorld({
@@ -3065,6 +3127,60 @@ async function generateRuntimeProfileCard(context = {}) {
           });
         },
       },
+      membership: {
+        listWorldMemberships: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return fetchWorldMemberships({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            status: context.status || null,
+            includeInactive: context.includeInactive === true,
+            includeDisabled: context.includeDisabled !== false,
+            fetchImpl,
+            logger,
+          });
+        },
+        getWorldMembership: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return fetchWorldMembership({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            includeDisabled: context.includeDisabled !== false,
+            fetchImpl,
+            logger,
+          });
+        },
+        updateWorldMembershipProfile: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return updateWorldMembershipProfile({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            participantContextText: context.participantContextText || null,
+            fetchImpl,
+            logger,
+          });
+        },
+        leaveWorldMembership: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return leaveWorldMembership({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            fetchImpl,
+            logger,
+          });
+        },
+      },
     },
     runtime: {
       protocol,
@@ -3105,6 +3221,20 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        searchWorlds: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return searchWorlds({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            query: context.query ?? context.queryText ?? null,
+            limit: context.limit ?? null,
+            sort: context.sort || null,
+            page: context.page ?? null,
+            fetchImpl,
+            logger,
+          });
+        },
         joinWorld: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return joinWorld({
@@ -3118,6 +3248,21 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        searchWorldMembers: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return searchWorldMembers({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            worldId: context.worldId || null,
+            agentId: resolvedContext.agentId || null,
+            query: context.query ?? context.queryText ?? null,
+            sort: context.sort || null,
+            limit: context.limit ?? null,
+            fetchImpl,
+            logger,
+          });
+        },
         fetchWorldCandidateFeed: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return fetchWorldCandidateFeed({
@@ -3181,6 +3326,7 @@ async function generateRuntimeProfileCard(context = {}) {
               agentId: resolvedContext.agentId || null,
               displayName: context.displayName || null,
               worldContextText: context.worldContextText || null,
+              participantContextText: context.participantContextText || null,
               enabled: typeof context.enabled === 'boolean' ? context.enabled : true,
               fetchImpl,
               logger,
@@ -3198,6 +3344,21 @@ async function generateRuntimeProfileCard(context = {}) {
               logger,
             });
           },
+          broadcastWorld: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return broadcastModeratedWorld({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              announcementText: context.announcementText || null,
+              audience: context.audience || null,
+              excludeSelf: Object.prototype.hasOwnProperty.call(context, 'excludeSelf') ? context.excludeSelf : null,
+              fetchImpl,
+              logger,
+            });
+          },
           manageWorld: async (context = {}) => {
             const resolvedContext = await resolveBoundRuntimeContext(context);
             return manageModeratedWorld({
@@ -3215,6 +3376,60 @@ async function generateRuntimeProfileCard(context = {}) {
             });
           },
         },
+        membership: {
+          listWorldMemberships: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return fetchWorldMemberships({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              status: context.status || null,
+              includeInactive: context.includeInactive === true,
+              includeDisabled: context.includeDisabled !== false,
+              fetchImpl,
+              logger,
+            });
+          },
+          getWorldMembership: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return fetchWorldMembership({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              includeDisabled: context.includeDisabled !== false,
+              fetchImpl,
+              logger,
+            });
+          },
+          updateWorldMembershipProfile: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return updateWorldMembershipProfile({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              participantContextText: context.participantContextText || null,
+              fetchImpl,
+              logger,
+            });
+          },
+          leaveWorldMembership: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return leaveWorldMembership({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              fetchImpl,
+              logger,
+            });
+          },
+        },
       },
       createRelayClient: (options = {}) => relayClientFactory({ logger, inbound, outbound, protocol, ...options }),
     },

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

@@ -13,6 +13,8 @@ export const DEFAULT_CLAWORLD_AGENT_ID = 'main';
 export const DEFAULT_CLAWORLD_ACCOUNT_ID = 'claworld';
 export const DEFAULT_CLAWORLD_TOOL_PROFILE = 'default';
 export const DEFAULT_CLAWORLD_DM_SCOPE = 'per-channel-peer';
+export const DEFAULT_CLAWORLD_SESSION_RESET_MODE = 'idle';
+export const DEFAULT_CLAWORLD_SESSION_RESET_IDLE_MINUTES = 43200;
 export const DEFAULT_CLAWORLD_SESSION_TARGET = 'mainagent';
 export const DEFAULT_CLAWORLD_FALLBACK_TARGET = 'mainagent';
 export const CLAWORLD_PLUGIN_TOOL_ALLOW_ENTRY = 'claworld';
@@ -44,6 +46,13 @@ export function ensureObject(value) {
   return value;
 }
 
+function buildDefaultClaworldSessionResetOverride() {
+  return {
+    mode: DEFAULT_CLAWORLD_SESSION_RESET_MODE,
+    idleMinutes: DEFAULT_CLAWORLD_SESSION_RESET_IDLE_MINUTES,
+  };
+}
+
 function normalizeRegistrationDisplayName(value, fallback = null) {
   const normalized = normalizeText(value, fallback);
   return normalized || fallback;
@@ -713,6 +722,16 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
     config.session.dmScope = sessionDmScope;
     summary.push(`session.dmScope set to ${sessionDmScope}`);
   }
+  const resetByChannel = ensureObject(config.session.resetByChannel);
+  if (!Object.prototype.hasOwnProperty.call(resetByChannel, 'claworld')) {
+    config.session.resetByChannel = {
+      ...resetByChannel,
+      claworld: buildDefaultClaworldSessionResetOverride(),
+    };
+    summary.push(
+      `session.resetByChannel.claworld set to ${DEFAULT_CLAWORLD_SESSION_RESET_MODE}/${DEFAULT_CLAWORLD_SESSION_RESET_IDLE_MINUTES}m`,
+    );
+  }
 
   config.agents = ensureObject(config.agents);
   const existingAgentList = Array.isArray(config.agents.list) ? [...config.agents.list] : [];

package/src/openclaw/plugin/register-tooling.js

@@ -3,6 +3,9 @@ import {
   projectToolChatRequestMutationResponse,
   projectToolManagedWorldResponse,
   projectToolOwnedWorldsResponse,
+  projectToolWorldBroadcastResponse,
+  projectToolWorldMembershipListResponse,
+  projectToolWorldMembershipResponse,
 } from '../runtime/tool-contracts.js';
 import {
   buildPublicErrorPayload,
@@ -379,10 +382,15 @@ export function buildToolMetadata({
 export const MANAGE_WORLD_ACTIONS = Object.freeze([
   'list',
   'get',
+  'broadcast',
   'update_context',
   'pause',
   'close',
   'resume',
+  'list_memberships',
+  'get_membership',
+  'update_profile',
+  'leave',
 ]);
 
 export function normalizeManageWorldAction(value, fallback = null) {
@@ -394,7 +402,13 @@ export function inferManageWorldAction(params = {}) {
   const explicitAction = normalizeManageWorldAction(params.action, null);
   if (explicitAction) return explicitAction;
   if (!normalizeText(params.worldId, null)) return 'list';
-  if (normalizeText(params.worldContextText, null) || normalizeText(params.displayName, null)) {
+  if (normalizeText(params.announcementText, null)) return 'broadcast';
+  if (normalizeText(params.participantContextText, null)) return 'update_profile';
+  if (
+    normalizeText(params.worldContextText, null)
+    || normalizeText(params.displayName, null)
+    || normalizeObject(params.broadcast, null)
+  ) {
     return 'update_context';
   }
   return 'get';
@@ -420,6 +434,24 @@ export function projectToolManageWorldActionResponse(payload = {}, { accountId =
       ...projectToolOwnedWorldsResponse(payload, { accountId }),
     };
   }
+  if (resolvedAction === 'broadcast') {
+    return {
+      action: resolvedAction,
+      ...projectToolWorldBroadcastResponse(payload, { accountId }),
+    };
+  }
+  if (resolvedAction === 'list_memberships') {
+    return {
+      action: resolvedAction,
+      ...projectToolWorldMembershipListResponse(payload, { accountId }),
+    };
+  }
+  if (['get_membership', 'update_profile', 'leave'].includes(resolvedAction)) {
+    return {
+      action: resolvedAction,
+      ...projectToolWorldMembershipResponse(payload, { accountId }),
+    };
+  }
   return {
     action: resolvedAction,
     ...projectToolManagedWorldResponse(payload, { accountId }),
@@ -585,6 +617,31 @@ function projectToolChatRequestApprovalPolicy(payload = null) {
   };
 }
 
+function projectToolPluginVersionStatus(payload = null) {
+  const versionStatus = normalizeObject(payload, null);
+  if (!versionStatus) return null;
+
+  const warning = normalizeObject(versionStatus.warning, null);
+  return {
+    reportedVersion: normalizeText(versionStatus.reportedVersion, null),
+    minSupportedVersion: normalizeText(versionStatus.minSupportedVersion, null),
+    latestVersion: normalizeText(versionStatus.latestVersion, null),
+    compatible: typeof versionStatus.compatible === 'boolean' ? versionStatus.compatible : null,
+    status: normalizeText(versionStatus.status, 'unknown'),
+    upgradeCommand: normalizeText(versionStatus.upgradeCommand, null),
+    message: normalizeText(versionStatus.message, null),
+    ...(warning
+      ? {
+          warning: {
+            level: normalizeText(warning.level, null),
+            code: normalizeText(warning.code, null),
+            message: normalizeText(warning.message, null),
+          },
+        }
+      : {}),
+  };
+}
+
 export function projectToolAccountViewResponse({
   accountId = null,
   pairingPayload = null,
@@ -622,6 +679,7 @@ export function projectToolAccountViewResponse({
     },
     profile: projectToolAccountProfile(identityPayload),
     ...projectToolAccountIdentityFields(identityPayload),
+    pluginVersionStatus: projectToolPluginVersionStatus(identityPayload?.pluginVersionStatus),
     chatRequestApprovalPolicy: projectToolChatRequestApprovalPolicy(identityPayload?.chatRequestApprovalPolicy),
     ...(resolvedShareCard !== undefined ? { shareCard: resolvedShareCard } : {}),
   };
@@ -647,6 +705,7 @@ export function projectToolAccountMutationResponse({
     accountId: normalizeText(accountId, null),
     profile: projectToolAccountProfile(identityPayload),
     ...projectToolAccountIdentityFields(identityPayload),
+    pluginVersionStatus: projectToolPluginVersionStatus(identityPayload?.pluginVersionStatus),
     chatRequestApprovalPolicy: projectToolChatRequestApprovalPolicy(identityPayload?.chatRequestApprovalPolicy),
     ...(resolvedShareCard !== undefined ? { shareCard: resolvedShareCard } : {}),
     ...(runtimeActivation ? { runtimeActivation } : {}),