xvirobotics / metabot

MetaBot **构建受监督的、自我进化的 Agent 组织的基础设施。** English | 中文 --- 为什么做 MetaBot Claude Code 是最强的 AI 编码 Agent —— 但它被锁在笔记本终端里。 MetaBot 解放了它。给每个 Agent 一个 Claude Code 大脑、持久化的共享记忆、创建新 Agent 的能力、以及通信总线。全部可以从飞书、Telegram 或微信手机端控制。 我们做 MetaBot 是为了把 XVI Robotics 打造成一个 **Agent Native 公司** —— 一个小团队的人类，监督一个自我进化的 AI Agent 组织。这是让这一切成为可能的基础设施。 架构 **自我进化 Agent 组织的三大支柱：** | 支柱 | 组件 | 作用 | |------|------|------| | **受监督 (Supervised)** | IM Bridge | 实时流式卡片展示每一步工具调用。人类看到 Agent 做的一切。通过飞书/Telegram/微信平台设置控制访问。 | | **自我进化 (Self-Improving)** | MetaMemory | 共享知识库。Agent 写入学到的东西，其他 Agent 检索引用。组织每天都在变聪明，无需重新训练。 | | **Agent 组织 (Organization)** | MetaSkill + 调度器 + Agent 总线 | 一个命令生成完整 Agent 团队。Agent 互相委派任务。定时任务自主运行。Agent 可以创建新 Agent。 | 核心组件 | 组件 | 说明 | |------|------| | **Claude Code 内核** | 每个 Bot 都是完整的 Claude Code 实例 — Read, Write, Edit, Bash, Glob, Grep, WebSearch, MCP 等。 模式自主运行。 | | **MetaSkill** | Agent 工厂。 调研最佳实践后生成完整的 Agent 团队（orchestrator + 专家 + reviewer）。通过 MetaMemory 实现 Agent 间共享知识。 | | **MetaMemory** | 内嵌 SQLite 知识库，全文搜索，Web UI。Agent 跨会话读写 Markdown 文档。所有 Agent 共享。变更自动同步到飞书知识库（带防抖）。Web UI： （启动日志会打印完整 URL）。 | | **飞书文档阅读** | 读取飞书文档/知识库页面并转为 Markdown。CLI ，或用户分享飞书链接时 Claude 自动读取。以 skill 形式提供。 | | **IM Bridge** | 飞书、Telegram 或微信（含手机端）与任意 Agent 对话。带颜色状态的流式卡片 + 工具调用追踪。微信通过 ClawBot 插件（iLink API）接入。 | | **Agent 总线** | 9100 端口 REST API。Agent 通过 互相对话。运行时创建/删除 Bot。以 skill 形式按需加载，不注入每次对话。 | | **Peers 联邦** | 跨实例 Bot 发现和任务路由。配置 连接多个 MetaBot 实例 — 同机或远程。 自动路由。 | | **定时任务调度器** | 一次性延迟和周期性 cron 任务。 = 工作日早8点新闻简报。支持时区配置（默认 Asia/Shanghai）。跨重启持久化，忙时自动重试。 | | **CLI 工具** | 、 、 、 命令安装到 。 一键更新重启。 管理 MetaMemory， 管理 Agent 总线， 读取飞书文档。 | 安装 **Linux / macOS：** **Windows (PowerShell)：** 安装器引导：工作目录 → Claude 认证 → IM 平台（飞书/Telegram/微信 ClawBot）→ PM2 自动启动。选择微信后安装器会自动显示 QR 登录链接，扫码即可绑定。 **随时更新** — 已安装？一条命令拉取、构建、重启： **完全卸载** — 移除 MetaBot、CLI 工具、技能和 PM2 进程： > **Windows 说明：** PowerShell 安装器自动检测 / / 来安装 Node.js。CLI 工具（ 、 、 、 ）通过 包装器安装，需要 Git for Windows（提供 Git Bash）。 手动安装 前置条件：Node.js 20+，Claude Code CLI 已安装并认证。支持 Linux、macOS 和 Windows。 快速配置 **Telegram**（30秒）： • 找 @BotFather → → 复制 token • 写入 → 完成（长轮询，无需 Webhook） **微信**（灰测中）： • iPhone 微信 8.0.70+ → 设置 → 插件 → 开启 **ClawBot** • 运行 ，IM 平台选 — 安装完成后自动显示 QR 链接，扫码绑定 • 或手动：在 添加 → → 终端扫码 • 详见 微信接入指南 **飞书**： • open.feishu.cn 创建应用 → 添加「机器人」能力 • 开通权限： 、 、 、 （群聊检测）、 、 （文档阅读和知识库同步） • 先启动 MetaBot，再开启「长连接」+ 事件 • 发布应用 你可以构建什么 • **个人 AI 开发者** — 手机上用飞书/Telegram/微信远程写代码，绑定你的项目 • **多 Agent 团队** — 前端 Bot、后端 Bot、运维 Bot，各自独立工作空间，通过 Agent 总线协作 • **自生长的组织** — 管理者 Bot 按需创建新 Agent，分配任务，安排后续跟进 • **自主研究流水线** — Agent 搜索、分析、将发现存入 MetaMemory、安排下一步 • **语音助手（Jarvis 模式）** — AirPods 说 "Hey Siri, Jarvis"，免手免屏语音控制任意 Agent。服务端 Whisper STT 高质量语音识别。见 语音设置指南 示例 Prompt 刚接触 MetaBot？以下是你可以直接在飞书/Telegram 中发送的真实 prompt，帮你解锁高级功能。 MetaMemory — 持久化知识库 MetaSkill — Agent 与 Skill 工厂 定时任务 — 自动化调度 Agent-to-Agent — 跨 Agent 协作 组合工作流 配置 ** ** — 定义你的 Bot： 所有 Bot 配置字段 | 字段 | 必填 | 默认值 | 说明 | |------|------|--------|------| | | 是 | — | Bot 标识名 | | | 是 | — | Claude 的工作目录 | | / | 飞书 | — | 飞书应用凭证 | | | Telegram | — | Telegram Bot Token | | | 微信(可选) | — | 预认证 iLink token（不填则 QR 登录） | | / | 否 | 不限 | 执行限制 | | | 否 | SDK 默认 | Claude 模型 | 环境变量 (.env) | 变量 | 默认 | 说明 | |------|------|------| | | — | bots.json 路径 | | | 9100 | HTTP API 端口 | | | — | Bearer 认证 | | | true | 启用 MetaMemory | | | 8100 | MetaMemory 端口 | | | | MetaMemory 认证（旧版） | | | — | 管理员 Token（完整访问，可见所有文件夹） | | | — | 读者 Token（仅可见 shared 文件夹） | | | — | 飞书服务应用（用于知识库同步和文档读取，未设置时回退到第一个 Bot） | | | — | 飞书服务应用密钥 | | | true | 启用 MetaMemory→飞书知识库同步 | | | — | 飞书知识库空间 ID | | | MetaMemory | 飞书知识库空间名称 | | | true | MetaMemory 变更时自动同步（带防抖） | | | 5000 | 自动同步防抖延迟 | | | 自动检测 | 二进制路径（未设置时通过 解析） | | | | MetaBot API 地址（CLI 远程访问） | | | | MetaMemory 服务地址（CLI 远程访问） | | | — | 逗号分隔的 Peer MetaBot 地址，用于跨实例发现 | | | — | 逗号分隔的 Peer Secret（与 PEERS 位置对应） | | | 自动 | 逗号分隔的 Peer 名称 | | | info | 日志级别 | 第三方 AI 服务商 支持任何 Anthropic 兼容 API： 安全 MetaBot 以 模式运行 Claude Code — 无交互式确认： • Claude 对工作目录有完整读写执行权限 • 通过飞书/Telegram/微信平台设置控制访问（应用可见范围、群成员管理） • 用 限制单次花费 • 同时保护 API 服务器和 MetaMemory • MetaMemory Web UI 需要 Token：浏览器打开 。启动日志会打印带 Token 的完整 URL。Token 会保存到 ，只需传递一次 • MetaMemory 支持**文件夹级 ACL**：设置 和 实现双角色访问。Admin 可见所有文件夹；Reader 仅可见 的文件夹 聊天命令 | 命令 | 说明 | |------|------| | | 清除会话 | | | 中止当前任务 | | | 查看会话状态 | | | 浏览知识库目录 | | | 搜索知识库 | | | 同步 MetaMemory 到飞书知识库 | | | 查看同步状态 | | | 帮助 | | | 生成 Agent 团队、Agent 或 Skill | | | Agent 总线、定时任务、Bot 管理 API 文档（按需加载） | | | 非内置命令自动转发给 Claude Code | API 参考 | 方法 | 路径 | 说明 | |------|------|------| | | | 健康检查 | | | | 列出 Bot（本地 + Peer） | | | | 运行时创建 Bot | | | | 获取 Bot 详情 | | | | 删除 Bot | | | | 与 Bot 对话（自动路由到 peer，支持 ） | | | | 列出 Peer 及状态 | | | | 创建一次性或周期性 (cron) 定时任务 | | | | 列出定时任务（一次性 + 周期性） | | | | 更新定时任务 | | | | 取消定时任务 | | | | 暂停周期性任务 | | | | 恢复已暂停的周期性任务 | | | | 触发 MetaMemory → Wiki 同步 | | | | 查看同步状态 | | | | 按 ID 同步单个文档 | | | | 读取飞书文档并转为 Markdown | | | | 费用与使用统计（按 Bot/用户） | | | | Prometheus 监控指标 | | | | 文字转语音（JSON 文本输入，MP3 音频输出） | CLI 工具 安装器将 、 、 、 （飞书 Bot 专属）可执行文件放到 （Linux/macOS）或 并创建 包装器（Windows），安装后立即可用。 远程访问 CLI 工具（ 、 ）支持连接远程 MetaBot/MetaMemory 服务器。在本地 文件中配置 URL： 这样多台机器可以共享同一个 MetaBot 和 MetaMemory 实例 —— 本地 Bot 可以向远程 Agent Bus 委派任务，任何机器都能读写共享记忆。 开发 生产部署 FAQ **需要公网 IP 吗？** — 不需要。飞书用 WebSocket，Telegram 和微信用长轮询。 **可以用国产模型吗？** — 可以。支持 Kimi、DeepSeek、GLM 等 Anthropic 兼容 API。 **Agent 间通信是实时的吗？** — 目前是同步请求-响应模式。异步双向协议在规划中。 关于 MetaBot 由 XVI Robotics 打造，我们做人形机器人大脑。我们在内部用 MetaBot 把公司打造成 Agent Native 组织 —— 一个小团队的人类，监督自我进化的 AI Agent。我们开源它，因为我们相信这是未来公司的运行方式。 Star History License MIT