@xfxstudio/claworld 0.2.4 → 0.2.5

package/openclaw.plugin.json

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

package/package.json

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

package/src/openclaw/installer/cli.js

@@ -18,6 +18,19 @@ import {
   runClaworldInstallerUpdate,
 } from './core.js';
 
+function resolveCliHomeDir(env = process.env) {
+  const envHomeDir = String(
+    env.HOME
+    || env.USERPROFILE
+    || (
+      env.HOMEDRIVE && env.HOMEPATH
+        ? path.join(env.HOMEDRIVE, env.HOMEPATH)
+        : ''
+    ),
+  ).trim();
+  return envHomeDir || os.homedir();
+}
+
 function printHelp() {
   console.log(`Usage: ${CLAWORLD_INSTALLER_BIN_NAME} <command> [options]
 
@@ -79,7 +92,7 @@ function nextValue(argv, index) {
 }
 
 export function parseInstallerCliArgs(argv = process.argv.slice(2), env = process.env) {
-  const homeDir = os.homedir();
+  const homeDir = resolveCliHomeDir(env);
   const options = {
     command: null,
     json: false,

package/src/openclaw/installer/core.js

@@ -36,6 +36,15 @@ export const DEFAULT_VERIFICATION_DELAY_MS = 1_000;
 export const seedManagedWorkspace = seedManagedWorkspaceContract;
 const TRACKED_PLUGIN_UPDATEABLE_SOURCES = new Set(['npm', 'marketplace']);
 
+function resolveRequireGatewayRunning(env = process.env) {
+  const normalized = normalizeText(env?.CLAWORLD_INSTALLER_REQUIRE_GATEWAY_RUNNING, null);
+  if (!normalized) return true;
+  const lowered = normalized.toLowerCase();
+  if (['0', 'false', 'no', 'off'].includes(lowered)) return false;
+  if (['1', 'true', 'yes', 'on'].includes(lowered)) return true;
+  return true;
+}
+
 function normalizeComparablePath(value) {
   if (!value) return null;
   return path.resolve(String(value));
@@ -1224,6 +1233,7 @@ export async function verifyClaworldInstall({
   dryRun = false,
   attempts = DEFAULT_VERIFICATION_ATTEMPTS,
   delayMs = DEFAULT_VERIFICATION_DELAY_MS,
+  requireGatewayRunning = resolveRequireGatewayRunning(env),
 } = {}) {
   let lastResult = null;
 
@@ -1283,7 +1293,7 @@ export async function verifyClaworldInstall({
     const bindingReady = Boolean(bindingLine);
 
     lastResult = {
-      ok: pluginReady && gatewayRunning && channelReady && bindingReady,
+      ok: pluginReady && channelReady && bindingReady && (!requireGatewayRunning || gatewayRunning),
       attempt,
       plugin,
       gatewayStatus,
@@ -1293,6 +1303,7 @@ export async function verifyClaworldInstall({
       gatewayRunning,
       channelReady,
       bindingReady,
+      requireGatewayRunning,
     };
 
     if (lastResult.ok) {

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

@@ -1488,6 +1488,45 @@ function createDeliveryReplyDispatcher({
   };
 }
 
+async function runDeliveryReplyDispatch({
+  runtime,
+  currentCfg,
+  relayClient,
+  deliveryId,
+  sessionKey,
+  localAgentId,
+  allowReply,
+  logger,
+  runtimeAccountId,
+  inboundCtx,
+} = {}) {
+  const { dispatcher, replyOptions, markDispatchIdle, didReply, getRuntimeOutputSummary } = createDeliveryReplyDispatcher({
+    runtime,
+    currentCfg,
+    relayClient,
+    deliveryId,
+    sessionKey,
+    localAgentId,
+    allowReply,
+    logger,
+    runtimeAccountId,
+  });
+
+  const dispatchResult = await runtime.channel.reply.dispatchReplyFromConfig({
+    ctx: inboundCtx,
+    cfg: currentCfg,
+    dispatcher,
+    replyOptions,
+  });
+  await markDispatchIdle();
+
+  return {
+    dispatchResult,
+    replied: didReply(),
+    runtimeOutputSummary: getRuntimeOutputSummary(),
+  };
+}
+
 function resolveBoundLocalAgentId({ cfg = {}, runtimeConfig = {}, relayClient } = {}) {
   const accountId = resolveNormalizedText(runtimeConfig.accountId, null);
   const bindings = Array.isArray(cfg?.bindings) ? cfg.bindings : [];
@@ -1662,7 +1701,11 @@ async function maybeBridgeRuntimeDelivery({
     commandAuthorized,
   });
 
-  const { dispatcher, replyOptions, markDispatchIdle, didReply, getRuntimeOutputSummary } = createDeliveryReplyDispatcher({
+  let {
+    dispatchResult,
+    replied,
+    runtimeOutputSummary,
+  } = await runDeliveryReplyDispatch({
     runtime,
     currentCfg,
     relayClient,
@@ -1672,16 +1715,52 @@ async function maybeBridgeRuntimeDelivery({
     allowReply: metadata.allowReply !== false,
     logger,
     runtimeAccountId,
+    inboundCtx,
   });
-  const dispatchResult = await runtime.channel.reply.dispatchReplyFromConfig({
-    ctx: inboundCtx,
-    cfg: currentCfg,
-    dispatcher,
-    replyOptions,
-  });
-  await markDispatchIdle();
-  const replied = didReply();
-  const runtimeOutputSummary = getRuntimeOutputSummary();
+
+  const shouldRetryKickoffDispatch = (
+    metadata.deliveryType === 'kickoff'
+    && metadata.allowReply !== false
+    && replied !== true
+    && runtimeOutputSummary.counts.final > 0
+    && runtimeOutputSummary.counts.operationalNotice > 0
+    && runtimeOutputSummary.counts.final === runtimeOutputSummary.counts.operationalNotice
+    && runtimeOutputSummary.counts.block === 0
+    && runtimeOutputSummary.counts.tool === 0
+    && runtimeOutputSummary.counts.partial === 0
+    && runtimeOutputSummary.counts.reasoning === 0
+    && runtimeOutputSummary.counts.toolStart === 0
+    && runtimeOutputSummary.counts.assistantMessageStart === 0
+    && runtimeOutputSummary.counts.reasoningEnd === 0
+    && runtimeOutputSummary.counts.compactionStart === 0
+    && runtimeOutputSummary.counts.compactionEnd === 0
+  );
+
+  if (shouldRetryKickoffDispatch) {
+    logger.warn?.(`[claworld:${runtimeAccountId}] kickoff delivery produced only operational notices; retrying dispatch once`, {
+      deliveryId,
+      sessionKey,
+      localAgentId,
+      runtimeOutputSummary,
+    });
+
+    ({
+      dispatchResult,
+      replied,
+      runtimeOutputSummary,
+    } = await runDeliveryReplyDispatch({
+      runtime,
+      currentCfg,
+      relayClient,
+      deliveryId,
+      sessionKey,
+      localAgentId,
+      allowReply: metadata.allowReply !== false,
+      logger,
+      runtimeAccountId,
+      inboundCtx,
+    }));
+  }
 
   logger.info?.(`[claworld:${runtimeAccountId}] delivery bridge completed`, {
     deliveryId,