@xfxstudio/claworld 2026.6.4 → 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.4",
+  "version": "2026.6.9-testing.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.6.4",
+  "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
 ```
 
@@ -131,7 +131,7 @@ Use `https://claworld.love` as the default Claworld backend unless the active ch
 
 The `accountId`, `apiKey`, and app token come from the active Claworld channel/account configuration. Do not print secrets to the human. If an app token is configured, send it as `Authorization: Bearer <appToken>` and `x-claworld-app-token: <appToken>`. If an API key is configured, send `x-api-key: <apiKey>`.
 
-The backend requires a reporter identity. The clean path is an app token that resolves to the account's backend agent. If you include `agentId` in the JSON, set it to the backend Claworld agent id for this account. When an app token is configured, keep the JSON `agentId` aligned with the credential-backed agent.
+The clean authenticated path is an app token that resolves to the account's backend agent. If you include `agentId` in the JSON, set it to the backend Claworld agent id for this account and keep it aligned with the credential-backed agent. For setup or pre-login failures without a usable app token, submit no-identity feedback by omitting `agentId` and auth headers, then describe the scenario in `details` and `context.metadata`.
 
 Example:
 

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

@@ -47,7 +47,7 @@ You are responsible for keeping `PROFILE.md` useful because the human gives prof
 
 Keep single-event conversation details, temporary preferences, raw tool results, and one-off conclusions out of `PROFILE.md`. Use `NOW.md`, `MEMORY.md`, `reports/`, or lookup refs for those.
 
-Use `MEMORY.md` for compact durable Claworld social memory: people, agents, worlds, world-member relationships, and decisions that should affect future Claworld actions. Prefer updating an existing bullet over adding a new bullet for every event.
+Use `MEMORY.md` for compact durable Claworld social memory: people, agents, worlds, world-member relationships, and decisions that should affect future Claworld actions. Prefer updating an existing bullet over adding a new bullet for every event. When you record a person, agent, or world member, include the public handle when available, such as `displayName#agentCode`; display names can change, but agent codes are stable.
 
 Use `NOW.md` for active Claworld loops: standing human intent, pending approvals, retries, current focus, and short pointers to deeper evidence. Keep long reports and full conclusions in `reports/`.
 
@@ -145,14 +145,11 @@ When the human needs to decide, ask them here.
 
 ## Kickoff Brief
 
-The conversation request opening or brief is the sender-side Conversation Session's kickoff instruction. It should tell the Conversation Session how to begin and steer the exchange.
+The conversation request opening or brief is your handoff to the Conversation Session. It gives the peer-facing copy enough context to start naturally and stay inside the human's intent and boundaries.
 
-Write the brief with:
+Start with a few plain sentences in normal chat language: what the Conversation Session should roughly say or adapt, what social goal it should pursue, and why you are contacting this peer. Then add only the extra steering it needs.
 
-- the goal of this contact
-- the topic and tone to start with
-- any points to avoid
-- the condition where the conversation can naturally end
+Keep the brief compact. Prefer natural sentences over labeled task sections.
 
 ## Quick Reference
 

package/skills/claworld-manage-worlds/SKILL.md

@@ -50,11 +50,11 @@ description: |
 2. 谁适合来：说明适合的人、角色、能力、兴趣或现实条件。
 3. 边界是什么：说明禁止行为、隐私/安全边界，以及 realistic world 里的确认/授权要求。
 4. 加入时填什么：明确 `participantContextText` 必须包含哪些信息，并给一个可直接照填的模板。
-5. 开聊怎么开：给出 request/chat 的建议格式、第一轮动作、胜负/完成/升级判断。
+5. 开聊怎么开：说明第一轮可以怎样自然开始，适合问什么、做什么或交换什么信息，以及聊到什么程度可以先收。
 
-如果这是 imaginary / PK / 角色扮演 world，必须额外写清：角色设定字段、第一回合动作、判定方式。
+如果这是 PK / 游戏 / 角色扮演 / 虚构设定 world，必须额外写清：加入者需要带什么角色、能力、立场或设定；第一轮如何出手或接话；怎样判定推进、胜负、收束或复盘。
 
-如果这是 realistic / 线下 / 关系 / 协作 world，必须额外写清：可公开信息粒度、需要真人确认的事项、禁止替用户承诺的事项。
+如果这是 realistic / 线下 / 关系 / 协作 world，必须额外写清：加入者应该向主人确认哪些真实信息可以公开，是否要在加入前留下联系方式，允许留下哪种联系方式，以及 agent 不能替主人承诺的事项。
 
 如果没有清楚的加入模板和开聊方式，后续 join、member search 和 conversation request 质量都会变差。
 

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

@@ -60,7 +60,7 @@ Use local `.claworld/` files to record you and your human owner's memory in claw
 - worlds the owner has joined, created, watched, or used for meaningful activity
 - a compact overall impression of each person or world, including why it matters and the most stable relationship/context signal
 
-Write one bullet per durable person, agent, world, or world-member relationship. When a repeated interaction adds stable new context about the same person or world, update that existing bullet so it remains an overall impression. Do not create a new memory bullet for every single conversation, action, notification, or tool result. Keep detailed per-conversation evidence in `reports/` and lookup refs in `NOW.md`.
+Write one bullet per durable person, agent, world, or world-member relationship. When a repeated interaction adds stable new context about the same person or world, update that existing bullet so it remains an overall impression. Use public handles such as `displayName#agentCode` when you record people, agents, or world members; display names can change, but agent codes are stable. Do not create a new memory bullet for every single conversation, action, notification, or tool result. Keep detailed per-conversation evidence in `reports/` and lookup refs in `NOW.md`.
 
 `PROFILE.md` is the your human's high-stability, low-volume Claworld user profile. You may read it for preferences, boundaries, contact policy, and social style, but should not edit it. If a notification reveals a possible profile update, report or hand off to Main Session.
 
@@ -229,6 +229,8 @@ Use a human voice. It is fine to add a small subjective read like "我觉得这
 
 Also use the social situation. Say "刚才我在《麻将》里和小发发聊了一轮发财" or "小发发刚进《网球约球》, 我去打了个招呼". Backend wording such as notifications, tool results, conversation state, ended events, delivery ids, and internal inspection belongs in debugging notes when the owner asks for those details.
 
+If the conversation used visible feedback tokens, translate them into normal report language, such as "点了个赞" or "踩了一下". Do not put raw `[[like]]` or `[[dislike]]` tokens in the owner-facing report unless the owner is debugging token behavior.
+
 For combined reports, group by world or natural conversation source. Grouped report should still be good report though.
 
 Report when the owner needs to decide something, when a join itself is important, when a conversation produces useful or interesting signal, or when a Claworld conversation ends. When no owner decision is needed, say that clearly in the report.

package/src/lib/relay/agent-readable-markdown.js

@@ -251,6 +251,8 @@ function buildPolicySection(bundle = {}, { viewer = 'recipient' } = {}) {
         'Keep most replies short: usually one or two sentences, and rarely more than one compact paragraph unless the peer explicitly asks for detail.',
         'Do not write essay-shaped replies. If your reply is over about 80 words, it must be because the peer explicitly asked for detail or the chat needs concrete clarification.',
         'Prefer plain, casual chat language over polished report language. It is fine to sound a little messy, quick, or conversational.',
+        'Keep wording conversational and translate framework words into normal chat; do not invent technical-sounding labels or repeat formal terms unless the peer is already using them.',
+        'Use Request Brief and World Context to understand the goal. When they include framework words or outline labels, turn them into plain chat unless the task or world explicitly asks for that format.',
         'Show natural reactions when appropriate: curiosity, amusement, uncertainty, disagreement, warmth, or mild pushback.',
         'Do not flatter by default. Agree only when you actually have a reason to agree, and say so plainly when something feels odd, unclear, exaggerated, or not your style.',
         'Treat the peer as another ordinary person, not as your owner, boss, or evaluator.',

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,

package/src/openclaw/runtime/feedback-helper.js

@@ -1,5 +1,5 @@
 import { resolveClaworldRuntimeConfig } from '../plugin/config-schema.js';
-import { buildRuntimeAuthHeaders } from '../plugin/account-identity.js';
+import { buildRuntimeAuthHeaders, resolveRuntimeAppToken } from '../plugin/account-identity.js';
 import { collectFeedbackDiagnostics } from './feedback-diagnostics.js';
 import { fetchJson, normalizeRelayHttpBaseUrl } from './http-boundary.js';
 
@@ -44,13 +44,15 @@ export async function submitFeedbackReport({
     throw new Error('fetch is unavailable for claworld feedback helper');
   }
 
+  const normalizedContext = normalizeObject(context);
+  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
   const resolvedAgentId = normalizeText(agentId, null);
   if (!resolvedAgentId) {
     throw new Error('claworld feedback helper requires agentId');
   }
-
-  const normalizedContext = normalizeObject(context);
-  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
+  if (!resolveRuntimeAppToken(resolvedRuntimeConfig)) {
+    throw new Error('claworld feedback helper requires appToken');
+  }
   const diagnostics = await collectFeedbackDiagnostics({
     cfg,
     runtime,