multiclaws 0.3.0 → 0.3.2

package/README.md

@@ -6,7 +6,7 @@
 
 对你的 AI 说：
 
-> 请运行 `openclaw plugin install multiclaws`，安装完成后告诉我你能做什么
+> 请运行 `openclaw plugins install multiclaws`，安装完成后告诉我这个插件能做什么
 
 AI 会自动完成安装、配置和档案生成，无需手动修改任何文件。
 

package/README.zh-CN.md

@@ -6,7 +6,7 @@
 
 对你的 AI 说：
 
-> 请运行 `openclaw plugin install multiclaws`，安装完成后告诉我你能做什么
+> 请运行 `openclaw plugins install multiclaws`，安装完成后告诉我这个插件能做什么
 
 AI 会自动完成安装、配置和档案生成，无需手动修改任何文件。
 

package/dist/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const handlers_1 = require("./gateway/handlers");
 const multiclaws_service_1 = require("./service/multiclaws-service");
-const gateway_client_1 = require("./infra/gateway-client");
 const logger_1 = require("./infra/logger");
 const telemetry_1 = require("./infra/telemetry");
 function readConfig(api) {
@@ -296,13 +295,12 @@ function createTools(getService) {
 const plugin = {
     id: "multiclaws",
     name: "MultiClaws",
-    version: "0.3.0",
+    version: "0.3.1",
     register(api) {
         const config = readConfig(api);
         (0, telemetry_1.initializeTelemetry)({ enableConsoleExporter: config.telemetry?.consoleExporter });
         const structured = (0, logger_1.createStructuredLogger)(api.logger, "multiclaws");
         let service = null;
-        let bioSpawnAttempted = false;
         // Ensure required tools are in gateway.tools.allow at registration time
         // so the gateway starts with them already present (no restart needed).
         if (api.config) {
@@ -366,81 +364,47 @@ const plugin = {
                 }));
             },
         });
-        api.on("gateway_start", async () => {
+        api.on("gateway_start", () => {
             structured.logger.info("[multiclaws] gateway_start observed");
-            // On first run: spawn a subagent to generate bio and notify user (once only)
-            if (!service || !gatewayConfig || bioSpawnAttempted)
+        });
+        api.on("gateway_stop", () => {
+            structured.logger.info("[multiclaws] gateway_stop observed");
+        });
+        // Inject onboarding prompt when profile is pending first-run setup
+        api.on("before_prompt_build", async (_event, _ctx) => {
+            if (!service)
                 return;
             try {
-                const pending = await service.getPendingProfileReview();
-                if (!pending.pending)
+                const review = await service.getPendingProfileReview();
+                if (!review.pending)
                     return;
-                bioSpawnAttempted = true;
-                const profile = pending.profile;
-                const ownerName = profile?.ownerName || "unknown";
-                const task = [
-                    `You are initializing a MultiClaws agent profile for "${ownerName}" on first run.`,
-                    `MultiClaws enables multiple OpenClaw instances to collaborate as a team over A2A protocol.`,
-                    ``,
-                    `Complete all steps below, then send ONE message to the user.`,
-                    ``,
-                    `== STEP 1: Generate bio ==`,
-                    `Inspect the current environment:`,
-                    `- Available tools and skills (implies capabilities)`,
-                    `- Connected channels (Telegram, Gmail, Discord, etc.)`,
-                    `- Workspace contents (git repos, project folders, key files)`,
-                    `- Installed plugins`,
-                    `- Timezone and language`,
-                    ``,
-                    `Generate a bio in markdown — a "skill card" that other AI agents read to decide`,
-                    `whether to delegate tasks here. Include:`,
-                    `- One-line role description`,
-                    `- What this agent can handle`,
-                    `- What data/systems it has access to`,
-                    `- Timezone / language`,
-                    ``,
-                    `Call: multiclaws_profile_set(ownerName="${ownerName}", bio="<generated markdown>")`,
-                    ``,
-                    `== STEP 2: Check Tailscale ==`,
-                    `Check if Tailscale is active by looking at network interfaces for a 100.x.x.x IP address.`,
-                    `- Found 100.x.x.x: cross-network collaboration is ready.`,
-                    `- Not found: only LAN collaboration available.`,
-                    ``,
-                    `== STEP 3: Send ONE message to the user ==`,
-                    ``,
-                    `1. **MultiClaws 已就绪** — 简要介绍插件功能：`,
-                    `   "MultiClaws 让多个 OpenClaw 实例组成团队协作。你可以创建团队、邀请队友加入，然后把任务委派给队友的 AI——它会自动根据每个智能体的档案选择最合适的执行者。"`,
-                    ``,
-                    `2. **默认名字**: "你的默认名字是 '${ownerName}'，需要修改吗？"`,
-                    ``,
-                    `3. **Bio 预览**: 展示生成的 bio，问"这是根据你的环境自动生成的档案，需要修改吗？"`,
-                    ``,
-                    `4. **网络状态** (one line based on Step 2):`,
-                    `   - Tailscale active: "Tailscale 已检测到，跨网络协作已就绪。"`,
-                    `   - LAN only: "当前仅支持局域网协作。如需跨网络，安装 Tailscale：https://tailscale.com/download"`,
-                    ``,
-                    `5. **如何使用**:`,
-                    `   - "说「创建一个叫 xxx 的团队」创建团队，把邀请码分享给队友"`,
-                    `   - "说「用邀请码 mc:xxxx 加入团队」加入队友的团队"`,
-                    `   - "加入后，说「让 Bob 帮我做 xxx」就能把任务委派给队友的 AI"`,
-                    `   - "说「显示所有智能体」查看团队成员及其能力"`,
-                    ``,
-                    `Keep the message concise.`,
-                ].join("\n");
-                await (0, gateway_client_1.invokeGatewayTool)({
-                    gateway: gatewayConfig,
-                    tool: "sessions_spawn",
-                    args: { task, mode: "run" },
-                    timeoutMs: 30_000,
-                });
+                return {
+                    appendSystemContext: `## MultiClaws 首次安装 — 需要完成档案设置
+
+multiclaws 插件刚安装，需要在本次对话中完成以下初始化流程（优先处理，不管用户说了什么）：
+
+1. **扫描当前环境**，自动生成 bio（markdown 格式），内容包括：
+   - 用户角色和职责
+   - 可处理的任务类型（基于已安装 skills、工具、连接的渠道）
+   - 可访问的数据/系统（git 仓库、邮件、日历、Notion 等）
+   - 时区和语言
+
+2. 向用户展示生成的档案，并逐一确认以下三项（名字和 bio 需要用户明确回答）：
+   - **名字**：展示推断出的名字，询问是否需要修改
+   - **Bio**：展示生成的 bio，询问是否需要修改
+   - **网络情况**：告知用户「同局域网开箱即用；跨网络需安装 Tailscale（https://tailscale.com/download）并重启 OpenClaw」，无需用户回答
+
+3. 根据用户对名字和 bio 的回答更新档案内容（如需修改），然后调用 \`multiclaws_profile_set(ownerName="...", bio="...")\` 保存。
+
+4. 调用 \`multiclaws_profile_clear_pending_review()\` 完成初始化。
+
+**注意**：名字和 bio 需要用户明确确认；网络情况仅告知无需回答。`,
+                };
             }
             catch (err) {
-                structured.logger.warn(`[multiclaws] bio init task failed: ${err instanceof Error ? err.message : String(err)}`);
+                structured.logger.warn("[multiclaws] before_prompt_build: failed to check pending review: " + String(err));
             }
         });
-        api.on("gateway_stop", () => {
-            structured.logger.info("[multiclaws] gateway_stop observed");
-        });
     },
 };
 exports.default = plugin;

package/dist/types/openclaw.d.ts

@@ -38,6 +38,24 @@ export type PluginHookGatewayStartEvent = {
 export type PluginHookGatewayStopEvent = {
     reason?: string;
 };
+export type PluginHookAgentContext = {
+    agentId?: string;
+    sessionKey?: string;
+    sessionId?: string;
+    workspaceDir?: string;
+    channelId?: string;
+    trigger?: string;
+};
+export type PluginHookBeforePromptBuildEvent = {
+    prompt: string;
+    messages: unknown[];
+};
+export type PluginHookBeforePromptBuildResult = {
+    systemPrompt?: string;
+    prependContext?: string;
+    prependSystemContext?: string;
+    appendSystemContext?: string;
+};
 export type PluginTool = {
     name: string;
     description: string;
@@ -82,5 +100,10 @@ export type OpenClawPluginApi = {
             end: (body?: string) => void;
         }) => void;
     }) => void;
-    on: <K extends "message_received" | "gateway_start" | "gateway_stop">(name: K, handler: K extends "message_received" ? (event: PluginHookMessageEvent, ctx: PluginHookMessageContext) => void | Promise<void> : K extends "gateway_start" ? (event: PluginHookGatewayStartEvent) => void | Promise<void> : (event: PluginHookGatewayStopEvent) => void | Promise<void>) => void;
+    on: {
+        (name: "message_received", handler: (event: PluginHookMessageEvent, ctx: PluginHookMessageContext) => void | Promise<void>): void;
+        (name: "gateway_start", handler: (event: PluginHookGatewayStartEvent) => void | Promise<void>): void;
+        (name: "gateway_stop", handler: (event: PluginHookGatewayStopEvent) => void | Promise<void>): void;
+        (name: "before_prompt_build", handler: (event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext) => PluginHookBeforePromptBuildResult | void | Promise<PluginHookBeforePromptBuildResult | void>): void;
+    };
 };

package/package.json

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

package/skills/multiclaws/SKILL.md

@@ -6,29 +6,28 @@ MultiClaws 让多个 OpenClaw 实例通过 [A2A（Agent-to-Agent）](https://goo
 
 ---
 
-## 1. 首次运行：自动生成档案
+## 1. 首次安装：档案初始化（由插件 hook 触发）
 
-每次用户发消息时，先调用：
+首次安装后，插件会通过 `before_prompt_build` hook 自动在系统提示中注入初始化任务。
+**无需每次对话手动检查 `multiclaws_profile_pending_review()`**，hook 已处理触发时机。
 
-```
-multiclaws_profile_pending_review()
-```
-
-如果 `pending: true`：
+当 hook 注入了初始化任务时，按以下步骤执行：
 
-1. **自动生成 bio**，不要让用户手动填写。扫描当前环境：
+1. **扫描当前环境**，自动生成 bio（markdown 格式），包含：
    - 可用的工具和 skills（推断能力）
    - 已连接的渠道（Telegram、Discord、Gmail 等）
    - 工作区内容（git 仓库、关键文件、项目目录）
    - 已安装的插件
-2. 写成 **markdown** 格式的 bio——把它当作「技能卡」，其他 AI 读它来决定是否把任务委派过来。包含：
-   - 所有者名字和角色
-   - 这个智能体能处理什么
-   - 能访问什么数据/系统
    - 时区、语言等上下文
-3. 调用 `multiclaws_profile_set(ownerName="...", bio="...")` 设置档案
-4. 告诉用户：「你的默认名字是 xxx，需要修改吗？」并展示 bio 问是否需要修改
-5. 确认后调用 `multiclaws_profile_clear_pending_review()`
+
+2. 向用户展示生成的档案，并逐一确认以下三项：
+   - **名字**：展示推断出的名字，询问是否需要修改（需用户明确回答）
+   - **Bio**：展示生成的 bio，询问是否需要修改（需用户明确回答）
+   - **网络情况**：告知用户「同局域网开箱即用；跨网络需安装 Tailscale（https://tailscale.com/download）并重启 OpenClaw」，无需用户回答
+
+3. 根据用户对名字和 bio 的回答更新内容后，调用 `multiclaws_profile_set(ownerName="...", bio="...")` 保存档案。
+
+4. 调用 `multiclaws_profile_clear_pending_review()` 完成初始化。
 
 **示例 bio：**
 ```markdown
@@ -47,7 +46,7 @@ multiclaws_profile_pending_review()
 **时区：** GMT+8
 ```
 
-如果 `pending: false`：跳过档案检查，直接处理用户请求。
+---
 
 ## 2. 团队操作前检查档案
 
@@ -59,8 +58,11 @@ multiclaws_profile_show()
 
 如果 `bio` 为空或 `ownerName` 为空：
 1. 自动生成 bio（同上）
-2. 调用 `multiclaws_profile_set(...)` 设置
-3. 然后继续团队操作
+2. 询问用户确认名字和 bio
+3. 调用 `multiclaws_profile_set(...)` 设置
+4. 然后继续团队操作
+
+---
 
 ## 3. 保持档案更新
 
@@ -111,6 +113,7 @@ multiclaws_profile_show()
 - **只使用上面列出的工具。** 没有 `multiclaws_status` 工具。
 - **Bio 是自由格式的 markdown。** 写得让另一个 AI 能读懂这个智能体能做什么。
 - **每个智能体就像一个 skill。** 委派时读每个智能体的 bio，选最匹配的。
+- **名字和 bio 必须用户明确确认**；网络情况仅告知，无需用户回答。
 
 ---
 
@@ -120,7 +123,7 @@ multiclaws_profile_show()
 
 ```
 1. multiclaws_profile_show()              — 检查档案
-2.（如果为空）自动生成并设置 bio
+2.（如果为空）自动生成并设置 bio，确认名字和 bio
 3. multiclaws_team_create(name="...")     — 返回 inviteCode (mc:xxxx)
 4. 告诉用户把邀请码分享给队友
 ```
@@ -129,7 +132,7 @@ multiclaws_profile_show()
 
 ```
 1. multiclaws_profile_show()              — 检查档案
-2.（如果为空）自动生成并设置 bio
+2.（如果为空）自动生成并设置 bio，确认名字和 bio
 3. multiclaws_team_join(inviteCode="mc:xxxx")
    → 自动同步所有团队成员
 ```