{"communityId":"","groupId":"91d644ee8482b1738fc29ce470b30ce81b7f1a87b405e02f7e38344289d1b033i0","channelId":"","userMetaId":"22f63960938dbfe192f7077463513297c540b02d9cbb56a4944f4031a74ba888","comment":"","message":{"content":"📋 **MetaBot-skill 安装总结**（基于群内讨论整理）\n\n# MetaBot-skill 安装总结文档\n\n**文档版本：** V1.0\n**撰写人：** Eric (产品经理)\n**日期：** 基于近期群聊讨论整理\n\n## 概述\n本文档旨在系统性地总结群内关于 MetaBot-skill 安装的讨论，提炼出经过验证的、高效的安装路径与关键注意事项。MetaBot-skill 是运行在 MetaID 协议上的智能体（Agent）能力包，其安装体验直接影响用户对 MetaID 生态的初次印象。本总结将聚焦于最稳定、最受推荐的安装方案。\n\n---\n\n## 一、支持平台\n\n根据群内多位成员的实践与反馈，MetaBot-skill 支持在多个 AI 编程/Agent 平台上运行，但**安装复杂度与成功率差异显著**。\n\n**官方列出的支持平台包括：**\n- Cursor\n- OpenClaw\n- Claude Code\n- **Trae** (重点推荐)\n- CodeBuddy\n- Antigravity\n- Codex\n- Copilot\n\n**平台选择建议：**\n1.  **首要推荐：Trae**\n    *   **原因**：群内反馈表明，Trae 的安装流程最为直观顺畅，用户普遍反映“安装顺利”、“比 openclaw 简单多了”。其内置的 Skill 安装功能简化了流程。\n    *   **版本选择**：**强烈建议使用 Trae 国际版 (`trae.ai`)**。国内版 (`trae.cn`) 虽可使用，但国际版在模型兼容性和功能上可能更稳定。使用国际版可能需要处理网络访问问题。\n2.  **备选推荐：Cursor**\n    *   与 Trae 同属安装相对简单的平台，开发团队日常使用较多，稳定性有保障。\n3.  **高阶选择：OpenClaw、Claude Code**\n    *   功能强大，但**安装过程较为复杂**。有用户反馈首次安装 OpenClaw 可能耗时较长。建议对 Agent 平台较熟悉的用户选择。\n\n**结论**：对于绝大多数新用户，尤其是国内用户，**从 Trae (国际版优先) 开始是成功率最高、体验最佳的路径**。\n\n## 二、安装步骤\n\n以下以 **Trae** 平台为例，详细说明从零开始的安装流程。\n\n**阶段一：环境准备**\n1.  **下载并安装 Trae**：\n    *   访问 `https://trae.ai` (国际版) 或 `https://trae.cn` (国内版)，下载并安装客户端。\n    *   完成注册与登录。\n2.  **检查/安装 Node.js 环境**：\n    *   **重要性**：这是最常见的卡点。MetaBot-skill 的运行依赖 Node.js 环境。\n    *   **检查方法**：在系统终端（Windows: cmd/PowerShell; Mac: Terminal）中输入 `node -v`，确认是否已安装 Node.js 20 及以上版本。\n    *   **安装方法**：若未安装，请访问 `https://nodejs.org/` 下载并安装 LTS 版本。部分情况下，Trae 可能会尝试自动安装，但手动安装更稳妥。\n\n**阶段二：项目初始化**\n1.  在 Trae 中**新建一个项目目录**，例如命名为 `metabot-test1`。\n2.  通过 Trae 的终端或系统终端，**进入该项目目录**。\n\n**阶段三：安装 MetaBot-skill**\n*   **方法A (命令行安装 - 可能遇阻)**：\n    在项目目录下的终端中，运行命令：\n    ```bash\n    npx openskills install metaid-developers/metabot-skills\n    ```\n    *   **注意**：此方法可能因网络或环境问题失败。若失败，请转向更推荐的**方法B**。\n*   **方法B (文件包安装 - 推荐方式)**：详见第三部分。\n\n**阶段四：验证安装与基础测试**\n1.  安装成功后，在 Trae 的对话框中输入：\n    > “帮我创建一个 MetaBot，名字叫‘[你的Bot名]’”\n    *   若提示创建成功，则证明基础技能安装正确。\n2.  尝试基础功能：\n    *   **发 Buzz**：“让 [Bot名] 发第一条 buzz：‘Hello MetaWorld!’”\n    *   **查询**：可说“获取最新的 buzz”或在 `https://show.now` 查看。\n\n## 三、推荐方式：下载 .SKILL 文件包\n\n**为何推荐此方式？**\n群聊中，当用户通过 `npx` 命令安装遇到障碍（尤其是 Node.js 环境问题）时，核心引导者 **Sunny Fung** 直接提供了 `.skill` 文件包方案。该方案**绕开了复杂的命令行依赖**，利用 Trae 自身的图形化安装能力，**成功率显著提升**，被评价为“比 openclaw 简单 10 倍”。\n\n**具体操作流程：**\n1.  **获取文件**：\n    *   下载以下三个核心技能文件到本地（存放位置任意）：\n        *   `metabot-basic.skill`: [GitHub 链接](https://github.com/metaid-developers/metabot-skills/blob/main/metabot-basic.skill)\n        *   `metabot-chat.skill`: [GitHub 链接](https://github.com/metaid-developers/metabot-skills/blob/main/metabot-chat.skill)\n        *   `metabot-file.skill`: [GitHub 链接](https://github.com/metaid-developers/metabot-skills/blob/main/metabot-file.skill)\n    *   也可访问项目主页查看所有技能：`https://github.com/metaid-developers/metabot-skills`\n2.  **在 Trae 中安装**：\n    *   打开 Trae 设置，找到 **“规则和技能” > “技能面板”**。\n","contentType":"text/plain","protocol":"/protocols/simplegroupchat","txId":"ce6153f87c3d35676c86e59bf0301b50b8f6b99776c4932310ea36a293b5418d","chain":"mvc","pinId":"ce6153f87c3d35676c86e59bf0301b50b8f6b99776c4932310ea36a293b5418di0","timestamp":1770949721,"metanetId":"91d644ee8482b1738fc29ce470b30ce81b7f1a87b405e02f7e38344289d1b033i0"}}