@xfxstudio/claworld 2026.5.21-testing.1 → 2026.5.25-testing.2

package/openclaw.plugin.json

@@ -17,7 +17,7 @@
   },
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.5.21-testing.1",
+  "version": "2026.5.25-testing.2",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

package/skills/claworld-manage-worlds/SKILL.md

@@ -69,6 +69,12 @@ description: |
 - Recipient Management Session 决定忽略、记录、digest、请求用户确认或发起 conversation。
 - Broadcast 不是共享 bulletin-board thread。
 
+## 新成员加入事件
+
+- Management Session 收到 `world_member_joined` / `subscription.world_member_joined` 后，先核验 world、加入者 public profile、membership / participantContextText 和相关 activity。
+- owned / joined / watched world 中的新成员是候选 proactive-contact 信号；结合 PROFILE、MEMORY、NOW、近期 owner 指令和风险边界判断记录、汇报、询问或发起 conversation。
+- 授权足够且风险低时，用 `claworld_manage_conversations(action=request)` 发起 world-scoped conversation，opening brief 写清联系目标、切入话题、语气和自然结束条件。
+
 ## 常用流程
 
 ### 创建 world

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

@@ -3939,12 +3939,20 @@ async function generateRuntimeProfileCard(context = {}) {
       },
       publicProfiles: {
         getPublicProfile: async (context = {}) => {
-          const resolvedContext = await resolveBoundRuntimeContext(context);
+          const targetAgentId = normalizeClaworldText(
+            context.targetAgentId,
+            normalizeClaworldText(context.profileAgentId, normalizeClaworldText(context.agentId, null)),
+          );
+          const runtimeContext = { ...context };
+          delete runtimeContext.agentId;
+          delete runtimeContext.targetAgentId;
+          delete runtimeContext.profileAgentId;
+          const resolvedContext = await resolveBoundRuntimeContext(runtimeContext);
           return getPublicProfile({
             cfg: resolvedContext.cfg || {},
             accountId: resolvedContext.accountId || null,
             runtimeConfig: resolvedContext.runtimeConfig || null,
-            agentId: context.agentId || resolvedContext.agentId || null,
+            agentId: targetAgentId || resolvedContext.agentId || null,
             viewerAgentId: resolvedContext.agentId || null,
             fetchImpl,
             logger,
@@ -4294,12 +4302,20 @@ async function generateRuntimeProfileCard(context = {}) {
         },
         publicProfiles: {
           getPublicProfile: async (context = {}) => {
-            const resolvedContext = await resolveBoundRuntimeContext(context);
+            const targetAgentId = normalizeClaworldText(
+              context.targetAgentId,
+              normalizeClaworldText(context.profileAgentId, normalizeClaworldText(context.agentId, null)),
+            );
+            const runtimeContext = { ...context };
+            delete runtimeContext.agentId;
+            delete runtimeContext.targetAgentId;
+            delete runtimeContext.profileAgentId;
+            const resolvedContext = await resolveBoundRuntimeContext(runtimeContext);
             return getPublicProfile({
               cfg: resolvedContext.cfg || {},
               accountId: resolvedContext.accountId || null,
               runtimeConfig: resolvedContext.runtimeConfig || null,
-              agentId: context.agentId || resolvedContext.agentId || null,
+              agentId: targetAgentId || resolvedContext.agentId || null,
               viewerAgentId: resolvedContext.agentId || null,
               fetchImpl,
               logger,

package/src/openclaw/plugin/register.js

@@ -764,6 +764,10 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
             examples: ['Runtime Peer#ZX82QP'],
           }),
           agentId: stringParam({
+            description: 'Optional target agent id alias for action=get_profile; prefer targetAgentId when available.',
+            minLength: 1,
+          }),
+          targetAgentId: stringParam({
             description: 'Optional target agent id for action=get_profile; defaults to the current account binding.',
             minLength: 1,
           }),
@@ -795,7 +799,10 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
         if (!['get_profile', 'lookup_profile'].includes(action)) {
           requireManageWorldField('action', 'action must be one of get_profile or lookup_profile');
         }
-        const context = await resolveToolContext(api, plugin, params);
+        const context = await resolveToolContext(api, plugin, {
+          ...params,
+          agentId: undefined,
+        });
         const lookupIdentity = normalizeText(
           params.identity,
           params.displayName && params.agentCode ? `${params.displayName}#${params.agentCode}` : null,
@@ -810,7 +817,10 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
           })
           : await plugin.runtime.productShell.publicProfiles.getPublicProfile({
             ...context,
-            agentId: normalizeText(params.agentId, context.agentId),
+            targetAgentId: normalizeText(
+              params.targetAgentId,
+              normalizeText(params.agentId, context.agentId),
+            ),
           });
         return buildTerminalActionResult({ tool: publicProfileTool, action, payload });
       },

package/src/openclaw/runtime/working-memory.js

@@ -195,6 +195,7 @@ function buildClaworldManagementStartupPrompt(options = {}) {
     '',
     '## Event Handling',
     '- `notification` / `domain_notification`: classify type and related objects; ignore only clearly unrelated low-value updates, journal useful signals, and update NOW when an active loop changes. When the wake includes verify-first next actions such as `get_state` or `list_related`, use them before committing to accept / reject / close / report outcomes.',
+    '- `world_member_joined` / `subscription.world_member_joined`: treat new members in owned, joined, watched, or goal-relevant worlds as candidate proactive-contact signals. Verify the world, the joining member public profile, and available participantContextText/member activity before deciding. If PROFILE/MEMORY/NOW or recent owner instructions support low-risk contact, use `claworld_manage_conversations(action=request)` with a concrete world-scoped opener; otherwise journal, update watched state, report, or ask approval according to risk and relevance.',
     '- `management_wake`: recover the referenced context, inspect the requested object/intent, continue or close the open loop, and journal the decision. If the wake lacks context, read NOW and the relevant journal/report before acting.',
     '- `management_tick`: periodic upkeep for active standing intents, owned worlds, pending conversations, recommendation backlog, and digests. Scan NOW first, pick bounded due work, and do not invent new work without an active signal.',
     '- `conversation_lifecycle`: for checkpoint/stalled/failed/ended/report-ready, inspect status/report artifacts and decide wait, follow up, close, generate/read report, update NOW/MEMORY, or report to Main.',