@xfxstudio/claworld 2026.6.5 → 2026.6.9-testing.1

package/README.md

@@ -23,8 +23,20 @@ Alternative first-run path:
 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.
+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.
+
+## 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
 

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.9-testing.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

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/src/openclaw/plugin/managed-config.js

@@ -336,25 +336,6 @@ function inferExistingAgentId(config = {}, accountId = DEFAULT_CLAWORLD_ACCOUNT_
   return DEFAULT_CLAWORLD_AGENT_ID;
 }
 
-const MANAGED_LEGACY_BUNDLED_SKILL_NAMES = Object.freeze([
-  'claworld-main-session',
-  'claworld-manage-worlds',
-  'claworld-help',
-]);
-
-function hasOnlyManagedBundledSkills(value) {
-  if (!Array.isArray(value) || value.length === 0) return false;
-  return value.every((skillName) => MANAGED_LEGACY_BUNDLED_SKILL_NAMES.includes(skillName));
-}
-
-function buildManagedAgentEntry(options = {}) {
-  return {
-    id: options.agentId,
-    workspace: options.workspace,
-    ...(options.agentDirExplicit && options.agentDir ? { agentDir: options.agentDir } : {}),
-  };
-}
-
 function buildManagedRoutingEntry(options = {}, existingRouting = {}) {
   return {
     ...ensureObject(existingRouting),
@@ -507,60 +488,6 @@ export function resolveToolNames({ toolProfile = DEFAULT_CLAWORLD_TOOL_PROFILE }
   return [...baseProfile];
 }
 
-const MANAGED_BUNDLED_SKILL_NAMES = Object.freeze([
-  'claworld-main-session',
-  'claworld-manage-worlds',
-  'claworld-help',
-]);
-
-export function resolveManagedAgentSkills({ toolProfile = DEFAULT_CLAWORLD_TOOL_PROFILE } = {}) {
-  const normalizedProfile = normalizeClaworldToolProfile(toolProfile);
-  return normalizedProfile === 'full' ? undefined : [...MANAGED_BUNDLED_SKILL_NAMES];
-}
-
-function describeToolAllowEntries(toolNames = []) {
-  if (toolNames.length === 1) {
-    return toolNames[0] === '*' ? '1 entry (includes *)' : '1 entry';
-  }
-  return toolNames.includes('*')
-    ? `${toolNames.length} entries (includes *)`
-    : `${toolNames.length} entries`;
-}
-
-export function buildWorkspaceAgentsContent({
-  agentId,
-  accountId,
-  registrationDisplayName,
-  appToken = null,
-  defaultTargetAgentId = null,
-} = {}) {
-  const identityLine = appToken
-    ? '- relay binding is resolved from the configured appToken at runtime'
-    : registrationDisplayName
-      ? '- relay binding is created during runtime bootstrap and persists as backend-issued credentials'
-      : '- activation is pending until the user completes Claworld public identity setup';
-
-  return `# Claworld Channel Agent
-
-This workspace is dedicated to the OpenClaw \`claworld\` channel.
-
-Routing contract:
-
-- local OpenClaw agent id: \`${agentId}\`
-- claworld account id: \`${accountId}\`
-${registrationDisplayName ? `- bootstrap display name: \`${registrationDisplayName}\`` : (appToken ? '- credential mode: appToken/manual binding' : '- credential mode: activation pending')}
-${identityLine}
-${defaultTargetAgentId ? `- default outbound target agentId: \`${defaultTargetAgentId}\`` : '- outbound sends require explicit target agentId inputs'}
-
-Operating rules:
-
-- keep this workspace focused on Claworld relay and world interactions
-- use explicit \`claworld_*\` tools when they are available
-- do not treat this workspace as the user's general-purpose main agent
-- do not treat this as a separately bootstrapped OpenClaw persona
-`;
-}
-
 function buildBoundAgentEntry(existingAgent = {}, agentId) {
   const nextAgent = {
     ...ensureObject(existingAgent),
@@ -570,41 +497,8 @@ function buildBoundAgentEntry(existingAgent = {}, agentId) {
   return nextAgent;
 }
 
-export function buildWorkspaceMemoryContent({
-  agentId,
-  accountId,
-  registrationDisplayName,
-  appToken = null,
-  defaultTargetAgentId = null,
-} = {}) {
-  const identityLine = appToken
-    ? '- relay binding: resolved from appToken at runtime'
-    : registrationDisplayName
-      ? '- relay binding: assigned during runtime bootstrap'
-      : '- relay binding: pending until public identity setup completes';
-
-  return `# Claworld Memory
-
-- workspace owner: \`${agentId}\`
-- claworld account: \`${accountId}\`
-${registrationDisplayName ? `- bootstrap display name: \`${registrationDisplayName}\`` : ''}
-${identityLine}
-${defaultTargetAgentId ? `- default outbound target agentId: \`${defaultTargetAgentId}\`` : ''}
-
-Use this file for durable Claworld-specific notes only.
-
-- keep world rules, pairing context, and recurring counterpart preferences here when they help future Claworld conversations
-- do not duplicate a full standalone OpenClaw bootstrap/persona here
-- prefer channel/world-specific memory over general-purpose assistant memory
-`;
-}
-
-export function resolveDefaultManagedWorkspace(agentId = DEFAULT_CLAWORLD_AGENT_ID) {
-  return `~/.openclaw/workspace-${agentId}`;
-}
-
 export function resolveDefaultManagedDisplayName(accountId = DEFAULT_CLAWORLD_ACCOUNT_ID) {
-  return `${titleCase(accountId)} Channel Agent`;
+  return `${titleCase(accountId)} Channel`;
 }
 
 export function resolveClaworldManagedRuntimeOptions({
@@ -615,7 +509,6 @@ export function resolveClaworldManagedRuntimeOptions({
   installerState = null,
 } = {}) {
   const resolvedAccountId = normalizeText(accountId, DEFAULT_CLAWORLD_ACCOUNT_ID);
-  const attachToExistingAgent = overrides.attachToExistingAgent !== false;
   const existingBackup = findClaworldManagedRuntimeBackup(installerState, resolvedAccountId);
   const inferredAgentId = inferExistingAgentId(cfg, resolvedAccountId)
     || normalizeText(existingBackup.agentId, null);
@@ -623,20 +516,7 @@ export function resolveClaworldManagedRuntimeOptions({
   const existingAgent = findAgentEntry(cfg, agentId);
   const existingAccount = findManagedAccountEntry(cfg, resolvedAccountId);
   const replaceManagedRuntime = overrides.replaceManagedRuntime !== false;
-  const explicitWorkspace = normalizeText(overrides.workspace, null);
-  const manageAgentEntry = overrides.manageAgentEntry === true
-    || overrides.agentDirExplicit === true
-    || attachToExistingAgent !== true;
-  const manageWorkspace = overrides.manageWorkspace === true
-    || Boolean(explicitWorkspace)
-    || attachToExistingAgent !== true;
-  const defaultWorkspace = manageWorkspace ? resolveDefaultManagedWorkspace(agentId) : null;
-  const workspace = normalizeText(
-    explicitWorkspace,
-    replaceManagedRuntime
-      ? normalizeText(existingAgent?.workspace, normalizeText(existingBackup.workspace, defaultWorkspace))
-      : normalizeText(existingAgent?.workspace, normalizeText(existingBackup.workspace, defaultWorkspace)),
-  );
+  const workspace = normalizeText(existingAgent?.workspace, normalizeText(existingBackup.workspace, null));
   const serverUrl = normalizeText(
     overrides.serverUrl,
     normalizeText(input.httpUrl, normalizeText(input.url, normalizeText(existingBackup.serverUrl, DEFAULT_CLAWORLD_SERVER_URL))),
@@ -680,14 +560,9 @@ export function resolveClaworldManagedRuntimeOptions({
 
   return {
     repoRoot: normalizeText(overrides.repoRoot, null),
-    attachToExistingAgent,
     agentId,
     accountId: resolvedAccountId,
     workspace,
-    manageAgentEntry,
-    manageWorkspace,
-    agentDir: normalizeText(overrides.agentDir, null),
-    agentDirExplicit: overrides.agentDirExplicit === true,
     serverUrl,
     apiKey,
     appToken,
@@ -715,7 +590,6 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
   const replaceManagedRuntime = options.replaceManagedRuntime !== false;
   const preserveDefaultAccount = options.preserveDefaultAccount === true;
   const sessionDmScope = normalizeText(options.sessionDmScope, DEFAULT_CLAWORLD_DM_SCOPE);
-  const manageAgentEntry = options.manageAgentEntry === true;
 
   const removedManagedToolNames = new Set(CLAWORLD_PUBLIC_TOOL_NAMES);
   if (inputConfig?.tools && typeof inputConfig.tools === 'object') {
@@ -754,72 +628,18 @@ export function applyClaworldManagedRuntimeConfig(inputConfig = {}, options = {}
 
   config.agents = ensureObject(config.agents);
   const existingAgentList = Array.isArray(config.agents.list) ? [...config.agents.list] : [];
-  if (manageAgentEntry) {
-    const managedAgentEntry = buildManagedAgentEntry(options);
-    if (replaceManagedRuntime) {
-      const removedAgentEntries = existingAgentList.filter((item) => ensureObject(item).id === options.agentId).length;
-      config.agents.list = [
-        ...existingAgentList.filter((item) => ensureObject(item).id !== options.agentId),
-        {
-          ...managedAgentEntry,
-          tools: mergeManagedPluginToolExposure(managedAgentEntry.tools),
-        },
-      ];
-      summary.push(
-        removedAgentEntries > 0
-          ? `replaced managed agent entry ${options.agentId}`
-          : `added workspace-scoped agent entry ${options.agentId}`,
-      );
-    } else {
-      const agentIndex = findAgentIndex(existingAgentList, options.agentId);
-      if (agentIndex >= 0) {
-        const existingAgent = ensureObject(existingAgentList[agentIndex]);
-        const existingAgentDir = normalizeText(existingAgent.agentDir, null);
-        const keepExistingAgentDir = Boolean(
-          existingAgentDir
-          && (
-            options.agentDirExplicit
-            || existingAgentDir !== normalizeText(options.agentDir, null)
-          ),
-        );
-        const nextAgentEntry = {
-          ...existingAgent,
-          id: options.agentId,
-          workspace: normalizeText(existingAgent.workspace, options.workspace),
-          ...(keepExistingAgentDir ? { agentDir: existingAgentDir } : {}),
-        };
-        if (!keepExistingAgentDir) {
-          delete nextAgentEntry.agentDir;
-        }
-        if (hasOnlyManagedBundledSkills(existingAgent.skills)) {
-          delete nextAgentEntry.skills;
-        }
-        nextAgentEntry.tools = mergeManagedPluginToolExposure(existingAgent.tools);
-        existingAgentList[agentIndex] = nextAgentEntry;
-        summary.push(`updated existing agent entry ${options.agentId}`);
-      } else {
-        existingAgentList.push({
-          ...managedAgentEntry,
-          tools: mergeManagedPluginToolExposure(managedAgentEntry.tools),
-        });
-        summary.push(`added workspace-scoped agent entry ${options.agentId}`);
-      }
-      config.agents.list = existingAgentList;
-    }
+  const agentIndex = findAgentIndex(existingAgentList, options.agentId);
+  if (agentIndex >= 0) {
+    const existingAgent = ensureObject(existingAgentList[agentIndex]);
+    existingAgentList[agentIndex] = buildBoundAgentEntry(existingAgent, options.agentId);
+    config.agents.list = existingAgentList;
+    summary.push(`updated bound agent tool exposure ${options.agentId}`);
   } else {
-    const agentIndex = findAgentIndex(existingAgentList, options.agentId);
-    if (agentIndex >= 0) {
-      const existingAgent = ensureObject(existingAgentList[agentIndex]);
-      existingAgentList[agentIndex] = buildBoundAgentEntry(existingAgent, options.agentId);
-      config.agents.list = existingAgentList;
-      summary.push(`updated bound agent tool exposure ${options.agentId}`);
-    } else {
-      existingAgentList.push(buildBoundAgentEntry({}, options.agentId));
-      config.agents.list = existingAgentList;
-      summary.push(`added bound agent entry ${options.agentId}`);
-    }
-    summary.push(`attached claworld account ${options.accountId} to existing local agent ${options.agentId}`);
+    existingAgentList.push(buildBoundAgentEntry({}, options.agentId));
+    config.agents.list = existingAgentList;
+    summary.push(`added bound agent entry ${options.agentId}`);
   }
+  summary.push(`attached claworld account ${options.accountId} to local agent ${options.agentId}`);
 
   config.channels = ensureObject(config.channels);
   const existingClaworldRoot = ensureObject(config.channels.claworld);

package/src/openclaw/plugin/onboarding.js

@@ -133,7 +133,6 @@ export function inspectManagedClaworldInstall({
   const setupReady = Boolean(
     managedAccountPresent
     && managedBindingPresent
-    && (managedOptions.manageAgentEntry !== true || managedAgentPresent)
   );
 
   let statusLabel = 'needs setup';
@@ -247,8 +246,10 @@ async function applyManagedOnboardingConfig({
     `Remote backend: ${managedOptions.serverUrl}`,
     managedOptions.appToken
       ? 'Activation state: ready via configured appToken'
-      : 'Activation state: pending until claworld_manage_account(action=update_display_name) runs',
-    'This flow refreshes plugin-side config and binds claworld onto the selected local agent. It does not run installer commands or start a backend service.',
+      : 'Activation state: pending until claworld_manage_account(action=activate_account) runs',
+    'Workspace memory: runtime prompt bootstrap maintains .claworld/ in the active host workspace',
+    'This flow refreshes plugin-side config and binds claworld onto the selected local agent.',
+    'Setup lifecycle: OpenClaw host-native setup.',
   ];
   await prompter.note(
     noteLines.join('\n'),

package/src/openclaw/plugin/register.js

@@ -1956,7 +1956,7 @@ function buildRegisteredTools(api, plugin) {
             examples: ['Moza', '小发发'],
           }),
           profile: stringParam({
-            description: 'Global plain-text profile for this account. Maximum 200 characters. Use an empty string to clear it. HTML is not supported.',
+            description: 'Global plain-text profile for this account. Maximum 500 characters. Use an empty string to clear it. HTML is not supported.',
             examples: ['喜欢慢节奏介绍和小范围世界，也愿意先让 agent 帮我做初步认识。🙂'],
           }),
           chatRequestApprovalPolicy: chatRequestApprovalPolicyProperty,