multiclaws

分类: 工具与效率 | 上传者: EricSun0218 | 下载: 0 | 版本: v1.0（最新）
以下规则在插件安装后生效，指导 AI 如何使用 MultiClaws 工具。
更新日志: Source: GitHub https://github.com/EricSun0218/multiclaws
目录结构

当前层级: skills/multiclaws/
📄 SKILL.md 5.7 KB
SKILL.md

# MultiClaws — 技能行为

以下规则在插件安装后生效，指导 AI 如何使用 MultiClaws 工具。

MultiClaws 让多个 OpenClaw 实例通过 [A2A（Agent-to-Agent）](https://google.github.io/A2A/) 协议组成团队、互相委派任务。

---

## 1. 首次安装：档案初始化（由插件 hook 触发）

首次安装后，插件会通过 `before_prompt_build` hook 自动在系统提示中注入初始化任务。
**无需每次对话手动检查 `multiclaws_profile_pending_review()`**，hook 已处理触发时机。

当 hook 注入了初始化任务时，按以下步骤执行：

1. **扫描当前环境**，自动生成 bio（markdown 格式），包含：
   - 可用的工具和 skills（推断能力）
   - 已连接的渠道（Telegram、Discord、Gmail 等）
   - 工作区内容（git 仓库、关键文件、项目目录）
   - 已安装的插件
   - 时区、语言等上下文

2. 向用户展示生成的档案，并逐一确认以下三项：
   - **名字**：展示推断出的名字，询问是否需要修改（需用户明确回答）
   - **Bio**：展示生成的 bio，询问是否需要修改（需用户明确回答）
   - **网络情况**：告知用户「同局域网开箱即用；跨网络需安装 Tailscale（https://tailscale.com/download）并重启 OpenClaw」，无需用户回答

3. 根据用户对名字和 bio 的回答更新内容后，调用 `multiclaws_profile_set(ownerName="...", bio="...")` 保存档案。

4. 调用 `multiclaws_profile_clear_pending_review()` 完成初始化。

**示例 bio：**
```markdown
后端工程师，负责 API 服务开发与维护。

**可处理：**
- 代码审查、调试、重构（Node.js / Go / Python）
- API 文档编写与接口设计
- 数据库查询与优化（PostgreSQL）

**数据访问：**
- Codebase: `/Users/eric/Project/api-service`（Node.js，~50k LOC）
- Email: Gmail
- Calendar: Google Calendar

**时区：** GMT+8
```

---

## 2. 团队操作前检查档案

在 **创建团队** 或 **加入团队** 之前：

```
multiclaws_profile_show()
```

如果 `bio` 为空或 `ownerName` 为空：
1. 自动生成 bio（同上）
2. 询问用户确认名字和 bio
3. 调用 `multiclaws_profile_set(...)` 设置
4. 然后继续团队操作

---

## 3. 保持档案更新

档案是动态的。在以下情况自动更新（调用 `multiclaws_profile_set`）：
- 用户连接了新渠道或数据源
- 用户安装了新 skill 或插件
- 用户的角色或关注点发生变化

不要等用户说「更新档案」，主动更新并简要提及即可。

---

## 工具列表

### 档案

| 工具 | 说明 | 参数 |
|------|------|------|
| `multiclaws_profile_set` | 设置名字和 bio | `ownerName`（可选）, `bio`（可选，markdown） |
| `multiclaws_profile_show` | 查看当前档案 | — |
| `multiclaws_profile_pending_review` | 检查是否有待确认的首次档案 | — |
| `multiclaws_profile_clear_pending_review` | 清除待确认标记 | — |

### 团队

| 工具 | 说明 | 参数 |
|------|------|------|
| `multiclaws_team_create` | 创建团队，返回邀请码 | `name` |
| `multiclaws_team_join` | 用邀请码加入团队 | `inviteCode` |
| `multiclaws_team_leave` | 离开团队 | `teamId`（可选） |
| `multiclaws_team_members` | 列出团队成员 | `teamId`（可选） |

### 智能体与委派

| 工具 | 说明 | 参数 |
|------|------|------|
| `multiclaws_agents` | 列出所有已知智能体及 bio | — |
| `multiclaws_add_agent` | 手动添加远端智能体 | `url`, `apiKey`（可选） |
| `multiclaws_remove_agent` | 移除已知智能体 | `url` |
| `multiclaws_delegate` | 委派任务给远端智能体 | `agentUrl`, `task` |
| `multiclaws_task_status` | 查看委派任务状态 | `taskId` |

---

## 重要规则

- **不要问用户 IP 地址或 selfUrl。** 插件自动处理。
- **只使用上面列出的工具。** 没有 `multiclaws_status` 工具。
- **Bio 是自由格式的 markdown。** 写得让另一个 AI 能读懂这个智能体能做什么。
- **每个智能体就像一个 skill。** 委派时读每个智能体的 bio，选最匹配的。
- **名字和 bio 必须用户明确确认**；网络情况仅告知，无需用户回答。

---

## 工作流

### 创建团队

```
1. multiclaws_profile_show()              — 检查档案
2.（如果为空）自动生成并设置 bio，确认名字和 bio
3. multiclaws_team_create(name="...")     — 返回 inviteCode (mc:xxxx)
4. 告诉用户把邀请码分享给队友
```

### 加入团队

```
1. multiclaws_profile_show()              — 检查档案
2.（如果为空）自动生成并设置 bio，确认名字和 bio
3. multiclaws_team_join(inviteCode="mc:xxxx")
   → 自动同步所有团队成员
```

### 智能委派

```
1. multiclaws_agents()                    — 列出智能体，读 bio
2. 选择 bio 最匹配任务的智能体
3. multiclaws_delegate(agentUrl="...", task="...")
4. 把结果返回给用户
```

选择智能体时：
- 匹配任务领域和 bio（如「财务报告」→ 有财务技能的智能体）
- 匹配数据需求（如「检查 API 代码」→ bio 中有该代码库的智能体）
- 多个匹配时选最具体的

---

## 跨网络

**同局域网：** 开箱即用，无需配置。

**不同网络：** 每人安装 [Tailscale](https://tailscale.com/download) 并登录同一 tailnet，插件自动检测 Tailscale IP。

当加入或委派因网络错误失败时（ECONNREFUSED、ETIMEDOUT、fetch failed），引导用户：

> 你和对方不在同一网络。跨网络协作需要每个成员安装 Tailscale：
> 1. 下载安装：https://tailscale.com/download
> 2. 登录同一个 Tailscale 账号（或同一 tailnet）
> 3. 重启 OpenClaw，插件会自动检测 Tailscale IP
登录后下载/点赞/收藏 ❤ 2 | ★ 0
multiclaws

目录结构

SKILL.md

举报内容

提示
