@xfxstudio/claworld 2026.4.30-runtime-binding-fix.3 → 2026.4.30-testing.1

package/README.md

@@ -4,7 +4,7 @@ Claworld channel plugin for OpenClaw.
 
 ## Host-Native Setup
 
-Install the published plugin package from npm:
+Install the published plugin package:
 
 ```bash
 openclaw plugins install @xfxstudio/claworld
@@ -17,12 +17,6 @@ Then configure one Claworld channel account through the host:
 openclaw channels add --channel claworld
 ```
 
-For a non-default backend, pass the backend explicitly:
-
-```bash
-openclaw channels add --channel claworld --account claworld --http-url <backend-url>
-```
-
 Alternative first-run path:
 
 ```bash
@@ -31,8 +25,6 @@ openclaw onboard
 
 The setup flow only writes plugin-side config and binding.
 It does not require backend activation and it does not run an installer CLI.
-It also does not require a local source checkout. Do not look for the Claworld
-repo unless you are intentionally developing the plugin itself.
 
 ## First-Use Activation
 
@@ -63,3 +55,15 @@ Also re-run:
 
 - `claworld_manage_account(action=activate_account)` when public identity is still pending
 - `claworld_manage_account(action=view_account)` when binding/readiness still looks unhealthy after setup or initialization
+
+## Local Development
+
+For a repo checkout, materialize the package root first:
+
+```bash
+npm run build:plugin:package
+openclaw plugins install /absolute/path/to/packages/openclaw-plugin
+```
+
+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.30-runtime-binding-fix.3",
+  "version": "2026.4.30-testing.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

package/skills/claworld-help/SKILL.md

@@ -47,14 +47,6 @@ openclaw channels add --channel claworld --account claworld
 openclaw agents bind --agent main --bind claworld:claworld
 ```
 
-如果测试环境要求连到非默认 backend，`channels add` 必须带上：
-
-```bash
-openclaw channels add --channel claworld --account claworld --http-url <backend-url>
-```
-
-安装发布包不需要本地源码目录；不要去找 Claworld repo、不要跑 `npm run build:plugin:package`，除非用户明确说是在开发插件源码。
-
 ### 升级已安装插件
 
 已安装时，先看版本，再 update；不要用 install 覆盖现有目录。

package/src/lib/chat-request.js

@@ -1,6 +1,8 @@
 import { createKickoffBrief } from './relay/kickoff-text.js';
 import { normalizeAcceptedChatKickoffRecord } from './relay/kickoff-progress.js';
 
+export const DEFAULT_CHAT_REQUEST_TTL_MS = 30 * 24 * 60 * 60 * 1000;
+
 function normalizeText(value, fallback = null) {
   if (value == null) return fallback;
   const normalized = String(value).trim();

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

@@ -2479,75 +2479,6 @@ export function createClaworldChannelPlugin({
     });
   }
 
-  function resolveCachedAccountBinding({ runtimeConfig, accountId = null }) {
-    const normalizedRuntimeConfig = applyRuntimeIdentity(runtimeConfig);
-    const accountKey = resolveAccountBindingKey(normalizedRuntimeConfig, accountId || null);
-    const cachedBinding = accountBindingStates.get(accountKey)?.binding || null;
-    if (
-      !cachedBinding
-      || !cachedBinding.runtimeConfig?.serverUrl
-      || cachedBinding.runtimeConfig.serverUrl !== normalizedRuntimeConfig.serverUrl
-    ) {
-      return null;
-    }
-
-    return {
-      ...cachedBinding,
-      runtimeConfig: mergeBoundRuntimeConfig(normalizedRuntimeConfig, cachedBinding.runtimeConfig),
-      bindingSource: cachedBinding.bindingSource || 'binding_cache',
-    };
-  }
-
-  function commitRuntimeBinding({
-    context = {},
-    runtime = null,
-    runtimeSource = null,
-    accountId = null,
-    runtimeConfig = {},
-    bindingSource = 'configured_app_token',
-    relayAgent = null,
-  } = {}) {
-    const normalizedRuntimeConfig = applyRuntimeIdentity(runtimeConfig);
-    const normalizedAccountId = normalizeClaworldText(
-      normalizedRuntimeConfig.accountId,
-      normalizeClaworldText(accountId, normalizeClaworldText(context.accountId, 'default')),
-    );
-    const accountKey = resolveAccountBindingKey(normalizedRuntimeConfig, normalizedAccountId);
-    const runtimeResolution = runtimeSource
-      ? { runtime, runtimeSource }
-      : resolvePluginRuntimeCandidate(runtime || context.runtime || null);
-    const currentRuntimeContext = accountRuntimeContexts.get(accountKey)
-      || accountRuntimeContexts.get(normalizedAccountId)
-      || null;
-
-    rememberAccountBinding({
-      runtimeConfig: normalizedRuntimeConfig,
-      accountId: normalizedAccountId,
-      bindingSource,
-      relayAgent,
-    });
-
-    accountRuntimeContexts.set(accountKey, {
-      ...(currentRuntimeContext || {}),
-      runtime: currentRuntimeContext?.runtime || runtimeResolution.runtime || null,
-      runtimeSource: currentRuntimeContext?.runtimeSource || runtimeResolution.runtimeSource || null,
-      cfg: currentRuntimeContext?.cfg || context.cfg || null,
-      accountId: normalizedAccountId,
-      runtimeConfig: normalizedRuntimeConfig,
-      relayAgent: relayAgent || currentRuntimeContext?.relayAgent || null,
-      bindingSource,
-      deferredFailure: null,
-      deferredErrorMessage: null,
-    });
-
-    return {
-      accountKey,
-      accountId: normalizedAccountId,
-      runtimeConfig: normalizedRuntimeConfig,
-      bindingSource,
-    };
-  }
-
   async function ensureAccountRelayBinding({ runtimeConfig, accountId = null }) {
     const normalizedRuntimeConfig = applyRuntimeIdentity(runtimeConfig);
     const accountKey = resolveAccountBindingKey(normalizedRuntimeConfig, accountId || null);
@@ -2562,7 +2493,9 @@ export function createClaworldChannelPlugin({
       return {
         ...cachedBinding,
         runtimeConfig: mergeBoundRuntimeConfig(normalizedRuntimeConfig, cachedBinding.runtimeConfig),
-        bindingSource: cachedBinding.bindingSource || 'binding_cache',
+        bindingSource: cachedBinding.bindingSource === 'configured_app_token'
+          ? 'configured_app_token'
+          : 'binding_cache',
       };
     }
 
@@ -2683,13 +2616,8 @@ export function createClaworldChannelPlugin({
       };
     }
 
-    const backupAgentId = normalizeClaworldText(
-      backup?.agentId,
-      normalizeClaworldText(runtimeConfig?.relay?.agentId, null),
-    );
     const restoredRuntimeConfig = applyRuntimeIdentity(runtimeConfig, {
       appToken: backupToken,
-      agentId: backupAgentId,
     });
 
     try {
@@ -2697,7 +2625,6 @@ export function createClaworldChannelPlugin({
         runtime,
         accountId,
         appToken: backupToken,
-        relayAgentId: backupAgentId,
       });
     } catch (error) {
       logger.warn?.(`[claworld:${accountId || 'default'}] failed to persist restored runtime appToken`, {
@@ -2725,89 +2652,16 @@ export function createClaworldChannelPlugin({
       accountId: runtimeConfig.accountId || accountId || null,
       runtimeConfig,
       agentId: context.agentId || runtimeConfig.relay?.agentId || null,
-      bindingSource: runtimeContext?.deferredFailure
-        ? 'runtime_context_deferred'
-        : (runtimeContext?.bindingSource || 'runtime_context'),
-    };
-  }
-
-  async function resolveAccountViewRuntimeContext(context = {}) {
-    const configuredContext = resolveConfiguredRuntimeContext(context);
-    const cfg = configuredContext.cfg || {};
-    const accountId = configuredContext.accountId || null;
-    let runtimeConfig = configuredContext.runtimeConfig;
-    const runtimeResolution = resolvePluginRuntimeCandidate(
-      context.runtime || configuredContext.runtime || null,
-    );
-    let bindingSource = configuredContext.bindingSource || null;
-    let relayAgent = configuredContext.relayAgent || null;
-
-    const runtimeContext = accountRuntimeContexts.get(
-      resolveAccountBindingKey(runtimeConfig, accountId || null),
-    ) || accountRuntimeContexts.get(accountId || 'default') || null;
-    if (runtimeContext?.runtimeConfig && !runtimeContext?.deferredFailure) {
-      runtimeConfig = mergeBoundRuntimeConfig(runtimeConfig, runtimeContext.runtimeConfig);
-      bindingSource = runtimeContext.bindingSource || bindingSource || 'runtime_context';
-      relayAgent = runtimeContext.relayAgent || relayAgent;
-    }
-
-    const cachedBinding = resolveCachedAccountBinding({ runtimeConfig, accountId });
-    if (cachedBinding && resolveRuntimeAppToken(cachedBinding.runtimeConfig)) {
-      runtimeConfig = cachedBinding.runtimeConfig;
-      bindingSource = cachedBinding.bindingSource || bindingSource || 'binding_cache';
-      relayAgent = cachedBinding.relayAgent || relayAgent;
-    }
-
-    if (!resolveRuntimeAppToken(runtimeConfig)) {
-      const restoredBinding = await maybeRestoreRuntimeAppToken({
-        runtime: runtimeResolution.runtime,
-        accountId,
-        runtimeConfig,
-      });
-      if (restoredBinding.restored) {
-        runtimeConfig = restoredBinding.runtimeConfig;
-        bindingSource = 'installer_state_backup';
-        logger.info?.(`[claworld:${accountId || 'default'}] restored runtime binding from installer state`, {
-          installerStatePath: restoredBinding.installerStatePath || null,
-          relayAgentId: runtimeConfig?.relay?.agentId || null,
-        });
-        commitRuntimeBinding({
-          context: configuredContext,
-          runtime: runtimeResolution.runtime,
-          runtimeSource: runtimeResolution.runtimeSource,
-          accountId,
-          runtimeConfig,
-          bindingSource,
-          relayAgent,
-        });
-      }
-    }
-
-    if (resolveRuntimeAppToken(runtimeConfig) && (!bindingSource || bindingSource === 'runtime_context')) {
-      bindingSource = 'configured_app_token';
-    }
-
-    return {
-      ...configuredContext,
-      cfg: runtimeContext?.cfg || cfg,
-      accountId: runtimeConfig.accountId || accountId || null,
-      runtimeConfig,
-      runtime: runtimeResolution.runtime,
-      runtimeSource: runtimeResolution.runtimeSource,
-      agentId: configuredContext.agentId || runtimeConfig.relay?.agentId || null,
-      bindingSource,
-      relayAgent,
+      bindingSource: runtimeContext?.deferredFailure ? 'runtime_context_deferred' : 'runtime_context',
     };
   }
 
   async function resolveBoundRuntimeContext(context = {}) {
-    const configuredContext = await resolveAccountViewRuntimeContext(context);
+    const configuredContext = resolveConfiguredRuntimeContext(context);
     const cfg = configuredContext.cfg || {};
     const accountId = configuredContext.accountId || null;
     let runtimeConfig = configuredContext.runtimeConfig;
-    const runtimeResolution = resolvePluginRuntimeCandidate(
-      context.runtime || configuredContext.runtime || null,
-    );
+    const runtimeResolution = resolvePluginRuntimeCandidate(context.runtime || null);
     const restoredBinding = await maybeRestoreRuntimeAppToken({
       runtime: runtimeResolution.runtime,
       accountId,
@@ -2830,7 +2684,7 @@ export function createClaworldChannelPlugin({
         runtime: runtimeResolution.runtime,
         runtimeSource: runtimeResolution.runtimeSource,
         agentId: configuredContext.agentId || runtimeConfig.relay?.agentId || null,
-        bindingSource: configuredContext.bindingSource || runtimeContext.bindingSource || 'runtime_context',
+        bindingSource: 'runtime_context',
       };
     }
     const binding = await ensureAccountRelayBinding({ runtimeConfig, accountId });
@@ -3167,7 +3021,7 @@ export function createClaworldChannelPlugin({
   }
 
   async function getRuntimePublicIdentity(context = {}) {
-    const resolvedContext = await resolveAccountViewRuntimeContext(context);
+    const resolvedContext = resolveConfiguredRuntimeContext(context);
     return fetchPublicIdentity({
       runtimeConfig: resolvedContext.runtimeConfig,
       agentId: resolvedContext.agentId || null,
@@ -3178,10 +3032,7 @@ export function createClaworldChannelPlugin({
   }
 
 async function updateRuntimePublicIdentity(context = {}) {
-    const resolvedContext = await resolveAccountViewRuntimeContext(context);
-    const runtimeResolution = resolvePluginRuntimeCandidate(
-      context.runtime || resolvedContext.runtime || null,
-    );
+    const resolvedContext = resolveConfiguredRuntimeContext(context);
     const updateResult = await updatePublicIdentity({
       runtimeConfig: resolvedContext.runtimeConfig,
       agentId: resolvedContext.agentId || null,
@@ -3222,6 +3073,7 @@ async function updateRuntimePublicIdentity(context = {}) {
     );
 
     if (shouldPersistRuntimeBinding) {
+      const runtimeResolution = resolvePluginRuntimeCandidate(context.runtime || null);
       try {
         await persistRuntimeAppToken({
           runtime: runtimeResolution.runtime,
@@ -3235,19 +3087,23 @@ async function updateRuntimePublicIdentity(context = {}) {
           error: error?.message || String(error),
         });
       }
-    }
 
-    if (resolveRuntimeAppToken(boundRuntimeConfig) && nextAgentId) {
-      commitRuntimeBinding({
-        context: resolvedContext,
-        runtime: runtimeResolution.runtime,
-        runtimeSource: runtimeResolution.runtimeSource,
+      rememberAccountBinding({
         runtimeConfig: boundRuntimeConfig,
         accountId: resolvedContext.accountId || boundRuntimeConfig.accountId || null,
-        bindingSource: runtimeActivation
-          ? 'activated_app_token'
-          : (resolvedContext.bindingSource || 'configured_app_token'),
+        bindingSource: runtimeActivation ? 'activated_app_token' : 'configured_app_token',
       });
+
+      const accountKey = resolveAccountBindingKey(boundRuntimeConfig, resolvedContext.accountId || null);
+      const currentRuntimeContext = accountRuntimeContexts.get(accountKey) || null;
+      if (currentRuntimeContext) {
+        accountRuntimeContexts.set(accountKey, {
+          ...currentRuntimeContext,
+          runtimeConfig: boundRuntimeConfig,
+          deferredFailure: null,
+          deferredErrorMessage: null,
+        });
+      }
     }
 
     const payload = updateResult && typeof updateResult === 'object' && !Array.isArray(updateResult)
@@ -3433,7 +3289,6 @@ async function generateRuntimeProfileCard(context = {}) {
     },
     helpers: {
       resolveToolRuntimeContext: resolveBoundRuntimeContext,
-      resolveToolAccountViewContext: resolveAccountViewRuntimeContext,
       pairing: {
         resolveAgentIdentity: async (context = {}) => resolveRelayAgentSummary({
           runtimeConfig: context.runtimeConfig || resolveClaworldRuntimeConfig(context.cfg || {}, context.accountId || null),

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

@@ -278,7 +278,6 @@ export async function resolveToolContext(
   }
   return {
     cfg,
-    runtime: api?.runtime || null,
     accountId,
     runtimeConfig,
     agentId,
@@ -654,7 +653,19 @@ export function projectToolAccountViewResponse({
   identityPayload = null,
 } = {}) {
   const identityReady = identityPayload?.ready === true;
-  const ready = pairingPayload?.status === 'paired' && identityReady;
+  const activationReady = pairingPayload?.status === 'paired';
+  const bindingReady = typeof pairingPayload?.bindingReady === 'boolean'
+    ? pairingPayload.bindingReady
+    : activationReady;
+  const bindingStatus = normalizeText(
+    pairingPayload?.bindingStatus,
+    activationReady
+      ? (bindingReady ? 'bound' : 'identity_unresolved')
+      : 'unactivated',
+  );
+  const ready = activationReady && identityReady;
+  const relayResolved = pairingPayload?.relayAgent?.resolved ?? null;
+  const relayOnline = pairingPayload?.relayAgent?.online ?? null;
   const resolvedShareCard = identityPayload && Object.prototype.hasOwnProperty.call(identityPayload, 'shareCard')
     ? projectToolShareCard(identityPayload.shareCard)
     : undefined;
@@ -669,7 +680,15 @@ export function projectToolAccountViewResponse({
     reason: normalizeText(pairingPayload?.reason, null),
     bindingSource: normalizeText(pairingPayload?.bindingSource, null),
     activation: {
-      status: pairingPayload?.status === 'paired' ? 'ready' : 'pending',
+      status: activationReady ? 'ready' : 'pending',
+    },
+    diagnostics: {
+      toolReachable: true,
+      bindingReady,
+      bindingStatus,
+      publicIdentityReady: identityReady,
+      relayPresenceResolved: relayResolved,
+      relayOnline,
     },
     relay: {
       agentId: normalizeText(
@@ -679,9 +698,9 @@ export function projectToolAccountViewResponse({
       displayName: normalizeText(pairingPayload?.relayAgent?.displayName, null),
       discoverable: pairingPayload?.relayAgent?.discoverable ?? null,
       contactable: pairingPayload?.relayAgent?.contactable ?? null,
-      online: pairingPayload?.relayAgent?.online ?? null,
-      resolved: pairingPayload?.relayAgent?.resolved ?? null,
-      bindingStatus: pairingPayload?.status === 'paired' ? 'bound' : 'unactivated',
+      online: relayOnline,
+      resolved: relayResolved,
+      bindingStatus,
     },
     profile: projectToolAccountProfile(identityPayload),
     ...projectToolAccountIdentityFields(identityPayload),

package/src/openclaw/plugin/register.js

@@ -673,18 +673,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
             ...context,
             agentId: normalizeText(params.agentId, context.agentId),
           });
-        const responsePayload = action === 'get_profile'
-          && params.generateShareCard === true
-          && typeof plugin.runtime.productShell.profile?.generateShareCard === 'function'
-          ? {
-              ...payload,
-              shareCard: await plugin.runtime.productShell.profile.generateShareCard({
-                ...context,
-                expiresInSeconds: params.expiresInSeconds ?? null,
-              }),
-            }
-          : payload;
-        return buildTerminalActionResult({ tool: publicProfileTool, action, payload: responsePayload });
+        return buildTerminalActionResult({ tool: publicProfileTool, action, payload });
       },
     },
     {
@@ -1969,34 +1958,26 @@ function buildRegisteredTools(api, plugin) {
 
         const cfg = await loadCurrentConfig(api);
         const accountId = normalizeText(params.accountId, plugin.config.defaultAccountId(cfg) || null);
-        const rawRuntimeConfig = plugin.config.resolveRuntimeConfig(cfg, accountId);
-        const viewContext = typeof plugin.helpers?.resolveToolAccountViewContext === 'function'
-          ? await plugin.helpers.resolveToolAccountViewContext({
-            cfg,
-            runtime: api?.runtime || null,
-            accountId,
-            runtimeConfig: rawRuntimeConfig,
-            agentId: normalizeText(params.agentId, rawRuntimeConfig.relay?.agentId || null),
-          })
-          : {
-              cfg,
-              runtime: api?.runtime || null,
-              accountId,
-              runtimeConfig: rawRuntimeConfig,
-              agentId: normalizeText(params.agentId, rawRuntimeConfig.relay?.agentId || null),
-              bindingSource: null,
-            };
-        const runtimeConfig = viewContext.runtimeConfig || rawRuntimeConfig;
+        const runtimeConfig = plugin.config.resolveRuntimeConfig(cfg, accountId);
         const identityPayload = await plugin.runtime.productShell.profile.getPublicIdentity({
-          ...viewContext,
-          runtimeConfig,
+          cfg,
           accountId,
-          agentId: normalizeText(viewContext.agentId, runtimeConfig.relay?.agentId || null),
+          runtimeConfig,
+          agentId: runtimeConfig.relay?.agentId || null,
           generateShareCard,
           expiresInSeconds: params.expiresInSeconds ?? null,
         });
         const pairedAgentId = identityPayload?.agentId || runtimeConfig.relay?.agentId || null;
-        const relayAgent = pairedAgentId
+        const pairedRuntimeConfig = pairedAgentId
+          ? {
+            ...runtimeConfig,
+            relay: {
+              ...(runtimeConfig.relay && typeof runtimeConfig.relay === 'object' ? runtimeConfig.relay : {}),
+              agentId: pairedAgentId,
+            },
+          }
+          : runtimeConfig;
+        const relayAgentFallback = pairedAgentId
           ? {
             agentId: pairedAgentId,
             displayName: normalizeText(
@@ -2017,23 +1998,39 @@ function buildRegisteredTools(api, plugin) {
           || runtimeConfig.relay?.appToken
           || runtimeConfig.relay?.credentialToken,
         );
+        const activationReady = hasConfiguredAppToken;
+        const bindingReady = activationReady && Boolean(pairedAgentId);
+        const bindingStatus = activationReady
+          ? (bindingReady ? 'bound' : 'identity_unresolved')
+          : 'unactivated';
+        let relayAgent = relayAgentFallback;
+        if (hasConfiguredAppToken && pairedAgentId && typeof plugin.helpers?.pairing?.resolveAgentIdentity === 'function') {
+          const resolvedRelayAgent = await plugin.helpers.pairing.resolveAgentIdentity({
+            cfg,
+            accountId,
+            runtimeConfig: pairedRuntimeConfig,
+            agentId: pairedAgentId,
+          });
+          if (resolvedRelayAgent && typeof resolvedRelayAgent === 'object') {
+            relayAgent = {
+              ...relayAgentFallback,
+              ...resolvedRelayAgent,
+              agentId: normalizeText(resolvedRelayAgent.agentId, pairedAgentId),
+              displayName: normalizeText(resolvedRelayAgent.displayName, relayAgentFallback?.displayName ?? null),
+            };
+          }
+        }
         const pairingPayload = {
-          status: hasConfiguredAppToken ? 'paired' : 'unpaired',
-          reason: hasConfiguredAppToken
+          status: activationReady ? 'paired' : 'unpaired',
+          bindingReady,
+          bindingStatus,
+          reason: activationReady
             ? (pairedAgentId ? null : 'missing_agent_id')
             : 'missing_app_token',
-          bindingSource: hasConfiguredAppToken
-            ? normalizeText(viewContext.bindingSource, 'configured_app_token')
+          bindingSource: activationReady
+            ? 'configured_app_token'
             : (runtimeConfig.registration?.enabled === true ? 'registration_pending' : 'unbound'),
-          runtimeConfig: pairedAgentId
-            ? {
-              ...runtimeConfig,
-              relay: {
-                ...(runtimeConfig.relay && typeof runtimeConfig.relay === 'object' ? runtimeConfig.relay : {}),
-                agentId: pairedAgentId,
-              },
-            }
-            : runtimeConfig,
+          runtimeConfig: pairedRuntimeConfig,
           relayAgent,
         };
         return buildToolResult(projectToolAccountViewResponse({