@xfxstudio/claworld 2026.4.14-testing.2 → 2026.4.16-testing.2

package/README.md

@@ -58,12 +58,12 @@ Also re-run:
 
 ## Local Development
 
-For a repo checkout, stage the publish artifact first:
+For a repo checkout, materialize the package root first:
 
 ```bash
 npm run build:plugin:package
-openclaw plugins install /absolute/path/to/.tmp/openclaw-plugin-package
+openclaw plugins install /absolute/path/to/packages/openclaw-plugin
 ```
 
-If you change plugin code, rebuild the staged package before reinstalling or
+If you change plugin code, rebuild the package root before reinstalling or
 retesting it in a real host.

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.4.14-testing.2",
+  "version": "2026.4.16-testing.2",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",
@@ -51,6 +51,9 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
+  "scripts": {
+    "prepack": "node ../../scripts/build-openclaw-plugin-package.mjs --output-dir ."
+  },
   "openclaw": {
     "extensions": [
       "./index.js"

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

@@ -87,7 +87,7 @@ function normalizePluginOptionalText(value) {
 function requireClientMessageId(value = null) {
   const normalized = normalizePluginOptionalText(value);
   if (!normalized) {
-    throw new Error('claworld outbound clientMessageId is required for POST /v1/messages');
+    throw new Error('claworld outbound clientMessageId is required for POST /v1/orchestration/messages');
   }
   return normalized;
 }
@@ -96,6 +96,8 @@ function buildGeneratedClientMessageId() {
   return `openclaw_manual_${randomUUID()}`;
 }
 
+const DEFAULT_RELAY_HTTP_TIMEOUT_MS = 15_000;
+
 function buildRelayAgentSummary(item = {}) {
   const normalizedAgentId = normalizeClaworldText(item?.agentId, null);
   return {
@@ -521,7 +523,7 @@ async function deliverRelayMessage({ runtimeConfig, to, text, fetchImpl, logger,
   const relaySessionKey = resolveRelaySessionKeyFromOutboundContext(outboundContext);
 
   const baseUrl = normalizeRelayHttpBaseUrl(runtimeConfig.serverUrl);
-  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/messages`, {
+  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/orchestration/messages`, {
     method: 'POST',
     headers: {
       'content-type': 'application/json',
@@ -908,8 +910,19 @@ function resolveRuntimeConfigSource(context = {}) {
 }
 
 async function fetchJson(fetchImpl, url, init = {}) {
+  const timeoutMs = Number.isFinite(Number(init?.timeoutMs))
+    ? Math.max(1, Number(init.timeoutMs))
+    : DEFAULT_RELAY_HTTP_TIMEOUT_MS;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(new Error('request_timeout')), timeoutMs);
+  if (typeof timeoutId?.unref === 'function') timeoutId.unref();
+  const requestInit = {
+    ...init,
+    signal: controller.signal,
+  };
+  delete requestInit.timeoutMs;
   try {
-    const response = await fetchImpl(url, init);
+    const response = await fetchImpl(url, requestInit);
     let body = null;
     try {
       body = await response.json();
@@ -923,15 +936,18 @@ async function fetchJson(fetchImpl, url, init = {}) {
       category: 'transport',
       status: 502,
       message: `fetch failed: ${error?.message || String(error)}`,
-      publicMessage: 'relay fetch failed',
-      recoverable: true,
-      context: {
-        fetchUrl: url,
-        fetchMethod: init?.method || 'GET',
-        fetchHeaders: init?.headers || null,
-      },
-      cause: error,
-    });
+        publicMessage: 'relay fetch failed',
+        recoverable: true,
+        context: {
+          fetchUrl: url,
+          fetchMethod: requestInit.method || 'GET',
+          fetchHeaders: requestInit.headers || null,
+          timeoutMs,
+        },
+        cause: error,
+      });
+  } finally {
+    clearTimeout(timeoutId);
   }
 }
 

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

@@ -50,7 +50,7 @@ export function normalizeOptionalText(value) {
 export function requireClientMessageId(value = null) {
   const normalized = normalizeOptionalText(value);
   if (!normalized) {
-    throw new Error('claworld relay clientMessageId is required for POST /v1/messages');
+    throw new Error('claworld relay clientMessageId is required for POST /v1/orchestration/messages');
   }
   return normalized;
 }

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

@@ -907,7 +907,7 @@ export class ClaworldRelayClient extends EventEmitter {
       replyText,
       source,
     });
-    const result = await this.requestJsonWithDeliveryVisibilityRetry(`/v1/deliveries/${encodeURIComponent(envelope.deliveryId)}/reply`, {
+    const result = await this.requestJsonWithDeliveryVisibilityRetry(`/v1/runtime-deliveries/${encodeURIComponent(envelope.deliveryId)}/reply`, {
       method: 'POST',
       headers: buildRuntimeAuthHeaders(this.runtimeConfig, { 'content-type': 'application/json' }),
       body: JSON.stringify({
@@ -929,7 +929,7 @@ export class ClaworldRelayClient extends EventEmitter {
 
   async acceptDeliveryHttp({ deliveryId, sessionKey = null, source = 'runtime_dispatch' } = {}) {
     const normalizedDeliveryId = normalizeOptionalText(deliveryId);
-    const result = await this.requestJsonWithDeliveryVisibilityRetry(`/v1/deliveries/${encodeURIComponent(normalizedDeliveryId)}/accepted`, {
+    const result = await this.requestJsonWithDeliveryVisibilityRetry(`/v1/runtime-deliveries/${encodeURIComponent(normalizedDeliveryId)}/accepted`, {
       method: 'POST',
       headers: buildRuntimeAuthHeaders(this.runtimeConfig, { 'content-type': 'application/json' }),
       body: JSON.stringify({
@@ -1130,7 +1130,7 @@ export class ClaworldRelayClient extends EventEmitter {
 
   async keepDeliverySilentHttp({ deliveryId, reason = null, source = 'openclaw-autochain' } = {}) {
     const normalizedDeliveryId = normalizeOptionalText(deliveryId);
-    const result = await this.requestJsonWithDeliveryVisibilityRetry(`/v1/deliveries/${encodeURIComponent(normalizedDeliveryId)}/kept-silent`, {
+    const result = await this.requestJsonWithDeliveryVisibilityRetry(`/v1/runtime-deliveries/${encodeURIComponent(normalizedDeliveryId)}/kept-silent`, {
       method: 'POST',
       headers: buildRuntimeAuthHeaders(this.runtimeConfig, { 'content-type': 'application/json' }),
       body: JSON.stringify({
@@ -1322,7 +1322,7 @@ export class ClaworldRelayClient extends EventEmitter {
 
   async deliverMessage({ fromAgentId, targetAgentId, clientMessageId = null, payload = {}, conversation = {} } = {}) {
     const resolvedClientMessageId = requireClientMessageId(clientMessageId);
-    const result = await this.requestJson('/v1/messages', {
+    const result = await this.requestJson('/v1/orchestration/messages', {
       method: 'POST',
       headers: buildRuntimeAuthHeaders(this.runtimeConfig, { 'content-type': 'application/json' }),
       body: JSON.stringify({ fromAgentId, targetAgentId, clientMessageId: resolvedClientMessageId, payload, conversation }),