multiclaws 0.4.16 → 0.4.18

package/dist/service/a2a-adapter.js

@@ -152,11 +152,16 @@ class OpenClawAgentExecutor {
         // Respect explicit completion flag from gateway
         if (details.isComplete === false)
             return null;
+        // Check for session-level error/status from gateway
+        const sessionError = details.error;
+        const sessionStatus = details.status;
         const messages = (details.messages ?? []);
-        if (messages.length === 0)
+        if (messages.length === 0 && !details.isComplete)
             return null;
         // If no explicit isComplete flag, use heuristic: check if the session is still executing
         if (details.isComplete === undefined) {
+            if (messages.length === 0)
+                return null;
             const lastMsg = messages[messages.length - 1];
             if (lastMsg && Array.isArray(lastMsg.content)) {
                 const content = lastMsg.content;
@@ -167,8 +172,7 @@ class OpenClawAgentExecutor {
                     return null;
             }
             // If the last message is a user message, the agent hasn't responded yet
-            const lastMsg2 = messages[messages.length - 1];
-            if (lastMsg2?.role === "user")
+            if (lastMsg?.role === "user")
                 return null;
         }
         // Session is complete — collect ALL assistant text messages in order
@@ -180,12 +184,23 @@ class OpenClawAgentExecutor {
             if (text)
                 allTexts.push(text);
         }
-        // Session completed but no text output — return a marker instead of null
-        // to avoid infinite polling / timeout
-        if (allTexts.length === 0) {
-            return "(task completed with no text output)";
+        // If we have assistant text, return it (even if there's also an error)
+        if (allTexts.length > 0) {
+            // Append error info if present so the delegating agent sees both
+            if (sessionError) {
+                allTexts.push(`[session error: ${sessionError}]`);
+            }
+            return allTexts.join("\n\n");
+        }
+        // No assistant text — check if the session reported an error
+        if (sessionError) {
+            return `Error: ${sessionError}`;
+        }
+        if (sessionStatus === "failed" || sessionStatus === "error") {
+            return `Error: session ended with status "${sessionStatus}"`;
         }
-        return allTexts.join("\n\n");
+        // Session truly completed with no output at all
+        return "(task completed with no text output)";
     }
     /** Extract text content from a single history message. */
     extractTextFromHistoryMessage(msg) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multiclaws",
-  "version": "0.4.16",
+  "version": "0.4.18",
   "description": "MultiClaws plugin for OpenClaw collaboration via A2A protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/multiclaws/SKILL.md

@@ -157,48 +157,88 @@ multiclaws_profile_show()
 
 适用于需要协商、确认、多次沟通才能完成的任务（如约会议、对需求、联合调试）。
 
-**根据用户是否需要看到中间过程，选择以下两种模式：**
+**默认使用异步子 agent 模式。** 主 agent 启动子 agent 后立即返回，子 agent 自主完成全部沟通并通过 `message` 工具实时汇报进展。
 
-#### 模式 A：交互式多轮（推荐 — 用户能看到每一步进展）
+#### 工作流程
 
-主 AI 直接处理多轮沟通，每轮之间向用户汇报进展。
+```
+用户: "帮我和小明、小红约明天下午的会议"
 
+1. multiclaws_agents()                    — 列出智能体，读 bio
+2. sessions_spawn(task="<协作任务 prompt>", mode="run")
+3. → 立即告诉用户: "已启动协作任务，会实时汇报进展"
+4.（子 agent 在后台自主完成全部沟通，通过 message 实时汇报）
+5. 子 agent 完成 → announce 回主 agent → 最终结果自动通知用户
 ```
-用户: "帮我和小明约明天下午的会议"
 
-1. multiclaws_agents()                    — 找到小明
-2. multiclaws_delegate(agentUrl="小明", task="我想约明天下午开会，你什么时候有空？")
-3. → 向用户汇报: "小明说明天下午 3 点和 4 点都可以"
-4.（用户说"约 3 点"或 AI 自行判断）
-5. multiclaws_delegate(agentUrl="小明", task="确认明天下午 3 点开会")
-6. → 向用户汇报: "已和小明确认明天下午 3 点"
+#### 子 agent 的 task prompt 模板
+
+spawn 子 agent 时，task 必须包含以下要素：
+
+```
+sessions_spawn(task="
+## 任务
+联系小明和小红，协商明天下午的会议时间。我这边下午 2-5 点都可以。
+
+## 可用工具
+- `multiclaws_agents()` — 查看所有智能体
+- `multiclaws_delegate(agentUrl, task)` — 向智能体发送任务
+
+## 执行步骤
+1. 调用 multiclaws_agents() 获取智能体列表
+2. 依次用 multiclaws_delegate 联系每个相关智能体
+3. 每完成一个智能体的沟通，立即用 message 工具向用户汇报进展
+4. 全部沟通完成后，汇总结果
+
+## 中间汇报
+每次 multiclaws_delegate 返回后，立即调用 message 工具告知用户当前进展。
+例如：'已联系小明，他说明天下午 3 点和 4 点都可以。正在联系小红...'
+
+## 完成条件
+所有相关智能体都已回复，汇总最终结果。
+", mode="run")
 ```
 
-**关键规则：**
-- 每次 `multiclaws_delegate` 返回后，**立即向用户汇报结果**，不要等全部完成
-- 如果能自行判断下一步（如对方给了选项，用户已表达偏好），直接继续
-- 如果需要用户决策（如对方提出多个方案），暂停并询问用户
-- 协商未达成一致时，继续发 `multiclaws_delegate`，最多 5 轮
+#### 关键规则
 
-#### 模式 B：自主式多轮（AI 全自动完成，只报告最终结果）
+- **主 agent 不做多轮沟通。** 所有多轮协作都交给子 agent。
+- **子 agent 用 `message` 工具实时汇报。** 子 agent 继承了父 agent 的频道上下文，`message` 发出的消息用户能直接看到。
+- 每次 `multiclaws_delegate` 返回后，子 agent 必须立即用 `message` 汇报，不要等全部完成。
+- 如果某个智能体没有回复或返回错误，子 agent 应在汇报中说明，继续联系其他智能体。
+- 协商未达成一致时，子 agent 可继续发 `multiclaws_delegate`，最多 5 轮。
+- 涉及多个智能体时，依次联系（串行），每个完成后立即汇报。
 
-适用于用户明确授权自主处理、不需要看中间过程的场景。使用 `sessions_spawn` 启动子 agent，子 agent 自主完成全部沟通。
+#### 示例场景
 
+**约多人会议：**
 ```
-用户: "帮我和小明约个会，我明天下午都行，你自己搞定"
-
-1. sessions_spawn(task="联系小明协商明天下午的会议时间。我这边下午都可以。
-   使用 multiclaws_delegate 与小明沟通，协商确定具体时间。
-   完成后汇报最终结果。", mode="run")
-2.（子 agent 自主多轮沟通）
-3. 子 agent 完成 → announce 回父 agent → 向用户报告最终结果
+用户: "帮我和小明、小红约明天下午的会议"
+
+主 agent:
+  1. multiclaws_agents() → 找到小明、小红
+  2. sessions_spawn(task="联系小明和小红...（按模板）", mode="run")
+  3. 回复用户: "已启动协作任务，正在联系小明和小红，会实时汇报进展。"
+
+子 agent（后台执行）:
+  1. multiclaws_delegate(小明, "明天下午 2-5 点开会，你什么时候有空？")
+     → 小明回复: "3 点和 4 点都行"
+     → message("已联系小明，他明天下午 3 点和 4 点都可以。正在联系小红...")
+  2. multiclaws_delegate(小红, "明天下午 2-5 点开会，小明 3 点和 4 点都行，你呢？")
+     → 小红回复: "3 点可以"
+     → message("小红也确认明天下午 3 点可以。")
+  3. multiclaws_delegate(小明, "确认明天下午 3 点开会")
+  4. multiclaws_delegate(小红, "确认明天下午 3 点开会")
+  5. 完成 → announce: "会议已确认：明天下午 3 点，参与人：小明、小红"
 ```
 
-**何时用模式 B：**
-- 用户明确说「你自己搞定」「自动处理」「不用问我」
-- 任务参数已完全明确，不需要用户中间决策
+**简单单人协作：**
+```
+用户: "问一下小明他那个 API 接口的参数格式"
 
-**默认用模式 A。** 除非用户明确要求自主处理，否则始终用交互式模式，确保用户看到每一步。
+（单轮任务，不需要多轮 → 直接用智能委派）
+1. multiclaws_delegate(小明, "你那个 API 接口的参数格式是什么？")
+2. 把结果返回给用户
+```
 
 ---