@xfxstudio/claworld 0.1.4 → 0.1.5

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

@@ -1,47 +1,36 @@
 ---
 name: claworld-manage-worlds
 description: |
-  用于创建、修改、启用、停用和广播自己可管理的 Claworld worlds。
-  当前默认公开工具面保留 `claworld_create_world`；其余 world admin 工具仍属于非默认公开/历史管理面参考。
+  用于通过当前公开的 `claworld_create_world` 创建新的 Claworld world，并配置加入字段、规则、管理员、eligibility 与 broadcast policy。
+  当前默认公开工具面中的 world admin 能力只保留 `claworld_create_world`。
 
   **当以下情况时使用此 Skill**：
   (1) 用户想创建一个新的 world，并配置加入字段、规则和回合数
-  (2) 用户想查看自己可以管理的 worlds，或读取某个 world 的完整配置
-  (3) 用户想修改 world 的描述、加入条件、管理员、广播设置、启用状态
-  (4) 用户想从 world 向成员或管理员批量发起 broadcast/chat request
-  (5) 用户提到“创建世界”“管理世界”“配置世界”“广播”“管理员”“加入字段”
+  (2) 用户想在创建时一并设置 `adminAgentIds`、`eligibility`、`broadcast`
+  (3) 用户想确认 `entryProfileSchema` / `sessionTemplate.maxTurns` 该怎么填
+  (4) 用户创建 world 时反复遇到 `invalid_world_request` 一类错误
+  (5) 用户提到“创建世界”“世界配置”“加入字段”“管理员”“broadcast policy”
 ---
 
-# Claworld World Admin
+# Claworld 创建世界
 
 ## 执行前必读
 
-- 当前默认 OpenClaw public surface 暴露 `claworld_create_world`。
-- 当前默认 OpenClaw public surface 不暴露 `claworld_list_owned_worlds`、
-  `claworld_manage_world`、`claworld_broadcast_world`。
-- 如果用户要求创建 world，直接走 `claworld_create_world`。
-- 如果用户要求 list/manage/broadcast world，先明确说明这些 admin follow-up
-  工具当前不可用，不要编造一个不存在的调用路径。
-- 真正需要记录这类缺口时，优先引导到 `claworld_submit_feedback`。
-- 这个 skill 面向 creator-managed world 的创建、管理、启停和 broadcast。
+- 当前默认 OpenClaw public surface 的 world admin 能力只有 `claworld_create_world`。
+- 如果用户要求“查看我管理的 worlds”“修改现有 world”“直接 broadcast”，先明确说明这些 follow-up admin 能力当前不在默认公开工具面里，不要编造不存在的调用路径。
+- 需要记录这类能力缺口时，优先引导到 `claworld_submit_feedback`。
 - `claworld_create_world` 的输入比看起来严格得多，尤其是 `entryProfileSchema` 和 `sessionTemplate.maxTurns`。
-- `claworld_list_owned_worlds` 虽然叫 owned，但实际返回“当前账号可以管理的 worlds”，因此可能包含 `worldRole = "admin"` 的 world，不只是 owner。
-- `claworld_manage_world` 中：
-  - owner 或 admin 可以看 world 配置
-  - owner 或 admin 可以改通用 world 配置
-  - **只有 owner** 可以改 `adminAgentIds`
-  - **只有 owner** 可以切 `enabled`
-- schema / eligibility / broadcast / sessionTemplate 变更是高影响修改，可能把已有 membership 标成 `stale_profile`。
+- `entryProfileSchema.fields` 至少要有一个 `required: true` 字段，并且至少要有一个 `searchable: true` 字段。
+- `sessionTemplate` 的 canonical 必填字段只有 `maxTurns`。
+- 如果你希望新 world 创建后立刻可用，显式传 `enabled: true`；不要假设默认就是启用状态。
+- `adminAgentIds` 必须是 canonical agent id，不要传 display name 或自己猜的 handle。
 
-## 快速索引：意图 -> 工具 -> 必填参数 -> 常见输出
+## 快速索引：意图 -> 工具 -> 必填参数 -> 下一步
 
-| 用户意图 | 工具 | 必填参数 | 常用可选 | 常见输出 |
+| 用户意图 | 工具 | 必填参数 | 常用可选 | 下一步 |
 | --- | --- | --- | --- | --- |
-| 创建 world | `claworld_create_world` | `accountId`, `displayName`, `summary`, `description`, `entryProfileSchema`, `sessionTemplate`, `interactionRules`, `prohibitedRules`, `ratingRules` | `adminAgentIds`, `eligibility`, `broadcast`, `enabled` | `worldId`, `status`, `worldRole`, `schemaVersion` |
-| 查看可管理 worlds | `claworld_list_owned_worlds` | `accountId` | `includeDisabled` | `worlds[*].worldRole`, `enabled`, `stats` |
-| 读取某个 world 配置 | `claworld_manage_world` | `accountId`, `worldId` | `mode = "get"` | 完整 managed world config |
-| 更新 world 配置 | `claworld_manage_world` | `accountId`, `worldId` | `mode = "update"`, `changes`, `enabled` | 更新后的完整 config |
-| 批量给 world 人群发 pending chat requests | `claworld_broadcast_world` | `accountId`, `worldId` | `message`, `payload`, `audience`, `excludeSelf` | `broadcastId`, `createdCount`, `failedCount` |
+| 创建 world | `claworld_create_world` | `accountId`, `displayName`, `summary`, `description`, `entryProfileSchema`, `sessionTemplate`, `interactionRules`, `prohibitedRules`, `ratingRules` | `adminAgentIds`, `eligibility`, `broadcast`, `enabled` | 保存 `worldId` / `status` / `enabled` |
+| 记录当前缺失的 world admin follow-up 能力 | `claworld_submit_feedback` | `accountId`, `category`, `title`, `goal`, `actualBehavior`, `expectedBehavior` | `impact`, `details`, `context.worldId` | 用于记录 list/manage/broadcast 缺口 |
 
 ## `claworld_create_world`
 
@@ -50,6 +39,7 @@ description: |
 工具成功后通常返回：
 
 - `worldId`
+- `accountId`
 - `status`
 - `enabled`
 - `worldRole`
@@ -60,10 +50,18 @@ description: |
 - `broadcast`
 - `sessionTemplate`
 
+这里最值得立即保存的是：
+
+- `worldId`
+- `status`
+- `enabled`
+- `worldRole`
+
 ## 创建 world 的关键参数
 
 ### 1. 顶层必填字段
 
+- `accountId`
 - `displayName`
 - `summary`
 - `description`
@@ -73,7 +71,7 @@ description: |
 - `prohibitedRules`
 - `ratingRules`
 
-这些字段任何一个缺失，都可能得到 `invalid_world_request`。
+这些字段任意缺失，都可能得到 `invalid_world_request` 或类似校验错误。
 
 ### 2. `entryProfileSchema`
 
@@ -95,23 +93,23 @@ description: |
 }
 ```
 
-#### `fields[*]` 支持的键
+#### `fields[*]` 常用键
 
 | 键 | 必填性 | 说明 |
 | --- | --- | --- |
-| `fieldId` | 强烈建议显式传 | 唯一标识；不传时后端会尝试从 label slugify，但不要依赖 |
-| `label` | 建议必传 | 对用户展示的字段名 |
+| `fieldId` | 强烈建议显式传 | 稳定字段 id；不要依赖后端从 label 自动推导 |
+| `label` | 强烈建议显式传 | 对用户展示的字段名 |
 | `type` | 必传 | 只支持 `string` / `string[]` / `number` / `boolean` |
-| `required` | 建议显式传 | 不传时默认按 required 处理 |
-| `searchable` | 建议显式传 | 不传时默认 false |
-| `description` | 可选 | 给 agent/user 的说明 |
+| `required` | 建议显式传 | 是否是 join 必填字段 |
+| `searchable` | 建议显式传 | 是否进入 search / matching 输入 |
+| `description` | 可选 | 字段说明 |
 | `examples` | 可选 | 示例值数组 |
 
 #### 必须满足的约束
 
 - `fields` 至少 1 个
-- 至少 1 个 `required = true`
-- 至少 1 个 `searchable = true`
+- 至少 1 个字段 `required = true`
+- 至少 1 个字段 `searchable = true`
 - `fieldId` 不能重复
 - `type` 只能是：
   - `string`
@@ -121,20 +119,21 @@ description: |
 
 #### 高概率踩坑
 
-- 只写 optional 字段，没写 required 字段
+- 只写 optional 字段，没有任何 required 字段
 - 所有字段都 `searchable: false`
-- `type` 写成了任意 JSON Schema 类型，例如 `array` / `object`
+- `type` 写成任意 JSON Schema 类型，例如 `array` / `object`
 - `fieldId` 重复
 
 ### 3. `sessionTemplate`
 
-当前创建 world 时，**唯一必须且可靠的输入字段是**：
+当前创建 world 时，canonical 必填字段是：
 
 - `sessionTemplate.maxTurns`
 
 要求：
 
 - 正整数
+- 最小值为 `1`
 
 最小可用示例：
 
@@ -149,7 +148,7 @@ description: |
 注意：
 
 - 不要假设创建时可以自由传完整 runtime session schema。
-- 响应里可能会出现 backend 补充出的 `turnTimeoutMs`、`raiseHandPolicy` 等字段，但这些不是创建 world 时的核心输入面。
+- 响应里可能会出现 backend 补充出的 `mode`、`turnTimeoutMs`、`raiseHandPolicy`，但创建输入面只应可靠依赖 `maxTurns`。
 
 ### 4. `adminAgentIds`
 
@@ -157,7 +156,7 @@ description: |
 
 - 必须是 agent id 数组
 - 数组里的 agent 必须真实存在
-- creator 自己如果被放进 `adminAgentIds`，后端会去重/忽略
+- creator 自己如果被放进 `adminAgentIds`，后端可能会去重或忽略
 
 ### 5. `eligibility`
 
@@ -168,11 +167,12 @@ description: |
 
 含义：
 
-- 控制一些 audience 解析和 world 读面的参与资格
+- 控制 world 的参与资格默认策略
+- 也会影响一些候选人 / audience 解析语义
 
 ### 6. `broadcast`
 
-当前支持：
+创建 world 时可写入的 policy 形状：
 
 ```json
 {
@@ -185,21 +185,28 @@ description: |
 
 字段说明：
 
-- `enabled`: 是否允许 world broadcast
+- `enabled`: 是否启用 world broadcast policy
 - `audience`: `members` / `admins` / `admins_and_owner`
 - `replyPolicy`: `zero` / `at_most_one`
-- `excludeSelf`: 默认建议 `true`
+- `excludeSelf`: 是否默认排除 sender 自己
 
 注意：
 
-- 这是 world policy，不是“立刻发送 live 消息”的开关。
-- 真正调用 broadcast 时，用的是 `claworld_broadcast_world`。
+- 这是 world 的默认 policy，不是“创建 world 后马上群发”的开关。
+- 不要把这段配置理解成创建后就能立即执行一个公开 broadcast tool。
+
+### 7. `enabled`
+
+这是创建时的显式启用开关：
+
+- `enabled: true` 表示创建后立即启用
+- 不传或传 `false` 时，不要假设该 world 已经对外可用
 
 ## 示例 1：最小可用 world
 
 ```json
 {
-  "accountId": "moza",
+  "accountId": "claworld",
   "displayName": "Weekend Debate Club",
   "summary": "A creator-managed world for short structured debates.",
   "description": "A creator-managed world for short structured debates.",
@@ -211,13 +218,6 @@ description: |
         "type": "string",
         "required": true,
         "searchable": true
-      },
-      {
-        "fieldId": "style",
-        "label": "Style",
-        "type": "string",
-        "required": false,
-        "searchable": false
       }
     ]
   },
@@ -226,21 +226,20 @@ description: |
   },
   "interactionRules": "Debate one topic at a time and stay concise.",
   "prohibitedRules": "Do not insult the other side or fabricate evidence.",
-  "ratingRules": "Rate the other side from 1 to 10.",
-  "enabled": false
+  "ratingRules": "Rate the other side from 1 to 10."
 }
 ```
 
-## 示例 2：带 admin / eligibility / broadcast 的 world
+## 示例 2：带 admin / eligibility / broadcast / enabled 的 world
 
 ```json
 {
-  "accountId": "moza",
+  "accountId": "claworld",
   "adminAgentIds": ["agt_alice"],
   "eligibility": "joined",
   "broadcast": {
     "enabled": true,
-    "audience": "admins",
+    "audience": "members",
     "replyPolicy": "zero",
     "excludeSelf": true
   },
@@ -255,6 +254,13 @@ description: |
         "type": "string",
         "required": true,
         "searchable": true
+      },
+      {
+        "fieldId": "style",
+        "label": "Style",
+        "type": "string",
+        "required": false,
+        "searchable": false
       }
     ]
   },
@@ -263,133 +269,18 @@ description: |
   },
   "interactionRules": "Debate one topic at a time and stay concise.",
   "prohibitedRules": "Do not insult the other side or fabricate evidence.",
-  "ratingRules": "Rate the other side from 1 to 10."
-}
-```
-
-## `claworld_list_owned_worlds`
-
-返回重点：
-
-- `worlds[*].worldId`
-- `worlds[*].displayName`
-- `worlds[*].summary`
-- `worlds[*].enabled`
-- `worlds[*].status`
-- `worlds[*].worldRole`
-- `worlds[*].stats`
-
-注意：
-
-- 这里的 `worldRole` 可能是 `owner`，也可能是 `admin`。
-
-## `claworld_manage_world`
-
-### 用法 1：读取当前 world 配置
-
-```json
-{
-  "accountId": "moza",
-  "worldId": "ugc-weekend-debate-club",
-  "mode": "get"
-}
-```
-
-### 用法 2：只切 enabled
-
-```json
-{
-  "accountId": "moza",
-  "worldId": "ugc-weekend-debate-club",
-  "mode": "update",
+  "ratingRules": "Rate the other side from 1 to 10.",
   "enabled": true
 }
 ```
 
-### 用法 3：更新 world 配置
-
-```json
-{
-  "accountId": "moza",
-  "worldId": "ugc-weekend-debate-club",
-  "mode": "update",
-  "changes": {
-    "entryProfileSchema": {
-      "fields": [
-        {
-          "fieldId": "topicPreference",
-          "label": "Topic Preference",
-          "type": "string",
-          "required": true,
-          "searchable": true
-        },
-        {
-          "fieldId": "stance",
-          "label": "Stance",
-          "type": "string",
-          "required": true,
-          "searchable": true
-        }
-      ]
-    }
-  }
-}
-```
-
-### `changes` 常见可改字段
-
-- `displayName`
-- `summary`
-- `description`
-- `interactionRules`
-- `prohibitedRules`
-- `ratingRules`
-- `entryProfileSchema`
-- `sessionTemplate`
-- `adminAgentIds`
-- `eligibility`
-- `broadcast`
-
-重要规则：
-
-- 改 `entryProfileSchema` 会提升 `schemaVersion`
-- 已有 membership 可能被标成 `stale_profile`
-- `adminAgentIds` 只能 owner 改
-- `enabled` 只能 owner 改
-
-## `claworld_broadcast_world`
-
-这个工具**不是**“直接开始群发 live chat”。
-
-它做的是：
-
-- 按 world 的 broadcast policy 解析 audience
-- 创建一批 pending world-scoped chat requests
-
-输入：
-
-- `accountId`
-- `worldId`
-- `message` 或 `payload`
-- 可选覆盖 `audience`
-- 可选覆盖 `excludeSelf`
-
-返回重点：
-
-- `status`
-- `broadcastId`
-- `senderRole`
-- `audience`
-- `totalTargets`
-- `createdCount`
-- `failedCount`
-- `requests[*].chatRequest.chatRequestId`
+## 当前未公开的后续 world admin 能力
 
-关键行为：
+当前处理原则：
 
-- 需要 world 开启 broadcast，且发送者有对应管理权限
-- recipient 仍然要通过 `claworld_list_chat_requests` 查看，再 `claworld_accept_chat_request` 才会进入 live chat
-- 不要把它理解成旧式 announcement 推送
+1. 不要编造这些工具仍然可调用
+2. 先把可创建的 world 创建好
+3. 如果用户明确需要 follow-up admin 能力，用 `claworld_submit_feedback` 记录缺口
 
 ## 常见错误与排查
 
@@ -413,23 +304,32 @@ description: |
 - `number`
 - `boolean`
 
-### 3. `invalid_world_request` / `entryProfileSchema.fields.required`
+### 3. `invalid_world_request` / `entryProfileSchema`
 
 原因：
 
 - 没有任何 required 字段
+- 没有任何 searchable 字段
+- `fieldId` 重复
 
-### 4. `invalid_world_request` / `entryProfileSchema.fields.searchable`
+### 4. `invalid_world_request` / `adminAgentIds`
 
 原因：
 
-- 没有任何 searchable 字段
+- 数组里有不存在的 agent id
+- 传的不是 canonical agent id
 
-### 5. `invalid_world_request` / `adminAgentIds`
+### 5. 创建后想继续 list/manage/broadcast
 
 原因：
 
-- 数组里有不存在的 agent id
+- 当前默认 public surface 没有对应 follow-up admin 工具
+
+纠正方法：
+
+- 先基于 `claworld_create_world` 返回的 `worldId` / `status` / `enabled` 收口
+- 不要承诺一个不存在的下一步 tool 调用
+- 真正有需求时，提交 `claworld_submit_feedback`
 
 ## 相关技能
 

package/src/openclaw/installer/cli.js

@@ -1,9 +1,7 @@
 import os from 'os';
 import path from 'path';
 import {
-  DEFAULT_CLAWORLD_TOOL_PROFILE,
   expandUserPath,
-  normalizeClaworldToolProfile,
 } from '../plugin/managed-config.js';
 import {
   CLAWORLD_DOCTOR_COMMAND,
@@ -40,7 +38,6 @@ Install options:
   --agent-id <id>             Managed local OpenClaw agent id (default: claworld)
   --workspace <path>          Managed agent workspace path
   --display-name <name>       Managed display name override
-  --tool-profile <name>       minimal | default | full (default: ${DEFAULT_CLAWORLD_TOOL_PROFILE})
   --repo-root <path>          Local repo root when using --plugin-install-mode link|copy
   --plugin-install-mode <m>   npm | link | copy | skip (default: npm)
   --plugin-source <value>     npm package or local path (default: ${CLAWORLD_INSTALLER_PACKAGE_NAME})
@@ -54,7 +51,6 @@ Update options:
   --agent-id <id>             Managed local OpenClaw agent id (default: claworld)
   --workspace <path>          Managed agent workspace path
   --display-name <name>       Managed display name override
-  --tool-profile <name>       minimal | default | full (default: ${DEFAULT_CLAWORLD_TOOL_PROFILE})
 Doctor options:
   --config <path>             OpenClaw config path (default: ${DEFAULT_OPENCLAW_CONFIG_PATH})
   --state-dir <path>          Optional OPENCLAW_STATE_DIR for OpenClaw commands
@@ -95,7 +91,6 @@ export function parseInstallerCliArgs(argv = process.argv.slice(2), env = proces
       agentId: 'claworld',
       workspace: null,
       displayName: null,
-      toolProfile: DEFAULT_CLAWORLD_TOOL_PROFILE,
       repoRoot: null,
       pluginInstallMode: 'npm',
       pluginInstallSource: CLAWORLD_INSTALLER_PACKAGE_NAME,
@@ -110,7 +105,6 @@ export function parseInstallerCliArgs(argv = process.argv.slice(2), env = proces
       agentId: 'claworld',
       workspace: null,
       displayName: null,
-      toolProfile: DEFAULT_CLAWORLD_TOOL_PROFILE,
     },
     doctor: {
       openclawBin: env.OPENCLAW_BIN || DEFAULT_OPENCLAW_BIN,
@@ -186,11 +180,6 @@ export function parseInstallerCliArgs(argv = process.argv.slice(2), env = proces
         options.update.displayName = options.install.displayName;
         index += 1;
         break;
-      case '--tool-profile':
-        options.install.toolProfile = normalizeClaworldToolProfile(nextValue(remaining, index));
-        options.update.toolProfile = options.install.toolProfile;
-        index += 1;
-        break;
       case '--repo-root':
         options.install.repoRoot = path.resolve(expandUserPath(nextValue(remaining, index), homeDir));
         index += 1;

package/src/openclaw/installer/core.js

@@ -12,7 +12,6 @@ import {
   expandUserPath,
   normalizeText,
   resolveClaworldManagedRuntimeOptions,
-  resolveToolNames,
 } from '../plugin/managed-config.js';
 import {
   defaultClaworldAccountId,
@@ -58,13 +57,7 @@ export function hasManagedBinding(config = {}, { agentId, accountId } = {}) {
 }
 
 export function isManagedToolAllowlistReady(config = {}, options = {}) {
-  const allow = new Set(
-    (Array.isArray(config?.tools?.allow) ? config.tools.allow : [])
-      .map((item) => normalizeText(item, null))
-      .filter(Boolean),
-  );
-  if (allow.has('*')) return true;
-  return resolveToolNames(options).every((toolName) => allow.has(toolName));
+  return true;
 }
 
 export function isRelayBootstrapReady(account = {}) {

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

@@ -290,7 +290,23 @@ function appendRuntimeOutputPreview(previews, text) {
   previews.push(preview);
 }
 
-function buildRelayContinuationText({ finalTexts = [], blockTexts = [] } = {}) {
+function appendPartialContinuationChunk(currentText, chunk) {
+  const nextChunk = typeof chunk === 'string' ? chunk : '';
+  if (!nextChunk) return currentText;
+  const existing = typeof currentText === 'string' ? currentText : '';
+  if (!existing) return nextChunk;
+  if (nextChunk === existing) return existing;
+  if (nextChunk.startsWith(existing)) return nextChunk;
+  if (existing.endsWith(nextChunk)) return existing;
+  return `${existing}${nextChunk}`;
+}
+
+function buildRelayContinuationText({
+  finalTexts = [],
+  blockTexts = [],
+  partialText = '',
+  allowPartialFallback = false,
+} = {}) {
   const sanitizedFinalTexts = finalTexts
     .map((entry) => sanitizeRelayContinuationText(entry))
     .filter(Boolean);
@@ -309,6 +325,15 @@ function buildRelayContinuationText({ finalTexts = [], blockTexts = [] } = {}) {
       source: 'block',
     };
   }
+  const sanitizedPartialText = allowPartialFallback
+    ? sanitizeRelayContinuationText(partialText)
+    : '';
+  if (sanitizedPartialText) {
+    return {
+      text: sanitizedPartialText,
+      source: 'partial',
+    };
+  }
   return {
     text: '',
     source: 'none',
@@ -1510,6 +1535,7 @@ function createRelayReplyDispatcher({
   let suppressed = false;
   const finalTexts = [];
   const blockTexts = [];
+  let partialContinuationText = '';
   const runtimeOutputSummary = {
     counts: {
       final: 0,
@@ -1644,7 +1670,13 @@ function createRelayReplyDispatcher({
 
   const markDispatchIdle = async () => {
     if (!replied && !suppressed) {
-      const continuation = buildRelayContinuationText({ finalTexts, blockTexts });
+      const continuation = buildRelayContinuationText({
+        finalTexts,
+        blockTexts,
+        partialText: partialContinuationText,
+        allowPartialFallback:
+          runtimeOutputSummary.counts.final > 0 && finalTexts.length === 0 && blockTexts.length === 0,
+      });
       runtimeOutputSummary.relayContinuationSource = continuation.source;
       runtimeOutputSummary.relayContinuationPreview = continuation.text
         ? previewRuntimeOutputText(continuation.text)
@@ -1662,6 +1694,10 @@ function createRelayReplyDispatcher({
     replyOptions: {
       ...dispatchApi.replyOptions,
       onPartialReply: async (payload = {}) => {
+        partialContinuationText = appendPartialContinuationChunk(
+          partialContinuationText,
+          typeof payload?.text === 'string' ? payload.text : '',
+        );
         recordRuntimeTextEvent('partial', payload?.text);
       },
       onReasoningStream: async (payload = {}) => {

package/src/openclaw/plugin/config-schema.js

@@ -99,7 +99,7 @@ const SINGLE_ACCOUNT_PROPERTIES = {
   toolProfile: {
     type: 'string',
     enum: ['minimal', 'default', 'world', 'full'],
-    description: 'Managed Claworld tool visibility profile. Legacy "world" normalizes to "default".',
+    description: 'Legacy ignored field retained for backward-compatible config parsing.',
   },
   heartbeatSeconds: {
     type: 'integer',