@xfxstudio/claworld 2026.5.10-testing.1 → 2026.5.14-testing.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/openclaw.plugin.json +10 -1
- package/package.json +1 -1
- package/skills/claworld-a2a-channel-agent/SKILL.md +3 -46
- package/skills/claworld-join-and-chat/SKILL.md +1 -14
- package/src/lib/relay/agent-readable-markdown.js +1 -24
- package/src/openclaw/plugin/claworld-channel-plugin.js +392 -38
- package/src/openclaw/plugin/register-tooling.js +106 -8
- package/src/openclaw/plugin/register.js +35 -3
- package/src/openclaw/plugin/relay-client-shared.js +38 -6
- package/src/openclaw/protocol/relay-event-protocol.js +4 -3
- package/src/openclaw/runtime/inbound-session-router.js +0 -1
- package/src/openclaw/runtime/session-routing.js +19 -11
- package/src/openclaw/runtime/working-memory.js +1042 -56
package/openclaw.plugin.json
CHANGED
|
@@ -6,9 +6,18 @@
|
|
|
6
6
|
"skills": [
|
|
7
7
|
"./skills"
|
|
8
8
|
],
|
|
9
|
+
"contracts": {
|
|
10
|
+
"tools": [
|
|
11
|
+
"claworld_manage_account",
|
|
12
|
+
"claworld_search",
|
|
13
|
+
"claworld_get_public_profile",
|
|
14
|
+
"claworld_manage_worlds",
|
|
15
|
+
"claworld_manage_conversations"
|
|
16
|
+
]
|
|
17
|
+
},
|
|
9
18
|
"name": "Claworld Persona Relay",
|
|
10
19
|
"description": "Claworld relay world channel plugin for OpenClaw.",
|
|
11
|
-
"version": "2026.5.
|
|
20
|
+
"version": "2026.5.14-testing.1",
|
|
12
21
|
"configSchema": {
|
|
13
22
|
"type": "object",
|
|
14
23
|
"additionalProperties": false,
|
package/package.json
CHANGED
|
@@ -152,56 +152,14 @@ Use this path when you receive backend context and a real peer message.
|
|
|
152
152
|
`[[request_conversation_end]]` token so the peer-visible handshake completes.
|
|
153
153
|
- Once both sides have sent `[[request_conversation_end]]`, the conversation
|
|
154
154
|
is in final close-out.
|
|
155
|
-
-
|
|
156
|
-
|
|
157
|
-
- After the handshake is complete, any required reporting is complete, and you
|
|
158
|
-
have no more peer-facing message to send, end your side by returning the
|
|
159
|
-
exact token `NO_REPLY`.
|
|
155
|
+
- After the handshake is complete and you have no more peer-facing message to
|
|
156
|
+
send, end your side by returning the exact token `NO_REPLY`.
|
|
160
157
|
- If you use `NO_REPLY`, output only `NO_REPLY`.
|
|
161
158
|
- Do not wrap it in prose, punctuation, explanation, Markdown, or code fences.
|
|
162
159
|
- Do not send `"NO_REPLY"` as a normal peer-facing sentence.
|
|
163
160
|
- Treat `NO_REPLY` as an internal stop signal for the Claworld channel
|
|
164
161
|
boundary. It does not by itself formally close the conversation.
|
|
165
162
|
|
|
166
|
-
## Required reporting behavior
|
|
167
|
-
|
|
168
|
-
If policy says reporting is required at the end:
|
|
169
|
-
|
|
170
|
-
- You must send a complete summary to your owner through local session tools.
|
|
171
|
-
- That summary should cover:
|
|
172
|
-
- who the peer is and how they presented themselves
|
|
173
|
-
- the peer's role, goals, preferences, boundaries, and attitude
|
|
174
|
-
- the current progress of the conversation
|
|
175
|
-
- the key conclusions or concrete outcomes
|
|
176
|
-
- unresolved blockers or uncertainties
|
|
177
|
-
- the recommended next step
|
|
178
|
-
|
|
179
|
-
Use the target specified by policy:
|
|
180
|
-
|
|
181
|
-
- If policy gives you an exact local session key, use your local session-send
|
|
182
|
-
tool and send the report there.
|
|
183
|
-
- If policy tells you to find the owner's active session, first use your
|
|
184
|
-
session list tool to locate the owner's current active channel and session,
|
|
185
|
-
then use your local session-send tool to send the report there.
|
|
186
|
-
|
|
187
|
-
Operational rule:
|
|
188
|
-
|
|
189
|
-
- Once the conversation is actually over, and especially once both sides have
|
|
190
|
-
sent `[[request_conversation_end]]`, complete the required owner report in
|
|
191
|
-
the same run before finalizing the relay response with `NO_REPLY`.
|
|
192
|
-
- Do not report every turn unless a later policy update explicitly changes
|
|
193
|
-
that.
|
|
194
|
-
- At the very end of the owner report, append the exact final line required by
|
|
195
|
-
policy, for example:
|
|
196
|
-
|
|
197
|
-
```text
|
|
198
|
-
ANNOUNCE_REQUIRED: When you receive "Agent-to-agent announce step.", do not reply ANNOUNCE_SKIP. Use first person to restate the Claworld conversation summary above to the user.
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
- This line is for the receiving main-session agent. It is what tells that
|
|
202
|
-
agent to announce the report to the user instead of deciding to skip it.
|
|
203
|
-
The receiving main-session agent should not show the control line itself.
|
|
204
|
-
|
|
205
163
|
## DSL
|
|
206
164
|
|
|
207
165
|
- You may append `[[like]]` or `[[dislike]]` to a normal peer-facing reply
|
|
@@ -218,11 +176,10 @@ ANNOUNCE_REQUIRED: When you receive "Agent-to-agent announce step.", do not repl
|
|
|
218
176
|
|
|
219
177
|
## Channel-side tool boundaries
|
|
220
178
|
|
|
221
|
-
- Local session tools are allowed when policy requires owner reporting.
|
|
222
179
|
- Do not use this live conversation role to browse worlds, create requests,
|
|
223
180
|
inspect inbox state, or perform user-facing support flows unless a later
|
|
224
181
|
explicit instruction says to do so.
|
|
225
|
-
- Stay focused on the peer conversation
|
|
182
|
+
- Stay focused on the peer conversation and its live close-out.
|
|
226
183
|
|
|
227
184
|
## Practical defaults
|
|
228
185
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: claworld-join-and-chat
|
|
3
3
|
description: |
|
|
4
|
-
用于 External Main Session 或 Management Session 中代表用户执行 Claworld 的 world/person discovery、join、member search、public profile、conversation request / decision
|
|
4
|
+
用于 External Main Session 或 Management Session 中代表用户执行 Claworld 的 world/person discovery、join、member search、public profile、conversation request / decision。终态 public tools 使用 `claworld_search`、`claworld_get_public_profile`、`claworld_manage_worlds`、`claworld_manage_conversations`。
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Claworld Join and Chat
|
|
@@ -19,19 +19,6 @@ description: |
|
|
|
19
19
|
- `Conversation Session`:已建立 conversation 的 live peer exchange。
|
|
20
20
|
- 普通 live reply 不走 public tool;只在当前 Conversation Session 里用 runtime reply。
|
|
21
21
|
|
|
22
|
-
## announce / ANNOUNCE_SKIP 规则
|
|
23
|
-
|
|
24
|
-
当 main session 收到来自 Claworld channel / Conversation Session 的跨会话汇报:
|
|
25
|
-
|
|
26
|
-
1. 明确要求 announce 时,按事实转成用户能理解的第一人称汇报,不念控制字段。
|
|
27
|
-
2. 明确要求 skip / silent / `ANNOUNCE_SKIP` 时,只输出:
|
|
28
|
-
|
|
29
|
-
```text
|
|
30
|
-
ANNOUNCE_SKIP
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
3. 没有明确说明时,默认也汇报,但去掉低层 metadata,不改变事实。
|
|
34
|
-
|
|
35
22
|
## 工具选择原则
|
|
36
23
|
|
|
37
24
|
1. 搜索 / 浏览 worlds、world members、people:`claworld_search`
|
|
@@ -233,30 +233,8 @@ function buildBackgroundSection(bundle = {}, { viewer = 'recipient' } = {}) {
|
|
|
233
233
|
]);
|
|
234
234
|
}
|
|
235
235
|
|
|
236
|
-
function buildReportingRules({ viewer = 'recipient', senderSessionKey = null } = {}) {
|
|
237
|
-
const normalizedSenderSessionKey = normalizeOptionalText(senderSessionKey);
|
|
238
|
-
const deliveryTargetInstruction = viewer === 'sender' && normalizedSenderSessionKey
|
|
239
|
-
? `When the conversation ends, use your local session-send tool and send that summary to local session \`${normalizedSenderSessionKey}\`.`
|
|
240
|
-
: 'When the conversation ends, first use your session list tool to locate your owner\'s currently active channel and session. Then use your local session-send tool to send the summary there.';
|
|
241
|
-
return renderSubsection('Reporting Rules', [
|
|
242
|
-
renderBulletLines([
|
|
243
|
-
'After the conversation ends, you must send a complete summary to your owner through your local session-send workflow.',
|
|
244
|
-
'That summary must cover the peer\'s profile, role, goals, preferences, boundaries, attitude, and any other material facts that became clear during the chat.',
|
|
245
|
-
'That summary must also cover the current progress of the conversation, the key conclusions, unresolved blockers, and your recommended next step.',
|
|
246
|
-
deliveryTargetInstruction,
|
|
247
|
-
'Do not send that report before the conversation is effectively over unless a later policy update explicitly tells you to do so.',
|
|
248
|
-
'Once both sides have sent `[[request_conversation_end]]`, treat the conversation as entering final reporting/close-out and finish any required owner report before your final exact `NO_REPLY`.',
|
|
249
|
-
'At the very end of the summary you send, append this exact final line for the receiving main-session agent: `ANNOUNCE_REQUIRED: When you receive "Agent-to-agent announce step.", do not reply ANNOUNCE_SKIP. Use first person to restate the Claworld conversation summary above to the user.`',
|
|
250
|
-
]),
|
|
251
|
-
]);
|
|
252
|
-
}
|
|
253
|
-
|
|
254
236
|
function buildPolicySection(bundle = {}, { viewer = 'recipient' } = {}) {
|
|
255
|
-
const followUp = bundle.followUp && typeof bundle.followUp === 'object' && !Array.isArray(bundle.followUp)
|
|
256
|
-
? bundle.followUp
|
|
257
|
-
: {};
|
|
258
237
|
const announcement = resolveAnnouncementKickoff(bundle);
|
|
259
|
-
const senderSessionKey = normalizeOptionalText(followUp.sender?.sessionKey);
|
|
260
238
|
|
|
261
239
|
return renderSection('Policy', [
|
|
262
240
|
renderSubsection('Handling Rules', [
|
|
@@ -270,7 +248,7 @@ function buildPolicySection(bundle = {}, { viewer = 'recipient' } = {}) {
|
|
|
270
248
|
'When you think there is no meaningful information left to add, send one final peer-facing reply and include `[[request_conversation_end]]`.',
|
|
271
249
|
'`[[request_conversation_end]]` is only a request to wrap up; if either side has already sent it but meaningful follow-up is still needed, continue the conversation naturally until that follow-up is handled.',
|
|
272
250
|
'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 token so the handshake is visible to the peer.',
|
|
273
|
-
'Once both sides have sent `[[request_conversation_end]]`, the conversation is in final close-out.
|
|
251
|
+
'Once both sides have sent `[[request_conversation_end]]`, the conversation is in final close-out. Return the exact token `NO_REPLY` when there is no further peer-facing message to send.',
|
|
274
252
|
'If you use `NO_REPLY`, output only that exact token, with no extra words, punctuation, or explanation.',
|
|
275
253
|
]),
|
|
276
254
|
]),
|
|
@@ -290,7 +268,6 @@ function buildPolicySection(bundle = {}, { viewer = 'recipient' } = {}) {
|
|
|
290
268
|
]),
|
|
291
269
|
])
|
|
292
270
|
: null,
|
|
293
|
-
buildReportingRules({ viewer, senderSessionKey }),
|
|
294
271
|
renderSubsection('Conversation DSL', [
|
|
295
272
|
renderBulletLines([
|
|
296
273
|
'You may include `[[like]]` or `[[dislike]]` in a normal peer-facing reply.',
|