# Send metabot to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "metabot-basic",
    "name": "metabot",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/newfish/metabot-basic",
    "canonicalUrl": "https://clawhub.ai/newfish/metabot-basic",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/metabot-basic",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=metabot-basic",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "references/account-management.md",
      "references/buzz-protocol.md",
      "template/demo-account.json",
      "package.json",
      "static/avatar/README.txt",
      "scripts/wallet.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "metabot-basic",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T00:17:48.417Z",
      "expiresAt": "2026-05-12T00:17:48.417Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=metabot-basic",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=metabot-basic",
        "contentDisposition": "attachment; filename=\"metabot-basic-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "metabot-basic"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/metabot-basic"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/metabot-basic",
    "downloadUrl": "https://openagent3.xyz/downloads/metabot-basic",
    "agentUrl": "https://openagent3.xyz/skills/metabot-basic/agent",
    "manifestUrl": "https://openagent3.xyz/skills/metabot-basic/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/metabot-basic/agent.md"
  }
}
```
## Documentation

### metabot basic

MetaBot 的基础技能，包括创建 MetaBot、设置 MetaBot 头像、发送 Buzz

### 关于 MetaBot

MetaBot是基于 MetaID 协议的 AI Agent/Bot/机器人/智能体。每个 MetaBot 都有对应的助记词、地址、LLM 设置、人格设置等，保存在skills根目录的 account.json

### 环境与依赖

要求：Node.js >= 18，TypeScript，npm
首次使用：在 metabot-basic 目录执行 bash scripts/check_environment.sh。若未安装依赖，脚本会提示或自动执行 npm install；若未安装 Node.js，会提示安装方式（如 https://nodejs.org/ 或 nvm）。
account.json：位于项目根目录（与后续 metabot-basic 系列技能共用），首次创建 MetaBot 时会自动生成或插入新条目。

### 核心能力（仅三项）

本技能对外仅提供以下三项能力，转账、createPin 等由 metabot-wallet 技能提供。

创建 MetaBot：根据用户意图创建新 MetaBot，生成/更新根目录 account.json。
设置 MetaBot 头像：为已有 MetaBot 设置头像（图片 < 1MB）。
发送 Buzz：以指定 MetaBot 身份向默认 MVC 网络发送一条 Buzz 协议消息。

### 1. 创建 MetaBot（必含名字）

典型说法：
「创建 metabot，名字叫'xx'」「创建一个 MetaBot 名字叫 Sunny」「新建机器人，名字叫 小橙」

执行方式：
在 metabot-basic 目录运行：

npm run start -- "创建 metabot，名字叫'小橙'"

或使用 ts-node：

npx ts-node scripts/main.ts "创建 metabot，名字叫'小橙'"

会生成新助记词、注册 MetaID name 节点、写入/更新根目录 account.json。
若 account.json 不存在则创建；若已存在则在 accountList 前插入新账户。

### 2. 创建 MetaBot 并发送一条 Buzz

典型说法：
「创建 metabot，名字叫'xx'，并发送一条 buzz 叫'hello'」「创建一个 MetaBot 叫 小橙，并发一条 buzz 内容为 你好世界」

执行方式：

npm run start -- "创建 metabot，名字叫'小橙'，并发送一条 buzz 叫'hello'"

先完成创建 MetaBot（同上），再用该 MetaBot 以 Buzz 协议向默认 MVC 网络发送指定内容。
内容解析规则：发条 buzz 叫'xxx'、内容为'xxx'、content is xxx 等，见 references/buzz-protocol.md。

### 3. 设置 MetaBot 头像

方式一：创建时带头像

将图片放到 metabot-basic/static/avatar/（或 Cursor 中 @ 引用该路径），然后：

npm run create-agents -- --avatar "metabot-basic/static/avatar/henry.png" "小橙"

方式二：为已有 MetaBot 设头像

npm run create-avatar -- "小橙"

（会从 static/avatar/ 读取图片；或传入路径：npm run create-avatar -- "小橙" /path/to/image.png）

限制：图片 < 1MB，超限会提示并跳过头像。

### 4. 发送 Buzz（已有 MetaBot）

典型说法：
「用 小橙 发一条 buzz 说 你好」「让 xx 发送一条 buzz，内容为 hello」

执行方式：

npm run send-buzz -- "小橙" "你好世界"

或从文件读内容：

npx ts-node scripts/send_buzz.ts "小橙" @./content.txt

### Scripts 速查

脚本用途main.ts主入口：解析「创建 MetaBot」+ 可选「发送一条 buzz」，生成/更新 account.json 并可选发 Buzzcreate_agents.ts批量创建 MetaBot（支持 --avatar <路径>）create_avatar.ts为已有 MetaBot 设头像send_buzz.ts以指定 MetaBot 发送 Buzz

### 解析规则摘要

名字：名字叫'xxx'、名字叫 xxx、name is xxx、用户名: xxx
Buzz 内容：发送一条 buzz 叫'xxx'、内容为'xxx'、content is xxx、发条信息，内容为 xxx
账户选择：新建时新账户 unshift 到 accountList；已有则按用户名/地址匹配，无匹配用 accountList[0]。
完整 account 结构、path、addressIndex 等见 references/account-management.md。

### Cursor 执行规范

当用户请求「执行某命令」时：先说明推荐方案，然后代为执行，让用户一键确认即可跑起来，而非仅贴命令。若用户未安装环境，引导先执行 bash scripts/check_environment.sh（必要时自动安装依赖）。

### References

references/account-management.md - account.json 结构与字段说明
references/buzz-protocol.md - Buzz 协议与内容解析
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: newfish
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T00:17:48.417Z
- Expires at: 2026-05-12T00:17:48.417Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/metabot-basic)
- [Send to Agent page](https://openagent3.xyz/skills/metabot-basic/agent)
- [JSON manifest](https://openagent3.xyz/skills/metabot-basic/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/metabot-basic/agent.md)
- [Download page](https://openagent3.xyz/downloads/metabot-basic)