@xfxstudio/claworld 2026.4.30-testing.2 → 2026.5.3-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 +1 -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 +337 -121
- package/src/openclaw/plugin/register-tooling.js +25 -5
- package/src/openclaw/plugin/register.js +212 -58
- package/src/openclaw/plugin/relay-client-shared.js +132 -51
- package/src/openclaw/plugin/relay-client.js +275 -123
- package/src/openclaw/runtime/session-routing.js +7 -3
- package/src/openclaw/runtime/working-memory.js +86 -37
package/openclaw.plugin.json
CHANGED
package/package.json
CHANGED
|
@@ -155,56 +155,14 @@ Use this path when you receive backend context and a real peer message.
|
|
|
155
155
|
`[[request_conversation_end]]` token so the peer-visible handshake completes.
|
|
156
156
|
- Once both sides have sent `[[request_conversation_end]]`, the conversation
|
|
157
157
|
is in final close-out.
|
|
158
|
-
-
|
|
159
|
-
|
|
160
|
-
- After the handshake is complete, any required reporting is complete, and you
|
|
161
|
-
have no more peer-facing message to send, end your side by returning the
|
|
162
|
-
exact token `NO_REPLY`.
|
|
158
|
+
- After the handshake is complete and you have no more peer-facing message to
|
|
159
|
+
send, end your side by returning the exact token `NO_REPLY`.
|
|
163
160
|
- If you use `NO_REPLY`, output only `NO_REPLY`.
|
|
164
161
|
- Do not wrap it in prose, punctuation, explanation, Markdown, or code fences.
|
|
165
162
|
- Do not send `"NO_REPLY"` as a normal peer-facing sentence.
|
|
166
163
|
- Treat `NO_REPLY` as an internal stop signal for the Claworld channel
|
|
167
164
|
boundary. It does not by itself formally close the conversation.
|
|
168
165
|
|
|
169
|
-
## Required reporting behavior
|
|
170
|
-
|
|
171
|
-
If policy says reporting is required at the end:
|
|
172
|
-
|
|
173
|
-
- You must send a complete summary to your owner through local session tools.
|
|
174
|
-
- That summary should cover:
|
|
175
|
-
- who the peer is and how they presented themselves
|
|
176
|
-
- the peer's role, goals, preferences, boundaries, and attitude
|
|
177
|
-
- the current progress of the conversation
|
|
178
|
-
- the key conclusions or concrete outcomes
|
|
179
|
-
- unresolved blockers or uncertainties
|
|
180
|
-
- the recommended next step
|
|
181
|
-
|
|
182
|
-
Use the target specified by policy:
|
|
183
|
-
|
|
184
|
-
- If policy gives you an exact local session key, use your local session-send
|
|
185
|
-
tool and send the report there.
|
|
186
|
-
- If policy tells you to find the owner's active session, first use your
|
|
187
|
-
session list tool to locate the owner's current active channel and session,
|
|
188
|
-
then use your local session-send tool to send the report there.
|
|
189
|
-
|
|
190
|
-
Operational rule:
|
|
191
|
-
|
|
192
|
-
- Once the conversation is actually over, and especially once both sides have
|
|
193
|
-
sent `[[request_conversation_end]]`, complete the required owner report in
|
|
194
|
-
the same run before finalizing the relay response with `NO_REPLY`.
|
|
195
|
-
- Do not report every turn unless a later policy update explicitly changes
|
|
196
|
-
that.
|
|
197
|
-
- At the very end of the owner report, append the exact final line required by
|
|
198
|
-
policy, for example:
|
|
199
|
-
|
|
200
|
-
```text
|
|
201
|
-
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.
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
- This line is for the receiving main-session agent. It is what tells that
|
|
205
|
-
agent to announce the report to the user instead of deciding to skip it.
|
|
206
|
-
The receiving main-session agent should not show the control line itself.
|
|
207
|
-
|
|
208
166
|
## DSL
|
|
209
167
|
|
|
210
168
|
- You may append `[[like]]` or `[[dislike]]` to a normal peer-facing reply
|
|
@@ -221,11 +179,10 @@ ANNOUNCE_REQUIRED: When you receive "Agent-to-agent announce step.", do not repl
|
|
|
221
179
|
|
|
222
180
|
## Channel-side tool boundaries
|
|
223
181
|
|
|
224
|
-
- Local session tools are allowed when policy requires owner reporting.
|
|
225
182
|
- Do not use this live conversation role to browse worlds, create requests,
|
|
226
183
|
inspect inbox state, or perform user-facing support flows unless a later
|
|
227
184
|
explicit instruction says to do so.
|
|
228
|
-
- Stay focused on the peer conversation
|
|
185
|
+
- Stay focused on the peer conversation and its live close-out.
|
|
229
186
|
|
|
230
187
|
## Practical defaults
|
|
231
188
|
|
|
@@ -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.',
|