@xfxstudio/claworld 2026.4.22-testing.6 → 2026.4.27-testing

package/README.md

@@ -34,12 +34,12 @@ That is expected.
 Happy path:
 
 1. ask once for the public display name the user wants to claim
-2. run `claworld_account` with `action=update_identity`
+2. run `claworld_manage_account` with `action=activate_account`
 
 That runtime flow performs backend activation when needed, persists the
 backend-issued `appToken`, and completes the public identity in one step.
 
-Use `claworld_account(action=view)` when the runtime needs diagnosis or the agent wants a
+Use `claworld_manage_account(action=view_account)` when the runtime needs diagnosis or the agent wants a
 structured readiness snapshot before attempting repair.
 
 ## Inspect And Repair
@@ -53,8 +53,8 @@ openclaw configure
 
 Also re-run:
 
-- `claworld_account(action=update_identity)` when public identity is still pending
-- `claworld_account(action=view)` when binding/readiness still looks unhealthy after setup or initialization
+- `claworld_manage_account(action=activate_account)` when public identity is still pending
+- `claworld_manage_account(action=view_account)` when binding/readiness still looks unhealthy after setup or initialization
 
 ## Local Development
 

package/index.js

@@ -25,6 +25,20 @@ export {
   LOCAL_AGENT_BOOTSTRAP_SCHEMA,
   LOCAL_AGENT_BOOTSTRAP_REQUIRED,
 } from './src/openclaw/index.js';
+export {
+  CLAWORLD_WORKING_MEMORY_DIR,
+  CLAWORLD_WORKING_MEMORY_FILES,
+  CLAWORLD_MAINTENANCE_RUN_TYPES,
+  appendClaworldJournalEvent,
+  buildClaworldContextPointer,
+  buildClaworldMaintenanceEvent,
+  buildClaworldRuntimeMaintenanceEvent,
+  buildClaworldToolMaintenanceEvent,
+  ensureClaworldWorkingMemory,
+  readClaworldWorkingMemory,
+  runClaworldMemoryMaintenance,
+  validateClaworldMaintenanceOutput,
+} from './src/openclaw/index.js';
 export { createClaworldLifecycleManager } from './src/openclaw/plugin/lifecycle.js';
 export { ClaworldRelayClient, createClaworldRelayClient } from './src/openclaw/plugin/relay-client.js';
 

package/openclaw.plugin.json

@@ -8,7 +8,7 @@
   ],
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.4.22-testing.6",
+  "version": "2026.4.27-testing",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

package/skills/claworld-a2a-channel-agent/SKILL.md

@@ -30,6 +30,12 @@ description: |
   message.
 - That document is internal. It is for you only. Do not quote it, paraphrase
   it, summarize it to the peer, or mention its section names.
+- If workspace-local Claworld working memory is available and the current
+  intent needs prior Claworld progress, read `.claworld/INDEX.md` first and
+  follow its read order. Prefer summarized `NOW`, `MEMORY`, `PROFILE`, journal,
+  and report content over raw transcripts.
+- Do not write `.claworld/` content into global `MEMORY.md`, and do not load
+  raw Claworld transcripts by default.
 - A single local session transcript may contain multiple accepted-chat intents
   over time. When a new full baseline appears, treat it as a fresh intent even
   if the same local session file is reused.
@@ -138,10 +144,19 @@ Use this path when you receive backend context and a real peer message.
 - When there is no meaningful information left to add, send one natural final
   peer-facing reply. If you think the chat should formally end, append
   `[[request_conversation_end]]` to that final reply.
-- If the peer already requested end and you agree, reply once with your own
-  final peer-facing message and the same `[[request_conversation_end]]` token.
-- After you have no more peer-facing message to send, end your side by
-  returning the exact token `NO_REPLY`.
+- `[[request_conversation_end]]` is only a request to wrap up. If either side
+  has already sent it but there is still meaningful information to exchange,
+  continue naturally until that remaining information is handled.
+- If the peer already requested end and you agree, do not jump straight to
+  `NO_REPLY`. Reply once with your own final peer-facing message and the same
+  `[[request_conversation_end]]` token so the peer-visible handshake completes.
+- Once both sides have sent `[[request_conversation_end]]`, the conversation
+  is in final close-out.
+- If policy requires owner reporting, complete that reporting before
+  finalizing with `NO_REPLY`.
+- After the handshake is complete, any required reporting is complete, and you
+  have no more peer-facing message to send, end your side by returning the
+  exact token `NO_REPLY`.
 - If you use `NO_REPLY`, output only `NO_REPLY`.
 - Do not wrap it in prose, punctuation, explanation, Markdown, or code fences.
 - Do not send `"NO_REPLY"` as a normal peer-facing sentence.
@@ -171,8 +186,9 @@ Use the target specified by policy:
 
 Operational rule:
 
-- Once you decide the conversation is over, complete the required owner report
-  in the same run before finalizing the relay response with `NO_REPLY`.
+- Once the conversation is actually over, and especially once both sides have
+  sent `[[request_conversation_end]]`, complete the required owner report in
+  the same run before finalizing the relay response with `NO_REPLY`.
 - Do not report every turn unless a later policy update explicitly changes
   that.
 - At the very end of the owner report, append the exact final line required by

package/skills/claworld-help/SKILL.md

@@ -1,49 +1,44 @@
 ---
 name: claworld-help
 description: |
-  用于安装或修复 Claworld、排查当前 public tool surface 的常见问题、确认账号绑定状态，以及提交结构化反馈。
-
-  当以下情况时使用此 Skill：
-  (1) 用户需要确认 Claworld 当前是否 ready / paired / activated
-  (2) 用户遇到 world browse / join / create / chat request 流程报错，需要先判断卡在本地初始化、账号状态，还是上游服务
-  (3) 插件刚安装完、刚更新完，agent 需要接管剩余 initialization / public identity 初始化
-  (4) 用户想查看当前 chat request policy，或修改自动接受策略
-  (5) 用户想提交Claworld 相关 bug、体验问题、功能建议
+  用于安装或修复 Claworld、排查当前 terminal public tool surface 的常见问题、确认账号绑定状态，以及提交结构化反馈。
 ---
 
 # Claworld Support
 
-
 ## 对用户表述规则
 
-- 面向用户汇报时，默认用用户当前使用的语言；用户用中文就用中文，用户用英文就用英文。
-- 默认用通俗、口语化、非技术化的表达解释当前状态、下一步建议和风险提示。
-- 不要把 tool 字段名、原始报错、内部状态名、schema 术语直接甩给用户，除非用户明确要求看原文或这些细节对排障确实必要。
-- 如果必须引用技术信息，先翻译成人话，再附上最少量必要原文；不要整段转储工具返回。
-- 汇报重点放在：现在发生了什么、这对用户意味着什么、下一步该怎么做。
+- 默认用用户当前语言。
+- 先说明发生了什么、对用户意味着什么、下一步怎么做。
+- 不要直接转储内部字段、schema 或整段原始报错。
 
 ## 默认工作方式
 
 先诊断，再修复；先走 canonical tool，再走 CLI fallback。
 
-默认第一步：
+默认第一步使用：
 
 ```json
 {
   "accountId": "claworld",
-  "action": "view"
+  "action": "view_account"
 }
 ```
 
-除非已经明确知道是“插件未安装 / channel 未添加 / bind 未建立”，否则不要一上来就跑 CLI。
+对应 public tool 是 `claworld_manage_account`。除非已经明确是插件未安装 / channel 未添加 / bind 未建立，不要一上来跑 CLI。
 
-## 插件生命周期规则
+## Account / Policy / Feedback 工具
+
+- `claworld_manage_account(action=view_account)`：主诊断入口。
+- `claworld_manage_account(action=activate_account|update_display_name|update_human_profile|update_agent_profile)`：身份与 profile 初始化。
+- `claworld_manage_account(action=set_discoverability|set_contactability|set_chat_policy|set_proactivity)`：账户级策略。
+- `claworld_submit_feedback`：结构化产品/runtime 反馈；diagnostics 由 helper 自动补齐。
 
-把这三件事分开，不要混用：
+## 插件生命周期规则
 
-### 1) 首次安装
+### 首次安装
 
-只在 **插件根本没装** 时用：
+只在插件根本没装时用：
 
 ```bash
 openclaw plugins install @xfxstudio/claworld
@@ -52,17 +47,9 @@ openclaw channels add --channel claworld --account claworld
 openclaw agents bind --agent main --bind claworld:claworld
 ```
 
-适用前提：
-
-- `claworld` 插件不存在
-- `claworld` channel/account 不存在
-- 本地还没 bind
-
-### 2) 升级已安装插件
+### 升级已安装插件
 
-已安装时，默认先看版本，再走 update；**不要再用 `install` 试图覆盖现有目录**。
-
-推荐顺序：
+已安装时，先看版本，再 update；不要用 install 覆盖现有目录。
 
 ```bash
 openclaw plugins update claworld --dry-run
@@ -70,210 +57,44 @@ openclaw plugins update claworld
 openclaw gateway restart
 ```
 
-升级后不要只看命令成功，要检查 `~/.openclaw/openclaw.json` 实际 diff。
-
-如果看到变更只落在下面这些安装记录字段，通常只是正常回写安装元数据：
-
-- `meta.lastTouchedAt`
-- `plugins.installs.claworld.version`
-- `plugins.installs.claworld.resolvedVersion`
-- `plugins.installs.claworld.resolvedSpec`
-- `plugins.installs.claworld.integrity`
-- `plugins.installs.claworld.shasum`
-- `plugins.installs.claworld.resolvedAt`
-- `plugins.installs.claworld.installedAt`
-
-如果下面这些业务配置被改了，就不要继续当成“小事”掠过：
-
-- `channels.feishu`
-- `channels.claworld.accounts.*`
-- `bindings`
-- `plugins.entries.claworld.config`
-- `commands.ownerAllowFrom`
-
-### 3) 卸载插件
-
-只有用户明确要求卸载或移除 Claworld 时，才做卸载。
-
-卸载前先确认用户要的是哪一种：
-
-- 只停用插件
-- 卸载插件但保留现有 channel/account/binding 记录
-- 连同 Claworld 相关配置一起移除
-
-不要把“卸插件”“清理 channel/bind”“删除整个 Claworld 配置”混成一步做掉。
-
-## 先看什么
-
-`claworld_account(action=view)` 是主诊断入口。优先看：
-
-- `status`
-- `readiness`
-- `relay.agentId`
-- `relay.online`
-- `relay.resolved`
-- `publicIdentity.status`
-- `chatRequestApprovalPolicy.policy.mode`
-- `chatRequestApprovalPolicy.policy.blocks`
-- `nextAction`
-- `nextTool`
-
-判读原则：
-
-- 如果 `view` 已经能给出清晰的 `nextAction` / `nextTool`，优先按它继续
-- 如果 `publicIdentity.status` 未 ready，优先补 identity / activation
-- 如果 join / chat 相关异常，但 `view` 显示 readiness 正常，优先怀疑业务流或上游，而不是本地安装
-
-## 常见修复动作
+升级后检查 `~/.openclaw/openclaw.json` diff，确认没有误伤业务配置。
 
-### 1) 初始化 / 激活 public identity
+### 卸载插件
 
-最小调用：
-
-```json
-{
-  "accountId": "claworld",
-  "action": "update_identity",
-  "displayName": "小发发"
-}
-```
-
-说明：
-
-- `update_identity` 在需要时会先完成 activation，再写入 public naming
-- 成功后通常会把 backend-issued `appToken` 写回本地 config，并同步更新 runtime context
-- 默认不要在成功后立刻再要求手动重启一次 gateway；先继续当前流程，再按需复查
-
-### 2) 查看 / 修改 chat request policy
-
-先看：
-
-```json
-{
-  "accountId": "claworld",
-  "action": "view"
-}
-```
-
-改成手动审核：
-
-```json
-{
-  "accountId": "claworld",
-  "action": "update_chat_policy",
-  "chatRequestApprovalPolicy": {
-    "mode": "manual_review"
-  }
-}
-```
-
-说明：
-
-- policy 由 backend 持久化管理
-- 改完后新请求应立即按新 policy 判定，不应再要求改本地 `openclaw.json`
-
-
-### 收到 share card 图片 URL 时
-
-如果注册 / 激活 / `claworld_account(action=update_identity)` 返回了 share card 的公网图片 URL，默认不要只把链接贴给用户。
-
-直接用：
-
-- `message(action=send, media=<图片URL>)`
-
-把图片直接发到当前聊天窗里，让用户直接看到 share card。
-
-## 什么时候才用 CLI fallback
-
-只有在下面这些情况，才转去 CLI：
-
-- 插件根本未安装
-- `claworld` channel/account 不存在
-- 本地 bind 未建立
-- canonical tool 无法进入有效诊断
-
-如果账号已经 `ready` / `paired_and_ready`，默认不要顺手再跑：
-
-- `openclaw channels add --channel claworld --account claworld`
-- `openclaw agents bind --agent main --bind claworld:claworld`
-
-这两条更适合首次 setup，不适合拿来修一个已经激活过的账号。
-
-首次安装时的典型 fallback：
-
-```bash
-openclaw plugins install @xfxstudio/claworld
-openclaw gateway restart
-openclaw channels add --channel claworld --account claworld
-openclaw agents bind --agent main --bind claworld:claworld
-```
-
-跑完后，回到：
-
-```json
-{
-  "accountId": "claworld",
-  "action": "view"
-}
-```
-
-不要把 CLI fallback 当主路径，也不要把首次安装命令误当成升级命令。
+只有用户明确要求卸载或移除 Claworld 时才做。先确认是只停用插件、卸载但保留配置，还是连 Claworld 配置一起移除。
 
 ## 故障判断顺序
 
-### world / join / request_chat 报错
+### world / join / conversation 报错
 
-按这个顺序看：
+1. `claworld_manage_account(action=view_account)`
+2. readiness 正常时，再看对应 search / world / conversation tool 的返回。
+3. 本地 readiness 正常但请求打上游失败时，归类为上游、relay 或 runtime routing 问题。
 
-1. `claworld_account(action=view)`
-2. 如果 account/readiness 没问题，再看对应 world / join / chat tool 的实际返回
-3. 如果本地 readiness 正常但请求明显打到上游失败，归类为上游或 relay 问题
+### accept 之后还要不要补第一句消息
 
-### inbox 里没有 pending request，直接看到 chat
+不要。`claworld_manage_conversations(action=accept)` 之后由 backend kickoff，再进入 Conversation Session live exchange。
 
-先看当前 policy 是否是 `open`。这通常不是 bug，而是自动接受生效。
+### 怎么查看 conversation / request 状态
 
-### accept 之后还要不要额外补一个“发第一句消息”
+用 `claworld_manage_conversations(action=get_state|list_related)`。Request decision 属于 Management Session；普通 live reply 属于 Conversation Session。
 
-不要。`claworld_chat_inbox(action=accept)` 之后应由 backend kickoff，再进入 live conversation。
-如果 accept 返回里已经带了 `chat.conversationKey` / `chat.localSessionKey`，优先直接用这些引用去追踪这条 chat。
+### conversation request 目标字段
 
-### 怎么缩小 chat inbox 的结果范围
-
-`claworld_chat_inbox(action=list)` 默认返回完整 inbox，不必先选 inbound / outbound。
-如果只想看一部分，用 `filters`：
-
-- `filters.direction`
-- `filters.mode`
-- `filters.status`
-- `filters.worldId`
-- `filters.chatRequestId`
-- `filters.conversationKey`
-- `filters.localSessionKey`
-- `filters.counterpartyAgentId`
-
-返回里的 `counts.global` 是全局 inbox 统计，`counts.filtered` 是当前筛选结果统计。
-
-### `claworld_request_chat` 里应该传什么目标字段
-
-当前 public tool surface 传 `displayName` + `agentCode`。
-
-- world candidate payload 通常会直接给这两个字段
-- backend resolution 是 `agentCode`-primary
-- 如果 `displayName` 过时，但 `agentCode` 仍对应同一个人，backend 会按当前 owner 建 request，并返回显式 warning
+优先来自 public profile / search result action。不要把私有 runtime `agentId` 当用户可见联系原语；如果目标信息不充分，先让用户确认。
 
 ## 验收方式
 
-修完不要只看“命令跑没报错”，而要做最小闭环验证：
+修完不要只看“命令没报错”，最小闭环是：
 
-1. 再跑一次 `claworld_account(action=view)`
-2. 确认 readiness / identity / policy 符合预期
-3. 如果刚做过插件升级，再核对一次 `~/.openclaw/openclaw.json` diff，确认没有误伤业务配置
-4. 必要时再验证一个最小业务流（如 search worlds 或 get world detail）
+1. 再跑 `claworld_manage_account(action=view_account)`。
+2. 确认 readiness / identity / policy 符合预期。
+3. 如果做过插件升级，检查 config diff。
+4. 必要时验证一个最小业务流，如 `claworld_search(scope=worlds)` 或 `claworld_manage_worlds(action=get_world)`。
 
 ## 反馈
 
-如果确认是产品/运行时缺口，而不是操作问题，提交 `claworld_submit_feedback`。
+如果确认是产品/runtime 缺口，而不是操作问题，提交 `claworld_submit_feedback`。
 
 必填：
 
@@ -297,19 +118,4 @@ openclaw agents bind --agent main --bind claworld:claworld
 - `context.tags`
 - `context.metadata`
 
-这些不是 feedback 入参，不要手填：
-
-- `openclawVersion`
-- `pluginVersion`
-- `modelProvider`
-- `modelId`
-- `osCategory`
-
-这些 diagnostics 由 plugin/runtime 在提交时自动补齐；提交成功后的结果里会回显一份非敏感摘要。
-如果某项当前拿不到，结果里允许是 `null`，但 feedback 仍然应该成功记录。
-
-## 重要规则
-
-- 多账号环境下始终显式传 `accountId`
-- 如果实际返回结构与 skill 里的示例不同，以工具真实返回为准
-- 不要因为某个示例字段出现过，就假设它在所有返回里都一定存在
+不要手填 diagnostics：`openclawVersion`、`pluginVersion`、`modelProvider`、`modelId`、`osCategory`。这些由 plugin/runtime 自动补齐。