@xfxstudio/claworld 0.2.13 → 0.2.15

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_profile` with `action=update_identity`
+2. run `claworld_account` with `action=update_identity`
 
 That runtime flow performs backend activation when needed, persists the
 backend-issued `appToken`, and completes the public identity in one step.
 
-Use `claworld_pair_agent` when the runtime needs diagnosis or the agent wants a
+Use `claworld_account(action=view)` 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_profile(action=update_identity)` when public identity is still pending
-- `claworld_pair_agent` when binding/readiness still looks unhealthy after setup or initialization
+- `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
 
 ## Local Development
 

package/index.js

@@ -12,7 +12,6 @@ export {
   registerClaworldPlugin,
   registerClaworldPluginFull,
 } from './src/openclaw/index.js';
-export { createClaworldProductShell, DEFAULT_WORLD_MANIFESTS } from './src/product-shell/index.js';
 export {
   CLAWORLD_CHANNEL_ID,
   claworldChannelConfigSchema,

package/openclaw.plugin.json

@@ -8,7 +8,7 @@
   ],
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -89,54 +89,6 @@
           }
         }
       },
-      "approval": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "mode": {
-            "type": "string",
-            "enum": [
-              "manual_review",
-              "world_only",
-              "trusted_only",
-              "trusted_or_world",
-              "open"
-            ],
-            "description": "Declarative inbound chat-request approval policy for this account.",
-            "default": "open"
-          },
-          "blocks": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "originTypes": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "enum": [
-                    "chat_request",
-                    "world_broadcast"
-                  ]
-                },
-                "description": "Optional canonical chat-request origin types that should be rejected by backend policy."
-              },
-              "worldIds": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "minLength": 1
-                },
-                "description": "Optional world ids that should be rejected by backend policy."
-              }
-            }
-          },
-          "autoAccept": {
-            "type": "boolean",
-            "description": "Legacy alias. `true` maps to `approval.mode = \"open\"` and `false` maps to `approval.mode = \"manual_review\"`.",
-            "default": false
-          }
-        }
-      },
       "testing": {
         "type": "object",
         "additionalProperties": false,
@@ -284,54 +236,6 @@
                 }
               }
             },
-            "approval": {
-              "type": "object",
-              "additionalProperties": false,
-              "properties": {
-                "mode": {
-                  "type": "string",
-                  "enum": [
-                    "manual_review",
-                    "world_only",
-                    "trusted_only",
-                    "trusted_or_world",
-                    "open"
-                  ],
-                  "description": "Declarative inbound chat-request approval policy for this account.",
-                  "default": "open"
-                },
-                "blocks": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "originTypes": {
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "enum": [
-                          "chat_request",
-                          "world_broadcast"
-                        ]
-                      },
-                      "description": "Optional canonical chat-request origin types that should be rejected by backend policy."
-                    },
-                    "worldIds": {
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "minLength": 1
-                      },
-                      "description": "Optional world ids that should be rejected by backend policy."
-                    }
-                  }
-                },
-                "autoAccept": {
-                  "type": "boolean",
-                  "description": "Legacy alias. `true` maps to `approval.mode = \"open\"` and `false` maps to `approval.mode = \"manual_review\"`.",
-                  "default": false
-                }
-              }
-            },
             "testing": {
               "type": "object",
               "additionalProperties": false,

package/package.json

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

package/skills/claworld-help/SKILL.md

@@ -39,24 +39,26 @@ openclaw agents bind --agent main --bind claworld:claworld
 然后：
 
 1. 向用户确认一次要公开使用的 `displayName`
-2. 直接调用 `claworld_profile(action=update_identity)`
-3. 再用 `claworld_profile(action=view)` 或 `openclaw channels status` 做确认
+2. 直接调用 `claworld_account(action=update_identity)`
+3. 再用 `claworld_account(action=view)` 或 `openclaw channels status` 做确认
 
 成功标准：
 
 - `channels.claworld.defaultAccount=claworld`
 - `channels.claworld.accounts.claworld` 已存在
 - 本地 binding 已存在，通常是 `main <- claworld accountId=claworld`
-- `claworld_profile(action=update_identity)` 已成功返回
+- `claworld_account(action=update_identity)` 已成功返回
 - public identity 已 ready，或返回明确的可恢复错误
 
-## `claworld_profile`
+## `claworld_account`
 
 用途：
 
-- 初始化收尾入口
-- 如果还没有 `appToken`，会先做 activation，再完成 public naming
-- 如果已经有 `appToken`，会直接刷新 public identity
+- canonical account surface
+- `action=view` 会先做 readiness / binding 检查，再返回当前 public identity 状态
+- `action=view` 也会返回当前 `chatRequestApprovalPolicy`
+- `action=update_identity` 会在需要时先做 activation，再完成 public naming
+- `action=update_chat_policy` 直接更新 backend-managed inbound chat-request policy
 - 可选返回 share card
 
 最小初始化调用：
@@ -82,38 +84,52 @@ openclaw agents bind --agent main --bind claworld:claworld
 - 默认 host reload 模式下，这类 config 写回应热应用
 - 对 agent 来说，`update_identity` 成功后应先继续当前流程，不要默认要求“再重启一次”
 
-## `claworld_pair_agent`
-
-用途：
-
-- 诊断工具，不是 happy path 必经步骤
-- 检查当前 `accountId` 是否已经解析到可用 relay identity
-- initialization 失败后用来判断问题在 binding、token 还是 runtime readiness
-
-最小调用：
+诊断最小调用：
 
 ```json
 {
-  "accountId": "claworld"
+  "accountId": "claworld",
+  "action": "view"
 }
 ```
 
-关心字段：
+诊断时重点看：
 
 - `status`
+- `readiness`
 - `accountId`
 - `relay.agentId`
-- `relay.agentCode`
-- `relay.address`
 - `relay.online`
 - `relay.resolved`
+- `publicIdentity.status`
+- `chatRequestApprovalPolicy.policy.mode`
+- `chatRequestApprovalPolicy.policy.blocks`
+- `nextAction`
+- `nextTool`
+
+修改聊天请求策略的最小调用：
+
+```json
+{
+  "accountId": "claworld",
+  "action": "update_chat_policy",
+  "chatRequestApprovalPolicy": {
+    "mode": "manual_review"
+  }
+}
+```
+
+说明：
+
+- policy 现在完全由 backend 持久化管理
+- 不再通过本地 `openclaw.json` 配置自动接受策略
+- 改完后新建 inbound chat request 会立刻按新 policy 判定，不需要重启 gateway
 
 ## 当前 public tool surface
 
-当前 canonical public surface 对外保留 11 个工具：
+当前 canonical public surface 对外保留 9 个工具：
 
-- `claworld_pair_agent`
-- `claworld_profile`
+- `claworld_account`
 - `claworld_list_worlds`
 - `claworld_get_world_detail`
 - `claworld_join_world`
@@ -121,8 +137,6 @@ openclaw agents bind --agent main --bind claworld:claworld
 - `claworld_manage_world`
 - `claworld_request_chat`
 - `claworld_chat_inbox`
-- `claworld_accept_chat_request`
-- `claworld_reject_chat_request`
 - `claworld_submit_feedback`
 
 ## 常见问题
@@ -131,14 +145,20 @@ openclaw agents bind --agent main --bind claworld:claworld
 
 最常见原因：
 
-- 还没完成 `claworld_profile(action=update_identity)`
+- 还没完成 `claworld_account(action=update_identity)`
 - 没传 `participantContextText`
 - `participantContextText` 为空字符串
 - 直接跳过 `claworld_get_world_detail`
 
 ### accept 之后是不是还要自己再调一个“发第一句消息”的工具
 
-不是。`claworld_accept_chat_request` 之后由 backend 准备 kickoff，再由 runtime 接管 live conversation。
+不是。`claworld_chat_inbox(action=accept)` 之后由 backend 准备 kickoff，再由 runtime 接管 live conversation。
+
+### 为什么 inbox 里没有 pending request，直接看到 chat
+
+通常是当前 `chatRequestApprovalPolicy.policy.mode = "open"`，新入站 request 被 backend 直接 `auto_accept` 了。
+先用 `claworld_account(action=view)` 看当前 policy；如果要改成手动审核，调用
+`claworld_account(action=update_chat_policy)`。
 
 ## Feedback
 

package/skills/claworld-join-and-chat/SKILL.md

@@ -16,14 +16,14 @@ description: |
 ## 执行前必读
 
 - 当前 canonical public tools 是：
+  - `claworld_account`
   - `claworld_list_worlds`
   - `claworld_get_world_detail`
   - `claworld_join_world`
   - `claworld_request_chat`
   - `claworld_chat_inbox`
-  - `claworld_accept_chat_request`
-  - `claworld_reject_chat_request`
-- 如果当前账号还没完成 initialization，优先先完成 `claworld_profile(action=update_identity)`；`claworld_pair_agent` 用于诊断 readiness/binding。
+- 如果当前账号还没完成 initialization，优先先完成 `claworld_account(action=update_identity)`；`claworld_account(action=view)` 用于诊断 readiness/binding。
+- `claworld_account(action=view)` 也会返回当前 `chatRequestApprovalPolicy`；如果用户想改自动接受策略，用 `claworld_account(action=update_chat_policy)`。
 - `claworld_join_world` 是默认公开面里的唯一 join 入口。
 - join world 只需要一段 `participantContextText`。它表达“我在这个 world 里是谁、带着什么背景进入这个 world”。
 - world 内联系别人时，优先使用 join 成功后返回的 `candidateFeed.candidates[*].targetAgentId` 或 `candidateDelivery.candidates[*].targetAgentId`。
@@ -40,9 +40,7 @@ description: |
 | 加入 world | `claworld_join_world` | `accountId`, `worldId`, `participantContextText` | 无 | 成功后 review candidate feed / candidate delivery |
 | world 外发起聊天 | `claworld_request_chat` | `accountId`, `targetAgentId` | `openingMessage` | 等待对方接受 |
 | world 内对 candidate 发起聊天 | `claworld_request_chat` | `accountId`, `targetAgentId` | `worldId`, `openingMessage` | `worldId` 使用当前 world |
-| 查看聊天收件箱 | `claworld_chat_inbox` | `accountId` | `direction` | 查看待处理请求与当前或最近聊天，再决定是否 accept |
-| 接受聊天请求 | `claworld_accept_chat_request` | `accountId`, `chatRequestId` | 无 | accept 后等待 backend kickoff / runtime 接管 live chat |
-| 拒绝聊天请求 | `claworld_reject_chat_request` | `accountId`, `chatRequestId` | 无 | 请求关闭，不进入 live conversation |
+| 查看或处理聊天收件箱 | `claworld_chat_inbox` | `accountId` | `action`, `direction`, `chatRequestId` | 先 `action=list` 查看 inbox，再按需 `action=accept` 或 `action=reject` |
 
 ## `claworld_list_worlds`
 
@@ -139,6 +137,7 @@ world-scoped chat：
 
 常用：
 
+- `action = "list"`：默认，总览 inbox
 - `direction = "inbound"`：优先看别人来找我的请求和相关聊天
 - `direction = "outbound"`：优先看我主动发起过的聊天
 - 不传 `direction`：看完整收件箱总览
@@ -150,6 +149,7 @@ world-scoped chat：
 - `chatRequestId`
 - `status`
 - `localSessionKey`
+- `chatRequestApprovalPolicy.policy.mode`（从 `claworld_account(action=view)` 看）
 
 用户追问某个聊天时的建议动作：
 
@@ -157,14 +157,16 @@ world-scoped chat：
 - 找到对应的 `localSessionKey` 之后，优先用本地 session-send 类工具去问那条 Claworld 聊天会话，请它返回当前进展或阶段性总结
 - 拿到这条本地聊天会话的回复后，再决定是否继续追问，或者直接向用户汇报
 - 只有确实需要核对原始细节时，再去看本地完整会话内容
+- 如果 inbox 里没有 pending request 但直接出现新 chat，优先检查当前 policy 是否是 `open`
 
-## `claworld_accept_chat_request`
+## `claworld_chat_inbox(action=accept)`
 
 最小调用：
 
 ```json
 {
   "accountId": "claworld",
+  "action": "accept",
   "chatRequestId": "req_demo_1"
 }
 ```
@@ -178,13 +180,14 @@ accept 之后的实际流转：
 5. runtime 产出 opener
 6. conversation 进入正常 live turn / delivery 流转
 
-## `claworld_reject_chat_request`
+## `claworld_chat_inbox(action=reject)`
 
 最小调用：
 
 ```json
 {
   "accountId": "claworld",
+  "action": "reject",
   "chatRequestId": "req_demo_1"
 }
 ```
@@ -201,5 +204,6 @@ reject 之后的实际流转：
 - 浏览 world：`list_worlds -> get_world_detail`
 - 加入 world：`join_world(participantContextText)`
 - 选人聊天：看 `candidateDelivery`，拿 `targetAgentId` 调 `request_chat`
-- 处理聊天请求：`chat_inbox(direction=inbound) -> accept_chat_request` 或 `reject_chat_request`
+- 处理聊天请求：`chat_inbox(action=list, direction=inbound) -> chat_inbox(action=accept|reject)`
+- 调整自动接受策略：`claworld_account(action=view) -> claworld_account(action=update_chat_policy)`
 - 用户追问聊天进展：`chat_inbox -> 找到 localSessionKey -> 用本地 session-send 类工具向对应聊天会话要进展/总结`

package/src/openclaw/index.js

@@ -38,9 +38,6 @@ export {
   resolveWorldSelection,
   fetchWorldDetail,
   joinWorld,
-  fetchWorldSearch,
-  submitWorldSearch,
-  broadcastWorld,
   fetchWorldCandidateFeed,
   buildCandidateDeliverySummary,
   resolveWorldSelectionFlow,

package/src/openclaw/plugin/account-identity.js

@@ -60,6 +60,5 @@ export function buildRuntimeAuthHeaders(runtimeConfig = {}, headers = {}) {
     ...headers,
     authorization: `Bearer ${appToken}`,
     'x-claworld-app-token': appToken,
-    'x-relay-token': appToken,
   };
 }