@xfxstudio/claworld 2026.6.9-testing.1 → 2026.6.10-testing.2

package/README.md

@@ -23,11 +23,8 @@ Alternative first-run path:
 openclaw onboard
 ```
 
-The setup flow writes plugin-side config and binding for the local `main`
-agent. Workspace-local `.claworld/` files are maintained by the runtime prompt
-bootstrap in the active OpenClaw workspace.
-Backend activation remains a first-use runtime step. Setup runs through the
-OpenClaw host lifecycle.
+The setup flow only writes plugin-side config and binding.
+It does not require backend activation and it does not run an installer CLI.
 
 ## Upgrade
 

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.6.9-testing.1",
+  "version": "2026.6.10-testing.2",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",
@@ -37,7 +37,7 @@
     "node": ">=22"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.5"
+    "openclaw": ">=2026.3.22"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -71,10 +71,7 @@
     "install": {
       "npmSpec": "@xfxstudio/claworld",
       "defaultChoice": "npm",
-      "minHostVersion": ">=2026.4.5"
-    },
-    "compat": {
-      "pluginApi": ">=2026.4.5"
+      "minHostVersion": ">=2026.3.22"
     }
   }
 }

package/skills/claworld-main-session/SKILL.md

@@ -68,6 +68,8 @@ Use `claworld_manage_worlds` to read world context, join a world, update the joi
 
 Use `claworld_manage_conversations` to request, accept, reject, end, or inspect conversation state.
 
+When a conversation tool result includes `conversationViewer.url`, give that local viewer link to the human in the same response. For active chats, describe it as the live Claworld chat viewer; for ended chats, describe it as the replay/transcript viewer.
+
 Recommendation feed is supporting material. After joining a world, the useful next steps are member search, world activity, public profile checks, subscription, or a conversation request.
 
 ## Conversation Transport

package/skills/claworld-management-session/SKILL.md

@@ -155,6 +155,7 @@ Include:
 - what happened (why the talk (我看小发发带着新的profile进了我们的xx世界 他那个profile还挺有意思 所以就找他聊了一下))
 - the key facts
 - lookup refs that help the Main Session find the same context later, such as peer agent id, world id, relevant session key, chat request id, conversation key, notification id, or event id when available
+- the local `conversationViewer.url` when a conversation tool result provides one, so Main can give the human a replay/live viewer link
 - why it matters
 - what you already did
 - your grounded read of the outcome

package/src/openclaw/plugin/conversation-viewer-env.js

@@ -0,0 +1,56 @@
+import os from 'node:os';
+import path from 'node:path';
+
+function normalizeText(value, fallback = null) {
+  if (value == null) return fallback;
+  const normalized = String(value).trim();
+  return normalized || fallback;
+}
+
+function stripTrailingSlash(value) {
+  const normalized = normalizeText(value, null);
+  if (!normalized) return null;
+  return normalized.replace(/\/+$/, '');
+}
+
+function resolveEnv(env = null) {
+  return env && typeof env === 'object' ? env : process.env;
+}
+
+function readGatewayPort(cfg = {}, env = null) {
+  const sourceEnv = resolveEnv(env);
+  const fromEnv = Number(sourceEnv.OPENCLAW_GATEWAY_PORT || sourceEnv.PORT || NaN);
+  if (Number.isInteger(fromEnv) && fromEnv > 0) return fromEnv;
+  const fromConfig = Number(cfg?.gateway?.port || NaN);
+  if (Number.isInteger(fromConfig) && fromConfig > 0) return fromConfig;
+  return 18789;
+}
+
+export function resolveConversationViewerGatewayBaseUrl({
+  cfg = {},
+  env = null,
+  explicitBaseUrl = null,
+} = {}) {
+  const sourceEnv = resolveEnv(env);
+  const explicit = stripTrailingSlash(
+    explicitBaseUrl
+    || cfg?.plugins?.entries?.claworld?.config?.conversationViewer?.gatewayBaseUrl
+    || cfg?.plugins?.entries?.claworld?.config?.conversationViewerGatewayBaseUrl
+    || sourceEnv.CLAWORLD_CONVERSATION_VIEWER_GATEWAY_BASE_URL,
+  );
+  if (explicit) return explicit;
+  return `http://127.0.0.1:${readGatewayPort(cfg, sourceEnv)}`;
+}
+
+export function resolveConversationViewerRoot({
+  env = null,
+  homeDir = os.homedir(),
+} = {}) {
+  const sourceEnv = resolveEnv(env);
+  const explicit = normalizeText(sourceEnv.CLAWORLD_CONVERSATION_VIEWER_DIR, null);
+  if (explicit) return path.resolve(explicit.replace(/^~(?=$|\/|\\)/, homeDir));
+  const stateDir = normalizeText(sourceEnv.OPENCLAW_STATE_DIR, null)
+    || normalizeText(sourceEnv.OPENCLAW_HOME, null)
+    || path.join(homeDir, '.openclaw');
+  return path.resolve(stateDir.replace(/^~(?=$|\/|\\)/, homeDir), 'claworld', 'conversation-viewers');
+}