@xfxstudio/claworld 2026.6.29-testing.1 → 2026.7.1-testing.1

package/README.md

@@ -74,12 +74,16 @@ Also re-run:
 
 ## Local Development
 
-For a repo checkout, materialize the package root first:
+For a repo checkout, install the plugin from the repository root:
 
 ```bash
-npm run build:plugin:package
-openclaw plugins install /absolute/path/to/packages/openclaw-plugin
+openclaw plugins install /absolute/path/to/claworld-openclaw-plugin
 ```
 
-If you change plugin code, rebuild the package root before reinstalling or
-retesting it in a real host.
+If you change plugin code, rerun the tests and reinstall the checkout before
+retesting it in a real host:
+
+```bash
+npm test
+openclaw plugins update @xfxstudio/claworld
+```

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.6.29-testing.1",
+  "version": "2026.7.1-testing.1",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",
@@ -20,11 +20,11 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Lightningxxl/claworld.git"
+    "url": "git+https://github.com/Lightningxxl/claworld-openclaw-plugin.git"
   },
-  "homepage": "https://github.com/Lightningxxl/claworld",
+  "homepage": "https://github.com/Lightningxxl/claworld-openclaw-plugin",
   "bugs": {
-    "url": "https://github.com/Lightningxxl/claworld/issues"
+    "url": "https://github.com/Lightningxxl/claworld-openclaw-plugin/issues"
   },
   "keywords": [
     "openclaw",
@@ -47,12 +47,21 @@
   "dependencies": {
     "ws": "^8.19.0"
   },
+  "devDependencies": {
+    "openclaw": "2026.4.9"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "scripts": {
-    "prepack": "node ../../scripts/build-openclaw-plugin-package.mjs --output-dir ."
+    "test": "node tests/run-all.js",
+    "test:unit": "node tests/run-all.js unit",
+    "check:package": "node scripts/check-package.mjs",
+    "pack:dry-run": "npm run check:package && npm pack --dry-run --json",
+    "publish:stable": "node scripts/publish-package.mjs --tag latest",
+    "publish:testing": "node scripts/publish-package.mjs --tag testing",
+    "prepack": "npm run check:package"
   },
   "openclaw": {
     "extensions": [

package/src/lib/chat-request.js

@@ -99,6 +99,24 @@ export function normalizeChatRequestOpeningPayload(input = null) {
   return Object.keys(payload).length > 0 ? payload : null;
 }
 
+function normalizeKickoffBriefInput(kickoffBrief = null) {
+  if (kickoffBrief && typeof kickoffBrief === 'object' && !Array.isArray(kickoffBrief)) {
+    return kickoffBrief;
+  }
+  const text = normalizeText(kickoffBrief, null);
+  return text ? { text } : null;
+}
+
+function resolveKickoffBriefOpeningMessage(kickoffBrief = null, fallback = null) {
+  if (!kickoffBrief || typeof kickoffBrief !== 'object' || Array.isArray(kickoffBrief)) {
+    return normalizeText(fallback, null);
+  }
+  return normalizeText(
+    kickoffBrief.text,
+    normalizeText(kickoffBrief.openingMessage, normalizeText(kickoffBrief.message, normalizeText(fallback, null))),
+  );
+}
+
 export function resolveChatRequestOpeningMessage({
   openingMessage = null,
   openingPayload = null,
@@ -119,12 +137,8 @@ function resolveKickoffBriefSource({
   const normalizedContext = requestContext && typeof requestContext === 'object' && !Array.isArray(requestContext)
     ? requestContext
     : {};
-  const explicitKickoffBrief = kickoffBrief && typeof kickoffBrief === 'object' && !Array.isArray(kickoffBrief)
-    ? kickoffBrief
-    : null;
-  const contextKickoffBrief = normalizedContext.kickoffBrief && typeof normalizedContext.kickoffBrief === 'object' && !Array.isArray(normalizedContext.kickoffBrief)
-    ? normalizedContext.kickoffBrief
-    : null;
+  const explicitKickoffBrief = normalizeKickoffBriefInput(kickoffBrief);
+  const contextKickoffBrief = normalizeKickoffBriefInput(normalizedContext.kickoffBrief);
   const fallbackSource = normalizeText(source, null) === 'world_broadcast'
     ? 'world_broadcast_brief'
     : 'chat_request_brief';
@@ -150,12 +164,8 @@ function resolveChatRequestKickoffBrief({
   const normalizedContext = requestContext && typeof requestContext === 'object' && !Array.isArray(requestContext)
     ? requestContext
     : {};
-  const explicitKickoffBrief = kickoffBrief && typeof kickoffBrief === 'object' && !Array.isArray(kickoffBrief)
-    ? kickoffBrief
-    : null;
-  const contextKickoffBrief = normalizedContext.kickoffBrief && typeof normalizedContext.kickoffBrief === 'object' && !Array.isArray(normalizedContext.kickoffBrief)
-    ? normalizedContext.kickoffBrief
-    : null;
+  const explicitKickoffBrief = normalizeKickoffBriefInput(kickoffBrief);
+  const contextKickoffBrief = normalizeKickoffBriefInput(normalizedContext.kickoffBrief);
   const normalizedOpeningPayload = normalizeChatRequestOpeningPayload(
     explicitKickoffBrief?.payload
     ?? contextKickoffBrief?.payload
@@ -163,10 +173,10 @@ function resolveChatRequestKickoffBrief({
     ?? normalizedContext.openingPayload,
   );
   const normalizedOpeningMessage = resolveChatRequestOpeningMessage({
-    openingMessage:
-      explicitKickoffBrief?.text
-      ?? contextKickoffBrief?.text
-      ?? openingMessage,
+    openingMessage: resolveKickoffBriefOpeningMessage(
+      explicitKickoffBrief,
+      resolveKickoffBriefOpeningMessage(contextKickoffBrief, openingMessage),
+    ),
     openingPayload: normalizedOpeningPayload,
     requestContext: normalizedContext,
   });

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

@@ -271,6 +271,46 @@ function isClaworldPlainObject(value) {
   return value && typeof value === 'object' && !Array.isArray(value);
 }
 
+function resolveClaworldOpeningMessage({
+  openingMessage = null,
+  message = null,
+  text = null,
+  kickoffBrief = null,
+  openingPayload = null,
+} = {}) {
+  const brief = isClaworldPlainObject(kickoffBrief) ? kickoffBrief : null;
+  return normalizeClaworldText(
+    openingMessage,
+    normalizeClaworldText(
+      message,
+      normalizeClaworldText(
+        text,
+        normalizeClaworldText(
+          typeof kickoffBrief === 'string' ? kickoffBrief : null,
+          normalizeClaworldText(
+            brief?.text,
+            normalizeClaworldText(
+              brief?.openingMessage,
+              normalizeClaworldText(brief?.message, normalizeClaworldText(openingPayload?.text, null)),
+            ),
+          ),
+        ),
+      ),
+    ),
+  );
+}
+
+function normalizeClaworldKickoffBriefInput(kickoffBrief = null, openingMessage = null) {
+  if (isClaworldPlainObject(kickoffBrief)) {
+    return {
+      ...kickoffBrief,
+      ...(!resolveClaworldOpeningMessage({ kickoffBrief }) && openingMessage ? { text: openingMessage } : {}),
+    };
+  }
+  const text = normalizeClaworldText(kickoffBrief, null);
+  return text ? { text } : null;
+}
+
 function resolveNormalizedText(value, fallback = null) {
   return normalizeClaworldText(value, fallback);
 }
@@ -894,6 +934,10 @@ async function createChatRequest({
   displayName = null,
   agentCode = null,
   openingMessage = null,
+  message = null,
+  text = null,
+  kickoffBrief = null,
+  openingPayload = null,
   worldId = null,
   requestContext = null,
   fetchImpl,
@@ -912,7 +956,15 @@ async function createChatRequest({
     });
   }
   const baseUrl = normalizeRelayHttpBaseUrl(runtimeConfig.serverUrl);
-  const normalizedOpeningMessage = normalizeClaworldText(openingMessage, null);
+  const normalizedOpeningPayload = isClaworldPlainObject(openingPayload) ? openingPayload : null;
+  const normalizedOpeningMessage = resolveClaworldOpeningMessage({
+    openingMessage,
+    message,
+    text,
+    kickoffBrief,
+    openingPayload: normalizedOpeningPayload,
+  });
+  const normalizedKickoffBrief = normalizeClaworldKickoffBriefInput(kickoffBrief, normalizedOpeningMessage);
   if (!normalizedOpeningMessage) {
     const message = 'openingMessage is required for chat request kickoff';
     throw createRuntimeBoundaryError({
@@ -951,6 +1003,8 @@ async function createChatRequest({
       displayName: normalizedDisplayName,
       agentCode: normalizedAgentCode,
       openingMessage: normalizedOpeningMessage,
+      ...(normalizedKickoffBrief ? { kickoffBrief: normalizedKickoffBrief } : {}),
+      ...(normalizedOpeningPayload ? { openingPayload: normalizedOpeningPayload } : {}),
       ...(normalizeClaworldText(worldId, null) ? { worldId: normalizeClaworldText(worldId, null) } : {}),
       ...(requestContext && typeof requestContext === 'object' && !Array.isArray(requestContext)
         ? { requestContext }
@@ -4553,6 +4607,10 @@ async function generateRuntimeProfileCard(context = {}) {
             displayName: context.displayName || null,
             agentCode: context.agentCode || null,
             openingMessage: context.openingMessage || context.message || context.text || null,
+            message: context.message || null,
+            text: context.text || null,
+            kickoffBrief: context.kickoffBrief || null,
+            openingPayload: context.openingPayload || null,
             worldId: context.worldId || null,
             requestContext,
             fetchImpl,

package/src/openclaw/plugin/register.js

@@ -201,6 +201,28 @@ function hasExplicitAction(params = {}) {
   return Object.prototype.hasOwnProperty.call(params, 'action') && normalizeText(params.action, null) != null;
 }
 
+function resolveConversationOpeningMessage(params = {}) {
+  const kickoffBrief = params?.kickoffBrief && typeof params.kickoffBrief === 'object' && !Array.isArray(params.kickoffBrief)
+    ? params.kickoffBrief
+    : null;
+  return normalizeText(
+    params?.openingMessage,
+    normalizeText(
+      params?.message,
+      normalizeText(
+        params?.text,
+        normalizeText(
+          typeof params?.kickoffBrief === 'string' ? params.kickoffBrief : null,
+          normalizeText(
+            kickoffBrief?.text,
+            normalizeText(kickoffBrief?.openingMessage, normalizeText(kickoffBrief?.message, normalizeText(params?.openingPayload?.text, null))),
+          ),
+        ),
+      ),
+    ),
+  );
+}
+
 function normalizeTerminalAccountAction(params = {}) {
   if (hasExplicitAction(params)) {
     const explicitAction = normalizeText(params.action, null);
@@ -1069,6 +1091,16 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
           displayName: stringParam({ description: 'Target public display name for request.', minLength: 1 }),
           agentCode: stringParam({ description: 'Target public agent code for request.', minLength: 1 }),
           openingMessage: stringParam({ description: 'Request/re-engagement kickoff message.', minLength: 1 }),
+          message: stringParam({ description: 'Alias for openingMessage on action=request.', minLength: 1 }),
+          text: stringParam({ description: 'Alias for openingMessage on action=request.', minLength: 1 }),
+          kickoffBrief: objectParam({
+            description: 'Structured request kickoff brief. text/openingMessage/message are accepted as opener aliases.',
+            properties: {
+              text: stringParam({ description: 'Request/re-engagement kickoff message.', minLength: 1 }),
+              openingMessage: stringParam({ description: 'Alias for kickoff brief text.', minLength: 1 }),
+              message: stringParam({ description: 'Alias for kickoff brief text.', minLength: 1 }),
+            },
+          }),
           worldId: worldIdProperty,
           direction: stringParam({
             description: 'Top-level alias for filters.direction on action=list_related/get_state.',
@@ -1778,6 +1810,28 @@ function buildRegisteredTools(api, plugin) {
             minLength: 1,
             examples: ['Hi, want to compare trail-running routes in Shanghai?'],
           }),
+          message: stringParam({
+            description: 'Alias for openingMessage.',
+            minLength: 1,
+          }),
+          text: stringParam({
+            description: 'Alias for openingMessage.',
+            minLength: 1,
+          }),
+          kickoffBrief: objectParam({
+            description: 'Structured request kickoff brief. text/openingMessage/message are accepted as opener aliases.',
+            properties: {
+              text: stringParam({ description: 'Request/re-engagement kickoff message.', minLength: 1 }),
+              openingMessage: stringParam({ description: 'Alias for kickoff brief text.', minLength: 1 }),
+              message: stringParam({ description: 'Alias for kickoff brief text.', minLength: 1 }),
+            },
+          }),
+          openingPayload: objectParam({
+            description: 'Optional structured opening payload. text is accepted as opener alias.',
+            properties: {
+              text: stringParam({ description: 'Request/re-engagement kickoff message.', minLength: 1 }),
+            },
+          }),
           worldId: worldIdProperty,
         },
         examples: [
@@ -1798,7 +1852,11 @@ function buildRegisteredTools(api, plugin) {
           ...context,
           displayName: params.displayName,
           agentCode: params.agentCode,
-          openingMessage: params.openingMessage || null,
+          openingMessage: resolveConversationOpeningMessage(params),
+          message: params.message || null,
+          text: params.text || null,
+          kickoffBrief: params.kickoffBrief || null,
+          openingPayload: params.openingPayload || null,
           worldId: params.worldId || null,
         });
         return buildToolResult(projectToolChatRequestMutationResponse(payload, { accountId: context.accountId }));

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

@@ -1427,10 +1427,21 @@ export class ClaworldRelayClient extends EventEmitter {
     });
   }
 
-  async createChatRequest({ fromAgentId, displayName, agentCode, requestContext = {} } = {}) {
+  async createChatRequest({
+    fromAgentId,
+    displayName,
+    agentCode,
+    kickoffBrief = null,
+    openingMessage = null,
+    openingPayload = null,
+    requestContext = {},
+  } = {}) {
     const normalized = normalizeChatRequestInput({ requestContext, source: 'direct_lookup' });
     const normalizedDisplayName = normalizeOptionalText(displayName);
     const normalizedAgentCode = normalizeOptionalText(agentCode)?.toUpperCase() || null;
+    const normalizedOpeningPayload = openingPayload && typeof openingPayload === 'object' && !Array.isArray(openingPayload)
+      ? openingPayload
+      : null;
     return await this.requestJson('/v1/chat-requests', {
       method: 'POST',
       headers: buildRuntimeAuthHeaders(this.runtimeConfig, { 'content-type': 'application/json' }),
@@ -1438,8 +1449,13 @@ export class ClaworldRelayClient extends EventEmitter {
         fromAgentId,
         ...(normalizedDisplayName ? { displayName: normalizedDisplayName } : {}),
         ...(normalizedAgentCode ? { agentCode: normalizedAgentCode } : {}),
-        kickoffBrief: normalized.kickoffBrief || null,
-        openingMessage: normalized.openingMessage || null,
+        kickoffBrief: kickoffBrief || normalized.kickoffBrief || null,
+        openingMessage:
+          normalizeOptionalText(openingMessage)
+          || normalizeOptionalText(normalized.openingMessage)
+          || normalizeOptionalText(normalizedOpeningPayload?.text)
+          || null,
+        ...(normalizedOpeningPayload ? { openingPayload: normalizedOpeningPayload } : {}),
         worldId: normalized.conversation?.worldId || null,
         requestContext: requestContext && typeof requestContext === 'object' && !Array.isArray(requestContext)
           ? requestContext
@@ -1564,6 +1580,7 @@ export class ClaworldRelayClient extends EventEmitter {
       fromAgentId,
       displayName,
       agentCode,
+      openingPayload: normalizedOpeningPayload,
       requestContext: normalizedRequestContext,
     });
     if (requestResult.status !== 201) {

package/src/openclaw/plugin-version.js

@@ -1,4 +1,3 @@
-import { readFileSync } from 'node:fs';
 import repoPackageJson from '../../package.json' with { type: 'json' };
 
 export const CLAWORLD_PLUGIN_PACKAGE_NAME = '@xfxstudio/claworld';
@@ -35,18 +34,6 @@ function resolveCurrentPluginVersion() {
     return repoVersion;
   }
 
-  try {
-    const publishSurfaceSource = readFileSync(
-      new URL('../../packages/openclaw-plugin/package.json', import.meta.url),
-      'utf8',
-    );
-    const publishSurfacePackageJson = JSON.parse(publishSurfaceSource);
-    const publishSurfaceVersion = normalizeClaworldPluginVersion(publishSurfacePackageJson?.version, null);
-    if (publishSurfacePackageJson?.name === CLAWORLD_PLUGIN_PACKAGE_NAME && publishSurfaceVersion) {
-      return publishSurfaceVersion;
-    }
-  } catch {}
-
   return repoVersion || '0.0.0';
 }