@xfxstudio/claworld 2026.4.28-testing → 2026.4.28-testing.1

package/openclaw.plugin.json

@@ -8,7 +8,7 @@
   ],
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.4.28-testing",
+  "version": "2026.4.28-testing.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

package/skills/claworld-help/SKILL.md

@@ -27,12 +27,12 @@ description: |
 
 对应 public tool 是 `claworld_manage_account`。除非已经明确是插件未安装 / channel 未添加 / bind 未建立，不要一上来跑 CLI。
 
-## Account / Policy / Feedback 工具
+## Account / Policy 工具与反馈路径
 
 - `claworld_manage_account(action=view_account)`：主诊断入口。
 - `claworld_manage_account(action=activate_account|update_display_name|update_human_profile|update_agent_profile)`：身份与 profile 初始化。
 - `claworld_manage_account(action=set_discoverability|set_contactability|set_chat_policy|set_proactivity)`：账户级策略。
-- `claworld_submit_feedback`：结构化产品/runtime 反馈；diagnostics 由 helper 自动补齐。
+- 结构化产品/runtime 反馈通过 Claworld runtime feedback helper / backend route 提交；它不是 Agent-facing terminal public tool，diagnostics 由 helper 自动补齐。
 
 ## 插件生命周期规则
 
@@ -94,7 +94,7 @@ openclaw gateway restart
 
 ## 反馈
 
-如果确认是产品/runtime 缺口，而不是操作问题，提交 `claworld_submit_feedback`。
+如果确认是产品/runtime 缺口，而不是操作问题，通过 Claworld runtime feedback helper / backend route 提交结构化反馈；不要调用或恢复任何 Agent-facing terminal public feedback tool。
 
 必填：
 

package/src/openclaw/index.js

@@ -70,8 +70,6 @@ export {
   resolveWorldSelection,
   fetchWorldDetail,
   joinWorld,
-  fetchWorldCandidateFeed,
-  buildCandidateDeliverySummary,
   resolveWorldSelectionFlow,
 } from './runtime/product-shell-helper.js';
 export { submitFeedbackReport } from './runtime/feedback-helper.js';

package/src/openclaw/plugin/account-identity.js

@@ -13,16 +13,13 @@ export function normalizeRuntimeRegistration(candidate = {}) {
   const registration = candidate.registration && typeof candidate.registration === 'object'
     ? candidate.registration
     : {};
-  const legacyLocalAgent = candidate.localAgent && typeof candidate.localAgent === 'object'
-    ? candidate.localAgent
-    : {};
-  const enabled = registration.enabled === true || legacyLocalAgent.enabled === true;
+  const enabled = registration.enabled === true;
 
   if (!enabled) return { enabled: false };
 
   return {
     enabled: true,
-    displayName: normalizeText(registration.displayName, normalizeText(legacyLocalAgent.displayName, null)),
+    displayName: normalizeText(registration.displayName, null),
   };
 }
 

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

@@ -35,8 +35,11 @@ import { createDemoSessionBootstrap } from '../runtime/demo-session-bootstrap.js
 import {
   broadcastModeratedWorld,
   createModeratedWorld,
+  fetchModeratedWorldInvites,
   fetchOwnedWorlds,
+  inviteModeratedWorldMember,
   manageModeratedWorld,
+  revokeModeratedWorldInvite,
 } from '../runtime/world-moderation-helper.js';
 import {
   fetchWorldMembership,
@@ -47,11 +50,11 @@ import {
 import { submitFeedbackReport } from '../runtime/feedback-helper.js';
 import {
   buildWorldSelectionPrompt,
-  buildCandidateDeliverySummary,
   buildPostSetupWorldDirectory,
-  fetchWorldCandidateFeed,
   fetchWorldDetail,
+  getPublicProfile,
   joinWorld,
+  lookupPublicProfile,
   search,
   searchWorldMembers,
   searchWorlds,
@@ -809,6 +812,48 @@ async function rejectChatRequest({
   return result.body || {};
 }
 
+async function closeConversation({
+  runtimeConfig,
+  actorAgentId,
+  conversationKey = null,
+  localSessionKey = null,
+  localAgentId = null,
+  fetchImpl,
+}) {
+  const relayLocalSessionKey = stripAgentScopedLocalSessionKey({
+    sessionKey: localSessionKey,
+    localAgentId,
+  });
+  const baseUrl = normalizeRelayHttpBaseUrl(runtimeConfig.serverUrl);
+  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/chat-requests/conversations/close`, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+      ...(runtimeConfig.apiKey ? { 'x-api-key': runtimeConfig.apiKey } : {}),
+      ...buildRuntimeAuthHeaders(runtimeConfig),
+    },
+    body: JSON.stringify({
+      actorAgentId,
+      ...(normalizeClaworldText(conversationKey, null) ? { conversationKey: normalizeClaworldText(conversationKey, null) } : {}),
+      ...(normalizeClaworldText(relayLocalSessionKey, null) ? { localSessionKey: normalizeClaworldText(relayLocalSessionKey, null) } : {}),
+    }),
+  });
+  if (!result.ok) {
+    createRelayRouteError({
+      result,
+      runtimeConfig,
+      code: 'conversation_close_failed',
+      publicMessage: 'failed to close conversation',
+      context: {
+        actorAgentId,
+        conversationKey: normalizeClaworldText(conversationKey, null),
+        localSessionKey: relayLocalSessionKey,
+      },
+    });
+  }
+  return normalizeChatInboxPayloadSessionKeys(result.body || {}, { localAgentId });
+}
+
 function waitForAbort(signal) {
   return new Promise((resolve) => {
     if (!signal) return resolve({ reason: 'missing_abort_signal' });
@@ -1313,7 +1358,7 @@ async function resolveRelayAgentSummary({
 
   return {
     agentId: normalizedAgentId,
-    displayName: normalizeClaworldText(runtimeConfig.registration?.displayName, normalizeClaworldText(runtimeConfig.localAgent?.displayName, null)),
+    displayName: normalizeClaworldText(runtimeConfig.registration?.displayName, null),
     publicIdentity: null,
     discoverable: null,
     contactable: null,
@@ -1628,7 +1673,7 @@ async function fetchRuntimeWorldMembers({
   }
   const baseUrl = normalizeRelayHttpBaseUrl(runtimeConfig.serverUrl);
   const requestUrl = new URL(`${baseUrl}/v1/worlds/${encodeURIComponent(normalizedWorldId)}/memberships`);
-  if (agentId) requestUrl.searchParams.set('agentId', agentId);
+  if (agentId) requestUrl.searchParams.set('actorAgentId', agentId);
   if (status) requestUrl.searchParams.set('status', status);
   const normalizedLimit = normalizeClaworldInteger(limit, null);
   if (normalizedLimit > 0) requestUrl.searchParams.set('limit', String(normalizedLimit));
@@ -3303,6 +3348,17 @@ async function generateRuntimeProfileCard(context = {}) {
             fetchImpl,
           });
         },
+        closeConversation: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return closeConversation({
+            runtimeConfig: resolvedContext.runtimeConfig,
+            actorAgentId: resolvedContext.agentId || null,
+            conversationKey: context.conversationKey || null,
+            localSessionKey: context.localSessionKey || null,
+            localAgentId: resolveContextBoundLocalAgentId(resolvedContext),
+            fetchImpl,
+          });
+        },
       },
       profile: {
         getPublicIdentity: getRuntimePublicIdentity,
@@ -3363,6 +3419,13 @@ async function generateRuntimeProfileCard(context = {}) {
             accountId: resolvedContext.accountId || null,
             runtimeConfig: resolvedContext.runtimeConfig || null,
             query: context.query ?? context.queryText ?? null,
+            keywords: context.keywords || [],
+            topics: context.topics || [],
+            location: context.location || null,
+            timeWindow: context.timeWindow || null,
+            intent: context.intent || null,
+            desiredInteraction: context.desiredInteraction || null,
+            constraints: context.constraints || [],
             limit: context.limit ?? null,
             sort: context.sort || null,
             page: context.page ?? null,
@@ -3392,30 +3455,23 @@ async function generateRuntimeProfileCard(context = {}) {
             worldId: context.worldId || null,
             agentId: resolvedContext.agentId || null,
             query: context.query ?? context.queryText ?? null,
+            keywords: context.keywords || [],
+            topics: context.topics || [],
+            location: context.location || null,
+            timeWindow: context.timeWindow || null,
+            intent: context.intent || null,
+            desiredInteraction: context.desiredInteraction || null,
+            constraints: context.constraints || [],
             sort: context.sort || null,
             limit: context.limit ?? null,
             fetchImpl,
             logger,
           });
         },
-        fetchWorldCandidateFeed: async (context = {}) => {
-          const resolvedContext = await resolveBoundRuntimeContext(context);
-          return fetchWorldCandidateFeed({
-            cfg: resolvedContext.cfg || {},
-            accountId: resolvedContext.accountId || null,
-            runtimeConfig: resolvedContext.runtimeConfig || null,
-            worldId: context.worldId || null,
-            agentId: resolvedContext.agentId || null,
-            limit: context.limit ?? context.candidateLimit ?? null,
-            fetchImpl,
-            logger,
-          });
-        },
         resolveWorldSelection: (context = {}) => resolveWorldSelection(
           context.worldDirectory || {},
           context.selection ?? context.userChoice ?? null,
         ),
-        buildCandidateDeliverySummary,
         resolveWorldSelectionFlow: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return resolveWorldSelectionFlow({
@@ -3464,6 +3520,32 @@ async function generateRuntimeProfileCard(context = {}) {
           });
         },
       },
+      publicProfiles: {
+        getPublicProfile: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return getPublicProfile({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: context.agentId || resolvedContext.agentId || null,
+            viewerAgentId: resolvedContext.agentId || null,
+            fetchImpl,
+            logger,
+          });
+        },
+        lookupPublicProfile: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return lookupPublicProfile({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            identity: context.identity || null,
+            viewerAgentId: resolvedContext.agentId || null,
+            fetchImpl,
+            logger,
+          });
+        },
+      },
       activity: {
         listWorldActivity: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
@@ -3488,6 +3570,10 @@ async function generateRuntimeProfileCard(context = {}) {
             worldContextText: context.worldContextText || null,
             participantContextText: context.participantContextText || null,
             enabled: typeof context.enabled === 'boolean' ? context.enabled : true,
+            visibility: context.visibility || null,
+            identityMode: context.identityMode || null,
+            joinPolicy: context.joinPolicy || null,
+            approvalPolicy: context.approvalPolicy || null,
             fetchImpl,
             logger,
           });
@@ -3535,6 +3621,47 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        inviteMember: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return inviteModeratedWorldMember({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            targetAgentId: context.targetAgentId || null,
+            identity: context.identity || null,
+            inviteMessage: context.inviteMessage || null,
+            fetchImpl,
+            logger,
+          });
+        },
+        revokeInvite: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return revokeModeratedWorldInvite({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            targetAgentId: context.targetAgentId || null,
+            fetchImpl,
+            logger,
+          });
+        },
+        listInvites: async (context = {}) => {
+          const resolvedContext = await resolveBoundRuntimeContext(context);
+          return fetchModeratedWorldInvites({
+            cfg: resolvedContext.cfg || {},
+            accountId: resolvedContext.accountId || null,
+            runtimeConfig: resolvedContext.runtimeConfig || null,
+            agentId: resolvedContext.agentId || null,
+            worldId: context.worldId || null,
+            status: context.status || 'invited',
+            fetchImpl,
+            logger,
+          });
+        },
       },
       membership: {
         listWorldMembers: async (context = {}) => {
@@ -3685,6 +3812,13 @@ async function generateRuntimeProfileCard(context = {}) {
             worldId: context.worldId || null,
             agentId: resolvedContext.agentId || null,
             query: context.query ?? context.queryText ?? null,
+            keywords: context.keywords || [],
+            topics: context.topics || [],
+            location: context.location || null,
+            timeWindow: context.timeWindow || null,
+            intent: context.intent || null,
+            desiredInteraction: context.desiredInteraction || null,
+            constraints: context.constraints || [],
             limit: context.limit ?? null,
             sort: context.sort || null,
             page: context.page ?? null,
@@ -3714,27 +3848,20 @@ async function generateRuntimeProfileCard(context = {}) {
             worldId: context.worldId || null,
             agentId: resolvedContext.agentId || null,
             query: context.query ?? context.queryText ?? null,
+            keywords: context.keywords || [],
+            topics: context.topics || [],
+            location: context.location || null,
+            timeWindow: context.timeWindow || null,
+            intent: context.intent || null,
+            desiredInteraction: context.desiredInteraction || null,
+            constraints: context.constraints || [],
             sort: context.sort || null,
             limit: context.limit ?? null,
             fetchImpl,
             logger,
           });
         },
-        fetchWorldCandidateFeed: async (context = {}) => {
-          const resolvedContext = await resolveBoundRuntimeContext(context);
-          return fetchWorldCandidateFeed({
-            cfg: resolvedContext.cfg || {},
-            accountId: resolvedContext.accountId || null,
-            runtimeConfig: resolvedContext.runtimeConfig || null,
-            worldId: context.worldId || null,
-            agentId: resolvedContext.agentId || null,
-            limit: context.limit ?? context.candidateLimit ?? null,
-            fetchImpl,
-            logger,
-          });
-        },
         resolveWorldSelection,
-        buildCandidateDeliverySummary,
         resolveWorldSelectionFlow: async (context = {}) => {
           const resolvedContext = await resolveBoundRuntimeContext(context);
           return resolveWorldSelectionFlow({
@@ -3748,6 +3875,32 @@ async function generateRuntimeProfileCard(context = {}) {
             logger,
           });
         },
+        publicProfiles: {
+          getPublicProfile: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return getPublicProfile({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: context.agentId || resolvedContext.agentId || null,
+              viewerAgentId: resolvedContext.agentId || null,
+              fetchImpl,
+              logger,
+            });
+          },
+          lookupPublicProfile: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return lookupPublicProfile({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              identity: context.identity || null,
+              viewerAgentId: resolvedContext.agentId || null,
+              fetchImpl,
+              logger,
+            });
+          },
+        },
         subscriptions: {
           listSubscriptions: async (context = {}) => {
             const resolvedContext = await resolveBoundRuntimeContext(context);
@@ -3832,6 +3985,10 @@ async function generateRuntimeProfileCard(context = {}) {
               worldContextText: context.worldContextText || null,
               participantContextText: context.participantContextText || null,
               enabled: typeof context.enabled === 'boolean' ? context.enabled : true,
+              visibility: context.visibility || null,
+              identityMode: context.identityMode || null,
+              joinPolicy: context.joinPolicy || null,
+              approvalPolicy: context.approvalPolicy || null,
               fetchImpl,
               logger,
             });
@@ -3879,6 +4036,47 @@ async function generateRuntimeProfileCard(context = {}) {
               logger,
             });
           },
+          inviteMember: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return inviteModeratedWorldMember({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              targetAgentId: context.targetAgentId || null,
+              identity: context.identity || null,
+              inviteMessage: context.inviteMessage || null,
+              fetchImpl,
+              logger,
+            });
+          },
+          revokeInvite: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return revokeModeratedWorldInvite({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              targetAgentId: context.targetAgentId || null,
+              fetchImpl,
+              logger,
+            });
+          },
+          listInvites: async (context = {}) => {
+            const resolvedContext = await resolveBoundRuntimeContext(context);
+            return fetchModeratedWorldInvites({
+              cfg: resolvedContext.cfg || {},
+              accountId: resolvedContext.accountId || null,
+              runtimeConfig: resolvedContext.runtimeConfig || null,
+              agentId: resolvedContext.agentId || null,
+              worldId: context.worldId || null,
+              status: context.status || 'invited',
+              fetchImpl,
+              logger,
+            });
+          },
         },
         membership: {
           listWorldMembers: async (context = {}) => {

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

@@ -647,10 +647,7 @@ export function resolveClaworldManagedRuntimeOptions({
   const name = normalizeText(overrides.name, normalizeText(existingBackup.name, displayName));
   const existingRegistrationDisplayName = normalizeRegistrationDisplayName(
     existingAccount?.registration?.displayName,
-    normalizeRegistrationDisplayName(
-      existingAccount?.localAgent?.displayName,
-      normalizeRegistrationDisplayName(existingBackup.registrationDisplayName, null),
-    ),
+    normalizeRegistrationDisplayName(existingBackup.registrationDisplayName, null),
   );
   const registrationDisplayName = appToken && !explicitRegistrationDisplayName
     ? null

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

@@ -409,6 +409,10 @@ export function inferManageWorldAction(params = {}) {
     normalizeText(params.worldContextText, null)
     || normalizeText(params.displayName, null)
     || normalizeObject(params.broadcast, null)
+    || normalizeText(params.visibility, null)
+    || normalizeText(params.identityMode, null)
+    || normalizeText(params.joinPolicy, null)
+    || normalizeText(params.approvalPolicy, null)
   ) {
     return 'update_context';
   }