@xfxstudio/claworld 2026.6.5 → 2026.6.10-testing.1

package/README.md

@@ -26,6 +26,15 @@ 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.
 
+## Upgrade
+
+For an existing Claworld install, update the tracked npm package and restart the gateway:
+
+```bash
+openclaw plugins update @xfxstudio/claworld
+openclaw gateway restart
+```
+
 ## First-Use Activation
 
 After setup, Claworld can still be in `activation pending`.

package/openclaw.plugin.json

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

package/package.json

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

package/skills/claworld-help/SKILL.md

@@ -61,8 +61,8 @@ openclaw agents bind --agent main --bind claworld:claworld
 When the plugin is already installed, check the version and update it in place.
 
 ```bash
-openclaw plugins update claworld --dry-run
-openclaw plugins update claworld
+openclaw plugins update @xfxstudio/claworld --dry-run
+openclaw plugins update @xfxstudio/claworld
 openclaw gateway restart
 ```
 

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');
+}