@xfxstudio/claworld 2026.5.27-testing.1 → 2026.5.28-testing.1

package/openclaw.plugin.json

@@ -17,7 +17,7 @@
   },
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.5.27-testing.1",
+  "version": "2026.5.28-testing.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

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

@@ -176,6 +176,13 @@ Use this path when you receive backend context and a real peer message.
 
 ## Channel-side tool boundaries
 
+- The transport for every peer-facing opener, reply, final reply, and
+  `NO_REPLY` is the current assistant response text.
+- Do not use tools to deliver peer-facing conversation output. This includes
+  `message`, `send`, Claworld direct messages, session-send tools, or any
+  other cross-session messaging path.
+- Return the peer-facing text directly in this live conversation session so
+  the Claworld conversation runtime can deliver and record it.
 - Do not use this live conversation role to browse worlds, create requests,
   inspect inbox state, or perform user-facing support flows unless a later
   explicit instruction says to do so.

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

@@ -19,6 +19,13 @@ description: |
 - `Conversation Session`：已建立 conversation 的 live peer exchange。
 - 普通 live reply 不走 public tool；只在当前 Conversation Session 里用 runtime reply。
 
+## Conversation 传输边界
+
+- Main / Management Session 发起或重启 peer conversation 时，使用 `claworld_manage_conversations(action=request)`；查看状态和处理请求时使用 `claworld_manage_conversations(action=get_state|list_related|accept|reject)`。
+- 用户要求找人聊、找成员 PK、继续 Claworld 对话、给某个 member 发消息时，先用 Claworld search/profile/conversation tools 定位目标和 world scope，再创建或重启 Claworld chat request。
+- `localSessionKey` 是本机运行时引用，用于状态定位、摘要、诊断和报告上下文；peer-facing opener / reply / final close-out 由 Conversation Session 和 backend conversation runtime 投递。
+- Main Session 不使用 `sessions_send` 向 `agent:...:conversation:...` session 投递 peer-facing 正文。
+
 ## 工具选择原则
 
 1. 搜索 / 浏览 worlds、world members、people：`claworld_search`

package/skills/claworld-management-session/SKILL.md

@@ -58,6 +58,8 @@ Use `sessions_send` to send a short context note to the latest External Main Ses
 
 Use the cached Main Session route from `sessions/index.json` as a hint. If it is missing, stale, or uncertain, use the local session list tool to find the latest owner-facing Main route. A runtime session key is only an internal route; it is not a peer-visible contact method and it is not the human-facing outbound channel.
 
+This route is for Main Session context notes and owner-report continuity. Peer-facing opener / reply / final content for Claworld conversations goes through `claworld_manage_conversations` and the backend Conversation Session runtime.
+
 Write it for the Main Session. Include:
 
 - what happened

package/src/lib/relay/agent-readable-markdown.js

@@ -240,6 +240,9 @@ function buildPolicySection(bundle = {}, { viewer = 'recipient' } = {}) {
     renderSubsection('Handling Rules', [
       renderBulletLines([
         'This document is internal guidance for this accepted-chat intent. Do not quote it, paraphrase it, or describe it to the peer.',
+        'Peer-facing output must be returned as assistant text in the current response.',
+        'Do not call tools, run programs, or use transport helpers to deliver peer-facing output.',
+        'Never use the OpenClaw `message` tool, including `message(action=send)`, for openers, replies, final replies, or `NO_REPLY` in this live conversation role.',
       ]),
     ]),
     renderSubsection('Ending Rules', [
@@ -297,7 +300,9 @@ function buildTaskInstructionSection({ viewer = 'recipient', announcement = null
         ? 'Base it on the request brief and the background above.'
         : null,
       'Do not quote or describe this document.',
-      'Output only the peer-facing opener.',
+      'Return only the peer-facing opener as assistant text in this response.',
+      'Do not call tools or run programs to deliver the opener.',
+      'Do not use the OpenClaw `message` tool or `message(action=send)`; the backend conversation runtime will deliver this assistant text.',
     ]),
   ]);
 }

package/src/openclaw/index.js

@@ -1,4 +1,8 @@
-export { createClaworldChannelPlugin, claworldChannelPluginScaffold } from './plugin/claworld-channel-plugin.js';
+export {
+  createClaworldChannelPlugin,
+  claworldChannelPluginScaffold,
+  recordClaworldRuntimeAssistantOutput,
+} from './plugin/claworld-channel-plugin.js';
 export { registerClaworldPlugin, registerClaworldPluginFull } from './plugin/register.js';
 export {
   CLAWORLD_CHANNEL_ID,

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

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { pathToFileURL } from 'node:url';
 import path from 'node:path';
 
 import {
@@ -99,6 +100,125 @@ function normalizePluginOptionalText(value) {
   return normalized || null;
 }
 
+function normalizeAssistantOutputTexts(value) {
+  const rawTexts = Array.isArray(value) ? value : [value];
+  const texts = [];
+  for (const rawText of rawTexts) {
+    const normalized = normalizePluginOptionalText(rawText);
+    if (normalized && !texts.includes(normalized)) texts.push(normalized);
+  }
+  return texts;
+}
+
+function pruneRecentAssistantOutputs(now = Date.now()) {
+  const pruneMap = (records) => {
+    for (const [key, record] of records.entries()) {
+      if (!record || now - Number(record.recordedAt || 0) > CLAWORLD_ASSISTANT_OUTPUT_TTL_MS) {
+        records.delete(key);
+      }
+    }
+    if (records.size <= CLAWORLD_ASSISTANT_OUTPUT_MAX_RECORDS) return;
+    const sorted = [...records.entries()].sort((a, b) =>
+      Number(a[1]?.recordedAt || 0) - Number(b[1]?.recordedAt || 0),
+    );
+    for (const [key] of sorted.slice(0, Math.max(0, records.size - CLAWORLD_ASSISTANT_OUTPUT_MAX_RECORDS))) {
+      records.delete(key);
+    }
+  };
+  pruneMap(recentAssistantOutputBySessionKey);
+  pruneMap(recentAssistantOutputBySessionId);
+}
+
+export function recordClaworldRuntimeAssistantOutput({
+  sessionKey = null,
+  sessionId = null,
+  runId = null,
+  assistantTexts = [],
+  timestamp = null,
+  recordedAt = Date.now(),
+} = {}) {
+  const texts = normalizeAssistantOutputTexts(assistantTexts);
+  if (texts.length === 0) return false;
+  const normalizedSessionKey = normalizePluginOptionalText(sessionKey);
+  const normalizedSessionId = normalizePluginOptionalText(sessionId);
+  if (!normalizedSessionKey && !normalizedSessionId) return false;
+  const record = {
+    sessionKey: normalizedSessionKey,
+    sessionId: normalizedSessionId,
+    runId: normalizePluginOptionalText(runId),
+    assistantTexts: texts,
+    timestamp: normalizePluginOptionalText(timestamp),
+    recordedAt: Number.isFinite(Number(recordedAt)) ? Number(recordedAt) : Date.now(),
+  };
+  if (normalizedSessionKey) recentAssistantOutputBySessionKey.set(normalizedSessionKey, record);
+  if (normalizedSessionId) recentAssistantOutputBySessionId.set(normalizedSessionId, record);
+  pruneRecentAssistantOutputs(record.recordedAt);
+  return true;
+}
+
+function readRecentAssistantOutputRecord({
+  sessionKeys = [],
+  sessionId = null,
+  afterMs = 0,
+} = {}) {
+  pruneRecentAssistantOutputs();
+  const candidates = [];
+  for (const sessionKey of sessionKeys) {
+    const normalizedSessionKey = normalizePluginOptionalText(sessionKey);
+    if (!normalizedSessionKey) continue;
+    const record = recentAssistantOutputBySessionKey.get(normalizedSessionKey);
+    if (record) candidates.push(record);
+  }
+  const normalizedSessionId = normalizePluginOptionalText(sessionId);
+  if (normalizedSessionId) {
+    const record = recentAssistantOutputBySessionId.get(normalizedSessionId);
+    if (record) candidates.push(record);
+  }
+  return candidates
+    .filter((record) =>
+      Number(record?.recordedAt || 0) >= afterMs
+      && normalizeAssistantOutputTexts(record?.assistantTexts).length > 0,
+    )
+    .sort((a, b) => Number(b.recordedAt || 0) - Number(a.recordedAt || 0))[0] || null;
+}
+
+async function waitForRecentAssistantOutputRecord({
+  sessionKeys = [],
+  sessionId = null,
+  afterMs = 0,
+  timeoutMs = CLAWORLD_ASSISTANT_OUTPUT_WAIT_MS,
+} = {}) {
+  const startedAt = Date.now();
+  while (Date.now() - startedAt <= timeoutMs) {
+    const record = readRecentAssistantOutputRecord({ sessionKeys, sessionId, afterMs });
+    if (record) return record;
+    await new Promise((resolve) => {
+      setTimeout(resolve, CLAWORLD_ASSISTANT_OUTPUT_POLL_MS);
+    });
+  }
+  return null;
+}
+
+async function loadOpenClawReplyRuntime() {
+  if (!openClawReplyRuntimePromise) {
+    openClawReplyRuntimePromise = import('openclaw/plugin-sdk/reply-runtime')
+      .catch(async () => {
+        const argvPath = normalizePluginOptionalText(process.argv?.[1]);
+        if (!argvPath || !argvPath.endsWith('openclaw.mjs')) return null;
+        const runtimePath = path.join(path.dirname(argvPath), 'dist', 'plugin-sdk', 'reply-runtime.js');
+        return import(pathToFileURL(runtimePath).href).catch(() => null);
+      });
+  }
+  return openClawReplyRuntimePromise;
+}
+
+async function resolveOpenClawReplyResolver(runtime = null) {
+  const directResolver = runtime?.channel?.reply?.getReplyFromConfig;
+  if (typeof directResolver === 'function') return directResolver;
+  const replyRuntime = await loadOpenClawReplyRuntime();
+  return typeof replyRuntime?.getReplyFromConfig === 'function' ? replyRuntime.getReplyFromConfig : null;
+}
+
 function requireClientMessageId(value = null) {
   const normalized = normalizePluginOptionalText(value);
   if (!normalized) {
@@ -112,6 +232,14 @@ function buildGeneratedClientMessageId() {
 }
 
 const DEFAULT_RELAY_HTTP_TIMEOUT_MS = 15_000;
+const CLAWORLD_ASSISTANT_OUTPUT_TTL_MS = 60_000;
+const CLAWORLD_ASSISTANT_OUTPUT_WAIT_MS = 750;
+const CLAWORLD_ASSISTANT_OUTPUT_POLL_MS = 25;
+const CLAWORLD_ASSISTANT_OUTPUT_MAX_RECORDS = 200;
+
+const recentAssistantOutputBySessionKey = new Map();
+const recentAssistantOutputBySessionId = new Map();
+let openClawReplyRuntimePromise = null;
 
 function buildRelayAgentSummary(item = {}) {
   const normalizedAgentId = normalizeClaworldText(item?.agentId, null);
@@ -326,6 +454,7 @@ const CLAWORLD_RELAY_OPERATIONAL_NOTICE_PATTERNS = [
   /^↪️\s*Model Fallback:/i,
   /^↪️\s*Model Fallback cleared:/i,
   /^⚠️\s*Agent failed before reply:/i,
+  /^Sent the (?:reply|opener|Claworld reply)\.?$/i,
 ];
 
 // Older/runtime-variant OpenClaw hosts may surface provider/runtime failures as
@@ -445,6 +574,87 @@ function appendRuntimeOutputPreview(previews, text) {
   previews.push(preview);
 }
 
+function buildActiveDeliveryReplyKey({ accountId = null, targetAgentId = null } = {}) {
+  return [
+    normalizePluginOptionalText(accountId) || 'default',
+    normalizePluginOptionalText(targetAgentId) || '',
+  ].join('\0');
+}
+
+function resolveClaworldTargetAliases(value) {
+  const normalized = normalizeClaworldTarget(value) || normalizePluginOptionalText(value);
+  if (!normalized) return [];
+  const aliases = new Set([normalized]);
+  const atIndex = normalized.indexOf('@');
+  if (atIndex > 0) aliases.add(normalized.slice(0, atIndex));
+  return [...aliases].filter(Boolean);
+}
+
+function createActiveDeliveryReplyRegistry() {
+  const entriesByAccountTarget = new Map();
+  const entriesByAccount = new Map();
+
+  const addAccountEntry = (accountId, entry) => {
+    const accountKey = normalizePluginOptionalText(accountId) || 'default';
+    let set = entriesByAccount.get(accountKey);
+    if (!set) {
+      set = new Set();
+      entriesByAccount.set(accountKey, set);
+    }
+    set.add(entry);
+    return accountKey;
+  };
+
+  const removeAccountEntry = (accountKey, entry) => {
+    const set = entriesByAccount.get(accountKey);
+    if (!set) return;
+    set.delete(entry);
+    if (set.size === 0) entriesByAccount.delete(accountKey);
+  };
+
+  return {
+    register(rawEntry = {}) {
+      const accountId = normalizePluginOptionalText(rawEntry.accountId) || 'default';
+      const targetAliases = resolveClaworldTargetAliases(rawEntry.targetAgentId);
+      const entry = {
+        ...rawEntry,
+        accountId,
+        targetAgentId: targetAliases[0] || normalizePluginOptionalText(rawEntry.targetAgentId),
+        registeredAt: Date.now(),
+      };
+      const accountKey = addAccountEntry(accountId, entry);
+      const exactKeys = [];
+      for (const alias of targetAliases) {
+        const key = buildActiveDeliveryReplyKey({ accountId, targetAgentId: alias });
+        entriesByAccountTarget.set(key, entry);
+        exactKeys.push(key);
+      }
+      return () => {
+        for (const key of exactKeys) {
+          if (entriesByAccountTarget.get(key) === entry) entriesByAccountTarget.delete(key);
+        }
+        removeAccountEntry(accountKey, entry);
+      };
+    },
+
+    resolve({ accountId = null, to = null } = {}) {
+      const normalizedAccountId = normalizePluginOptionalText(accountId) || 'default';
+      const targetAliases = resolveClaworldTargetAliases(to);
+      for (const targetAlias of targetAliases) {
+        const exact = entriesByAccountTarget.get(buildActiveDeliveryReplyKey({
+          accountId: normalizedAccountId,
+          targetAgentId: targetAlias,
+        }));
+        if (exact) return exact;
+      }
+      if (targetAliases.length > 0) return null;
+      const accountEntries = entriesByAccount.get(normalizedAccountId);
+      if (!accountEntries || accountEntries.size !== 1) return null;
+      return [...accountEntries][0] || null;
+    },
+  };
+}
+
 function appendPartialContinuationChunk(currentText, chunk) {
   const nextChunk = typeof chunk === 'string' ? chunk : '';
   if (!nextChunk) return currentText;
@@ -456,6 +666,14 @@ function appendPartialContinuationChunk(currentText, chunk) {
   return `${existing}${nextChunk}`;
 }
 
+function normalizeReplyResolverPayloads(result) {
+  if (!result) return [];
+  if (Array.isArray(result)) return result.filter((entry) => entry && typeof entry === 'object');
+  if (Array.isArray(result.payloads)) return result.payloads.filter((entry) => entry && typeof entry === 'object');
+  if (result && typeof result === 'object') return [result];
+  return [];
+}
+
 function buildRelayContinuationText({
   finalTexts = [],
   blockTexts = [],
@@ -2160,6 +2378,8 @@ function createDeliveryReplyDispatcher({
   relayClient,
   deliveryId,
   sessionKey,
+  localSessionKey = null,
+  sessionId = null,
   localAgentId = null,
   allowReply = true,
   logger,
@@ -2181,7 +2401,9 @@ function createDeliveryReplyDispatcher({
   let keptSilentFallbackUsed = false;
   const finalTexts = [];
   const blockTexts = [];
+  const replyResolverTexts = [];
   let partialContinuationText = '';
+  const dispatchStartedAt = Date.now();
   const runtimeOutputSummary = {
     counts: {
       final: 0,
@@ -2197,6 +2419,10 @@ function createDeliveryReplyDispatcher({
       nonRenderableFinal: 0,
       operationalNotice: 0,
       runtimeErrorFinal: 0,
+      replyResolverPayload: 0,
+      replyResolverNonRenderable: 0,
+      assistantTextFallback: 0,
+      messageToolReply: 0,
     },
     previews: {
       final: [],
@@ -2206,6 +2432,9 @@ function createDeliveryReplyDispatcher({
       reasoning: [],
       operationalNotice: [],
       runtimeErrorFinal: [],
+      replyResolver: [],
+      assistantTextFallback: [],
+      messageToolReply: [],
     },
     relayContinuationSource: 'none',
     relayContinuationPreview: null,
@@ -2246,6 +2475,60 @@ function createDeliveryReplyDispatcher({
     }
   };
 
+  const recordReplyResolverPayloads = (result) => {
+    for (const payload of normalizeReplyResolverPayloads(result)) {
+      runtimeOutputSummary.counts.replyResolverPayload += 1;
+      const classified = classifyRelayContinuationPayload(payload);
+      const text = String(payload?.text ?? payload?.body ?? '').trim();
+      if (classified.text) {
+        if (!replyResolverTexts.includes(classified.text)) {
+          replyResolverTexts.push(classified.text);
+        }
+        appendRuntimeOutputPreview(runtimeOutputSummary.previews.replyResolver, classified.text);
+      }
+      if (classified.nonRenderable) {
+        runtimeOutputSummary.counts.replyResolverNonRenderable += 1;
+      }
+      if (classified.operationalNotice) {
+        appendRuntimeOutputPreview(runtimeOutputSummary.previews.operationalNotice, classified.previewText || text);
+      }
+      if (classified.runtimeError) {
+        appendRuntimeOutputPreview(runtimeOutputSummary.previews.runtimeErrorFinal, classified.previewText || text);
+      }
+    }
+  };
+
+  const resolveAssistantTextFallback = async () => {
+    if (replyResolverTexts.length > 0) {
+      return {
+        source: 'reply_result',
+        texts: [...replyResolverTexts],
+      };
+    }
+
+    const outputRecord = await waitForRecentAssistantOutputRecord({
+      sessionKeys: [localSessionKey, sessionKey],
+      sessionId,
+      afterMs: dispatchStartedAt,
+    });
+    const assistantTexts = normalizeAssistantOutputTexts(outputRecord?.assistantTexts);
+    if (assistantTexts.length === 0) {
+      return {
+        source: 'none',
+        texts: [],
+      };
+    }
+
+    runtimeOutputSummary.counts.assistantTextFallback += assistantTexts.length;
+    for (const text of assistantTexts) {
+      appendRuntimeOutputPreview(runtimeOutputSummary.previews.assistantTextFallback, text);
+    }
+    return {
+      source: 'assistant_text',
+      texts: assistantTexts,
+    };
+  };
+
   const recordRuntimeTextEvent = (kind, text) => {
     if (!Object.prototype.hasOwnProperty.call(runtimeOutputSummary.counts, kind)) return;
     runtimeOutputSummary.counts[kind] += 1;
@@ -2301,6 +2584,21 @@ function createDeliveryReplyDispatcher({
     return true;
   };
 
+  const submitMessageToolReply = async ({ text } = {}) => {
+    const normalized = sanitizeRelayContinuationText(text);
+    if (!normalized) return false;
+    runtimeOutputSummary.counts.messageToolReply += 1;
+    appendRuntimeOutputPreview(runtimeOutputSummary.previews.messageToolReply, normalized);
+    runtimeOutputSummary.relayContinuationSource = 'message_tool';
+    runtimeOutputSummary.relayContinuationPreview = previewRuntimeOutputText(normalized);
+    if (isExactNoReplyToken(normalized)) {
+      runtimeOutputSummary.relayContinuationSource = 'message_tool_no_reply_token';
+      runtimeOutputSummary.relayContinuationPreview = 'NO_REPLY';
+      return await flushKeptSilent('no_reply_token');
+    }
+    return await flushReply(normalized);
+  };
+
   const flushKeptSilent = async (reason = null) => {
     if (replied || keptSilent || suppressed) return false;
     if (allowReply === false) {
@@ -2346,18 +2644,39 @@ function createDeliveryReplyDispatcher({
   const markDispatchIdle = async () => {
     await dispatchApi.dispatcher.waitForIdle?.();
     if (!replied && !suppressed) {
+      let assistantTextFallback = {
+        source: 'none',
+        texts: [],
+      };
+      const shouldResolveAssistantTextFallback = (
+        replyResolverTexts.length > 0
+        || runtimeOutputSummary.counts.assistantMessageStart > 0
+      );
+      if (finalTexts.length === 0 && blockTexts.length === 0 && shouldResolveAssistantTextFallback) {
+        assistantTextFallback = await resolveAssistantTextFallback();
+      }
+      const continuationFinalTexts = finalTexts.length > 0
+        ? finalTexts
+        : assistantTextFallback.texts;
       const allowPartialFallback = (
         runtimeOutputSummary.counts.final > 0
-        && finalTexts.length === 0
+        && continuationFinalTexts.length === 0
         && blockTexts.length === 0
         && runtimeOutputSummary.counts.nonRenderableFinal === 0
       );
       const safeContinuation = buildRelayContinuationText({
-        finalTexts,
+        finalTexts: continuationFinalTexts,
         blockTexts,
         partialText: partialContinuationText,
         allowPartialFallback,
       });
+      if (
+        safeContinuation.source === 'final'
+        && finalTexts.length === 0
+        && assistantTextFallback.source !== 'none'
+      ) {
+        safeContinuation.source = assistantTextFallback.source;
+      }
       runtimeOutputSummary.relayContinuationSource = safeContinuation.source;
       runtimeOutputSummary.relayContinuationPreview = safeContinuation.text
         ? previewRuntimeOutputText(safeContinuation.text)
@@ -2414,23 +2733,28 @@ function createDeliveryReplyDispatcher({
         recordRuntimeLifecycle('compactionEnd');
       },
     },
+    recordReplyResolverPayloads,
     markDispatchIdle,
     didReply: () => replied,
     didKeepSilent: () => keptSilent,
+    submitMessageToolReply,
     getRuntimeOutputSummary: () => ({
       counts: { ...runtimeOutputSummary.counts },
       previews: {
         final: [...runtimeOutputSummary.previews.final],
         block: [...runtimeOutputSummary.previews.block],
         tool: [...runtimeOutputSummary.previews.tool],
-      partial: [...runtimeOutputSummary.previews.partial],
-      reasoning: [...runtimeOutputSummary.previews.reasoning],
-      operationalNotice: [...runtimeOutputSummary.previews.operationalNotice],
-      runtimeErrorFinal: [...runtimeOutputSummary.previews.runtimeErrorFinal],
-    },
-    relayContinuationSource: runtimeOutputSummary.relayContinuationSource,
-    relayContinuationPreview: runtimeOutputSummary.relayContinuationPreview,
-    replyTransport,
+        partial: [...runtimeOutputSummary.previews.partial],
+        reasoning: [...runtimeOutputSummary.previews.reasoning],
+        operationalNotice: [...runtimeOutputSummary.previews.operationalNotice],
+        runtimeErrorFinal: [...runtimeOutputSummary.previews.runtimeErrorFinal],
+        replyResolver: [...runtimeOutputSummary.previews.replyResolver],
+        assistantTextFallback: [...runtimeOutputSummary.previews.assistantTextFallback],
+        messageToolReply: [...runtimeOutputSummary.previews.messageToolReply],
+      },
+      relayContinuationSource: runtimeOutputSummary.relayContinuationSource,
+      relayContinuationPreview: runtimeOutputSummary.relayContinuationPreview,
+      replyTransport,
       replyFallbackUsed,
       keptSilentTransport,
       keptSilentFallbackUsed,
@@ -2444,18 +2768,23 @@ async function runDeliveryReplyDispatch({
   relayClient,
   deliveryId,
   sessionKey,
+  localSessionKey,
+  sessionId,
   localAgentId,
   allowReply,
   logger,
   runtimeAccountId,
   inboundCtx,
+  activeDeliveryReplies = null,
 } = {}) {
   const {
     dispatcher,
     replyOptions,
+    recordReplyResolverPayloads,
     markDispatchIdle,
     didReply,
     didKeepSilent,
+    submitMessageToolReply,
     getRuntimeOutputSummary,
   } = createDeliveryReplyDispatcher({
     runtime,
@@ -2463,19 +2792,59 @@ async function runDeliveryReplyDispatch({
     relayClient,
     deliveryId,
     sessionKey,
+    localSessionKey,
+    sessionId,
     localAgentId,
     allowReply,
     logger,
     runtimeAccountId,
   });
 
-  const dispatchResult = await runtime.channel.reply.dispatchReplyFromConfig({
+  const baseReplyResolver = await resolveOpenClawReplyResolver(runtime);
+  const replyResolver = baseReplyResolver
+    ? async (...args) => {
+      const result = await baseReplyResolver(...args);
+      recordReplyResolverPayloads(result);
+      return result;
+    }
+    : undefined;
+
+  const dispatchParams = {
     ctx: inboundCtx,
     cfg: currentCfg,
     dispatcher,
     replyOptions,
-  });
-  await markDispatchIdle();
+  };
+  if (replyResolver) {
+    dispatchParams.replyResolver = replyResolver;
+  }
+
+  const shouldRegisterMessageToolCompat = (
+    inboundCtx?.sessionKind === 'conversation'
+    && activeDeliveryReplies
+    && typeof activeDeliveryReplies.register === 'function'
+  );
+  const unregisterMessageToolCompat = shouldRegisterMessageToolCompat
+    ? activeDeliveryReplies.register({
+      accountId: runtimeAccountId,
+      localAgentId,
+      targetAgentId: inboundCtx?.RelayFromAgentId || inboundCtx?.SenderId || inboundCtx?.OriginatingFrom || null,
+      deliveryId,
+      sessionKey,
+      localSessionKey,
+      sessionId,
+      conversationKey: inboundCtx?.RelayConversationKey || inboundCtx?.conversationKey || null,
+      submitMessageToolReply,
+    })
+    : null;
+
+  let dispatchResult;
+  try {
+    dispatchResult = await runtime.channel.reply.dispatchReplyFromConfig(dispatchParams);
+    await markDispatchIdle();
+  } finally {
+    unregisterMessageToolCompat?.();
+  }
 
   return {
     dispatchResult,
@@ -2529,6 +2898,7 @@ async function maybeBridgeRuntimeInboundEvent({
   runtime,
   cfg,
   inbound,
+  activeDeliveryReplies = null,
 }) {
   const delivery = event?.delivery && typeof event.delivery === 'object' && !Array.isArray(event.delivery)
     ? event.delivery
@@ -2661,6 +3031,7 @@ async function maybeBridgeRuntimeInboundEvent({
     CommandAuthorized: commandAuthorized,
     RelayDeliveryId: isRelayDelivery ? deliveryId : null,
     RelayFromAgentId: fromAgentId,
+    RelayConversationKey: metadata.conversationKey || null,
     UntrustedContext,
   });
 
@@ -2726,11 +3097,14 @@ async function maybeBridgeRuntimeInboundEvent({
     relayClient,
     deliveryId,
     sessionKey,
+    localSessionKey,
+    sessionId: sessionArtifacts.sessionId || null,
     localAgentId,
     allowReply,
     logger,
     runtimeAccountId,
     inboundCtx,
+    activeDeliveryReplies,
   });
 
   const shouldRetryKickoffDispatch = (
@@ -2772,11 +3146,14 @@ async function maybeBridgeRuntimeInboundEvent({
       relayClient,
       deliveryId,
       sessionKey,
+      localSessionKey,
+      sessionId: sessionArtifacts.sessionId || null,
       localAgentId,
       allowReply,
       logger,
       runtimeAccountId,
       inboundCtx,
+      activeDeliveryReplies,
     }));
   }
 
@@ -2856,6 +3233,7 @@ export function createClaworldChannelPlugin({
   const lifecycles = new Map();
   const accountRuntimeContexts = new Map();
   const accountBindingStates = new Map();
+  const activeDeliveryReplies = createActiveDeliveryReplyRegistry();
 
   function resolveAccountBindingKey(runtimeConfig = {}, fallbackAccountId = 'default') {
     return String(runtimeConfig?.accountId || fallbackAccountId || 'default');
@@ -3290,6 +3668,7 @@ export function createClaworldChannelPlugin({
               runtime: runtimeContext.runtime,
               cfg: runtimeContext.cfg,
               inbound,
+              activeDeliveryReplies,
             }).catch((error) => {
               logger.error?.(`[claworld:${runtimeAccountId}] inbound bridge exception`, {
                 error: error?.message || String(error),
@@ -3692,8 +4071,44 @@ async function generateRuntimeProfileCard(context = {}) {
       deliveryMode: 'direct',
       createReplyEnvelope: (params = {}) => outbound.createReplyEnvelope(params),
       sendText: async (ctx = {}) => {
-        if (typeof fetchImpl !== 'function') throw new Error('fetch is unavailable for claworld outbound');
         const resolvedContext = await resolveBoundRuntimeContext(ctx);
+        const activeReply = activeDeliveryReplies.resolve({
+          accountId: resolvedContext.accountId || ctx.accountId || null,
+          to: ctx.to,
+        });
+        const activeReplyText = normalizeClaworldText(ctx.text, null);
+        if (activeReply && activeReplyText) {
+          const submitted = await activeReply.submitMessageToolReply?.({
+            text: activeReplyText,
+            to: ctx.to,
+          });
+          const clientMessageId = normalizePluginOptionalText(
+            ctx.clientMessageId || ctx.metadata?.clientMessageId || null,
+          ) || buildGeneratedClientMessageId();
+          logger.info?.(`[claworld:${resolvedContext.accountId || ctx.accountId || 'default'}] routed message tool send through active delivery reply`, {
+            deliveryId: activeReply.deliveryId || null,
+            sessionKey: activeReply.sessionKey || null,
+            localSessionKey: activeReply.localSessionKey || null,
+            targetAgentId: activeReply.targetAgentId || normalizeClaworldTarget(ctx.to) || null,
+            submitted: submitted === true,
+          });
+          return {
+            channel: 'claworld',
+            messageId: activeReply.deliveryId || `delivery_${Date.now()}`,
+            chatId: activeReply.targetAgentId || normalizeClaworldTarget(ctx.to) || ctx.to || null,
+            timestamp: Date.now(),
+            meta: {
+              clientMessageId,
+              sessionKey: activeReply.sessionKey || null,
+              turnId: activeReply.deliveryId || null,
+              conversationKey: activeReply.conversationKey || null,
+              targetAgentId: activeReply.targetAgentId || normalizeClaworldTarget(ctx.to) || null,
+              deliveryId: activeReply.deliveryId || null,
+              routedVia: 'delivery_reply',
+            },
+          };
+        }
+        if (typeof fetchImpl !== 'function') throw new Error('fetch is unavailable for claworld outbound');
         return deliverRelayMessage({
           runtimeConfig: resolvedContext.runtimeConfig,
           to: ctx.to,

package/src/openclaw/plugin/register.js

@@ -1,4 +1,7 @@
-import { createClaworldChannelPlugin } from './claworld-channel-plugin.js';
+import {
+  createClaworldChannelPlugin,
+  recordClaworldRuntimeAssistantOutput,
+} from './claworld-channel-plugin.js';
 import {
   projectToolChatRequestMutationResponse,
   projectToolCreateWorldResponse,
@@ -1049,13 +1052,14 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
     {
       name: manageConversationsTool,
       label: 'Claworld Manage Conversations',
-      description: 'Terminal conversation lifecycle surface for starting/re-engaging chat requests and deciding pending requests. Live turns remain owned by conversation sessions.',
+      description: 'Terminal conversation lifecycle surface for starting/re-engaging direct or world-scoped chat requests, checking state, and deciding pending requests. Use this main-session surface for user requests to contact, PK, continue, or re-engage a Claworld peer. Live turns remain owned by conversation sessions.',
       metadata: buildToolMetadata({
         category: 'conversation_management',
         usageNotes: [
           'action=request starts a direct or world-scoped chat request.',
           'action=list_related/get_state, accept, reject, and close manage product-level conversation state decisions.',
           'action=close is a backend close; natural peer-facing endings still use [[request_conversation_end]] inside the Conversation Session.',
+          'Main Session peer-facing opener/reply/final content enters Claworld through action=request or a backend-managed Conversation Session, not through local session references.',
           'Do not use this tool for live conversation turns.',
         ],
       }),
@@ -1718,17 +1722,17 @@ function buildRegisteredTools(api, plugin) {
     {
       name: 'claworld_request_chat',
       label: 'Claworld Request Chat',
-      description: 'Use in the main session to create a new Claworld chat request or re-engage a selected public identity. Do not use for live conversation turns, current-session replies, or progress relay inside an already-open Claworld chat runtime.',
+      description: 'Use in the main session to create a new Claworld chat request or re-engage a selected public identity. Do not use for live conversation turns or current-session replies.',
       metadata: buildToolMetadata({
         category: 'chat_request',
         usageNotes: [
           'Primary actor/session: main session only. Use this tool when the user wants to start a new request or re-engage someone after an earlier request or chat went silent or ended.',
-          'If the user asks to contact the same person again, call this tool again to create a fresh request or re-engagement instead of using inter-session relay.',
+          'If the user asks to contact the same person again, call this tool again to create a fresh request or re-engagement.',
           'For world-scoped chat or re-engagement, use the displayName and agentCode returned by world member search.',
           'The backend resolves the target by agentCode.',
           'If the current displayName for that agentCode no longer matches, the tool can still route by the current owner and return an explicit warning with the current displayName.',
           'openingMessage is required and must contain non-blank kickoff intent; missing or blank opener text fails with opening_message_required.',
-          'Do not use this tool for replying inside an already-open Claworld chat, for runtime live turns, or for pulling progress from a local chat session.',
+          'Do not use this tool for replying inside an already-open Claworld chat or for runtime live turns.',
           'After creation, use claworld_chat_inbox to inspect pending, expired, rejected, opening, ending, active, silent, or ended status, or wait for the peer to accept.',
           'Once accepted, the runtime owns the live conversation loop.',
         ],
@@ -1757,7 +1761,7 @@ function buildRegisteredTools(api, plugin) {
         ],
       }),
       parameters: objectParam({
-        description: 'In the main session, create a new direct or world-scoped chat request, or re-engage a previously silent or ended relationship, for one target agent. Provide the target displayName, agentCode, and non-blank openingMessage. Do not use this payload for current live replies.',
+        description: 'In the main session, create a new direct or world-scoped chat request, or re-engage a previously silent or ended relationship, for one target agent. Use this for user requests to contact, PK, continue, or send peer-facing Claworld conversation content. Provide the target displayName, agentCode, and non-blank openingMessage. Do not use this payload for current live replies.',
         required: ['accountId', 'displayName', 'agentCode', 'openingMessage'],
         properties: {
           accountId: accountIdProperty,
@@ -1805,19 +1809,19 @@ function buildRegisteredTools(api, plugin) {
     {
       name: 'claworld_chat_inbox',
       label: 'Claworld Chat Inbox',
-      description: 'Use in the main session to inspect Claworld inbox state or decide one pending chat request. Default action=list is query-only and returns pending requests, recent terminal requests, plus current or recent chats with local session references for internal tracking; action=accept or action=reject is the canonical pending-request decision surface. Do not use this tool to send a live message to the peer.',
+      description: 'Use in the main session to inspect Claworld inbox state or decide one pending chat request. Default action=list is query-only and returns pending requests, recent terminal requests, plus current or recent chats with local session references for internal tracking, summaries, diagnostics, and reports; action=accept or action=reject is the canonical pending-request decision surface. Do not use this tool to send a live message to the peer.',
       metadata: buildToolMetadata({
         category: 'chat_request',
         usageNotes: [
           'Primary actor/session: main session. Default action=list is a status and query surface across inbound and outbound items.',
           'list returns actionable pending requests, recent terminal requests such as expired/rejected, and current or recent chats.',
           'action=accept and action=reject are request-decision actions for pending requests only. They do not send a freeform peer message.',
-          'Use this tool to locate the relevant Claworld chat and the localSessionKey tied to it for internal tracking, summaries, orchestration, or follow-up against the host local session tools.',
+          'Use this tool to locate the relevant Claworld chat and the localSessionKey tied to it for internal tracking, summaries, diagnostics, or reports.',
           'localSessionKey is a local runtime reference only, not a transport address for sending a user message directly to the peer.',
           'Optional filters can narrow by direction, mode, status, worldId, chatRequestId, conversationKey, localSessionKey, or counterpartyAgentId.',
-          'If the user asks about one chat, first locate it here, then use your local session-send tool to ask that local session for a progress update or short summary.',
-          'Do not use this tool to continue an already-open live conversation turn; use the current local chat session native reply or send flow instead.',
-          'Prefer asking the local chat session for a concise update before inspecting raw local transcript details.',
+          'For user requests to contact, PK, continue, or re-engage a Claworld peer, use claworld_manage_conversations(action=request) with the intended direct or world scope.',
+          'Peer-facing opener/reply/final content is delivered by the Conversation Session and backend conversation runtime. Main Session must not use sessions_send to write peer-facing content into a local conversation session.',
+          'Prefer Claworld conversation state, reports, and concise summaries before inspecting raw local transcript details.',
           'Global counts stay visible even when filters are applied; filtered counts describe the current narrowed result set.',
           'After action=accept or action=reject, call action=list again to refresh the inbox view.',
         ],
@@ -2191,6 +2195,20 @@ export function registerClaworldPluginFull(api, plugin) {
     throw new Error('registerClaworldPluginFull requires a plugin instance');
   }
   if (typeof api.on === 'function') {
+    api.on('llm_output', async (event = {}, ctx = {}) => {
+      const assistantTexts = Array.isArray(event?.assistantTexts)
+        ? event.assistantTexts
+        : [];
+      if (assistantTexts.length === 0) return;
+      recordClaworldRuntimeAssistantOutput({
+        sessionKey: normalizeText(ctx?.sessionKey ?? event?.sessionKey, null),
+        sessionId: normalizeText(ctx?.sessionId ?? event?.sessionId, null),
+        runId: normalizeText(ctx?.runId ?? event?.runId, null),
+        assistantTexts,
+        timestamp: event?.timestamp || ctx?.timestamp || null,
+      });
+    });
+
     api.on('before_prompt_build', async (event = {}, ctx = {}) => {
       const logger = getHookLogger(api);
       const workspaceRoot = await resolveHookWorkspaceRoot(api, event, ctx);

package/src/openclaw/runtime/working-memory.js

@@ -145,6 +145,12 @@ export function buildClaworldContextPointer(options = {}) {
     'Do not load raw Claworld transcripts by default.',
     'Use the session directory before searching raw local session files.',
     'Do not treat open Claworld loops as ordinary main-session todos before checking these files.',
+    '',
+    '## Main Session Claworld Conversation Boundary',
+    '- For user requests to contact a Claworld person/member, find someone to chat with, start a PK, continue a peer conversation, or send a peer-facing message, use Claworld tools such as `claworld_search`, `claworld_get_public_profile`, and `claworld_manage_conversations`.',
+    '- Use `claworld_manage_conversations(action=request)` to create or re-engage a direct or world-scoped chat request; use `get_state` or `list_related` to inspect conversation state.',
+    '- `localSessionKey` is an internal runtime reference for state lookup, summaries, diagnostics, and reports. Peer-facing opener/reply/final text is delivered by the Conversation Session and backend conversation runtime.',
+    '- Main Session must not use `sessions_send` to place peer-facing opener/reply/final text into an `agent:...:conversation:...` session.',
   ].join('\n');
 }
 
@@ -213,6 +219,7 @@ function buildClaworldManagementStartupPrompt(options = {}) {
     '## Reporting Route',
     '- Reports and approval requests follow the Reporting Rules in the `claworld-management-session` skill.',
     buildClaworldManagementReportingInstruction(mainSessionKey),
+    '- Use the reporting route for Main Session context and owner-report continuity. Peer-facing opener/reply/final content for Claworld conversations goes through `claworld_manage_conversations` and the backend Conversation Session runtime.',
     '- If no safe Main route exists or session send fails, write a report artifact, journal the failure, and retry or surface it on the next Main route.',
   ].join('\n');
 }