🤖 MetaBot

在飞书 / Telegram / 微信上用手机控制 Claude Code、Kimi Code 或 Codex CLI

写代码 · 管 Agent · 自动化一切

中文 · English · 📚 文档

支持 Claude Code、Kimi Code 和 Codex CLI 三大引擎 — 订阅 / API Key 任你选，每个 Bot 可独立选引擎。

git clone https://github.com/xvirobotics/metabot.git ~/metabot
cd ~/metabot && bash install.sh

安装器引导一切：工作目录 → 引擎选择（Claude / Kimi / Codex） → 订阅登录 → IM 平台 → PM2 自动启动。5 分钟上手。

自定义安装目录（默认 ~/metabot）：把 ~/metabot 换成你想要的路径即可，或 METABOT_HOME=/opt/metabot bash install.sh。Windows: .\install.ps1 -Dir C:\opt\metabot。

也可以一行直装：curl -fsSL https://raw.githubusercontent.com/xvirobotics/metabot/main/install.sh | bash。

🔑 自托管 & 鉴权（个人版）

MetaBot 开箱即是可自托管的个人版：本地跑、单 token 鉴权、不依赖任何 SSO / 企业登录。

• 本地优先：metabot-core 默认只监听 http://localhost:9200，首次启动自动生成本地 API token（写入 ~/.metabot-core/token）。CLI 与 Web 控制台都用它鉴权。数据默认落在 ~/.metabot-core/。
• 无需 SSO：不需要 OAuth / OIDC / 企业 VPN。要多人或公网访问时，自行在前面挂一个反向代理（可选 oauth2-proxy）即可，应用层不强制。
• 分发端点默认上锁：/cli/*、/install/* 安装分发端点默认需要 token；确认你的构建不含密钥后，可设 METABOT_PUBLIC_DISTRIBUTION=1 放开匿名下载。

三引擎：Claude Code ✕ Kimi Code ✕ Codex CLI 并列一等支持

MetaBot 不是只绑定一家 — 三大顶级 AI 编码 Agent 都内置原生支持，你的订阅直接用。

配置只需一行 — 每个 Bot 独立选引擎：

{ "name": "bulma", "engine": "kimi",   "kimi": { "thinking": true } }
{ "name": "goku",  "engine": "claude" }
{ "name": "vegeta", "engine": "codex", "codex": { "model": "gpt-5.4-codex" } }

Codex 支持通过本机 codex exec --json CLI 接入，并使用 codex exec resume 续接聊天会话。启动 MetaBot 前，请先执行 codex login 或配置好 Codex API key/profile。MetaBot 会把飞书侧的 /<skill-name> ... 调用统一转成 Codex 的 $<skill-name> ... 显式技能调用（例如安装了 /metaschedule 后，Codex 会收到 $metaschedule ...）。

Codex 迁移：复用 .claude 配置

Claude/Kimi 和 Codex 的发现路径不同。MetaBot 安装、更新和 Skill Hub 安装时会自动镜像内置 skills：

已有项目可以直接让 Codex 帮你迁移：

/model codex
请根据当前项目的 .claude 配置，为 Codex 创建对应的 .codex/skills 和 AGENTS.md：
- 把 .claude/skills/* 镜像到 .codex/skills/*
- 根据 CLAUDE.md 生成或更新 AGENTS.md
- 如果存在 .claude/agents/*.md，把这些 subagent 的角色、路由表和工作流整合进 AGENTS.md

如果你的宿主机禁用了 unprivileged user namespace，Codex CLI 的 workspace-write sandbox 可能在命令执行前报 bwrap: No permissions to create a new namespace。MetaBot 的 Codex 默认改用 danger-full-access 避开这个问题；需要更强隔离时可以通过 CODEX_SANDBOX 或 codex.sandbox 显式覆盖。

前端 Bot 用 Claude、后端 Bot 用 Kimi？完全可以。Agent 总线让它们互相委派任务，对面跑什么引擎对调用方透明。

你能用它做什么

• 手机写代码 — 地铁上用飞书给 Claude Code / Kimi Code / Codex CLI 发消息，它帮你改 bug、提 PR、跑测试
• 多 Agent 协作 — 前端 Bot、后端 Bot、运维 Bot，各自独立工作空间（甚至独立引擎），通过 Agent 总线互相委派任务
• 知识自生长 — Agent 把学到的东西存入 MetaMemory，组织每天都在变聪明，无需重新训练
• 自动化流水线 — "每天早上9点搜 AI 新闻，总结 Top 5，存档" — 一句话搞定
• 语音助手（Jarvis 模式） — AirPods 说 "Hey Siri, Jarvis"，免手免屏语音控制任意 Agent
• 自生长的组织 — 管理者 Bot 按需创建新 Agent，分配任务，安排后续跟进

为什么选 MetaBot

工作原理

飞书/TG/微信 → IM Bridge → Engine Router ──┬─→ Claude Code Agent SDK
                                            ├─→ Kimi Agent SDK（@moonshot-ai/kimi-agent-sdk）
                                            └─→ Codex CLI（codex exec --json 子进程）
                              ↕
                    MetaMemory（共享知识库）
                    定时调度（CC 原生 CronCreate / /loop；可选 /metaschedule 持久化）
                    Agent 总线（跨 Bot 通信，引擎无关）
                    Agent 工厂（可选 /metaskill，按需安装）

引擎层已抽象 —— Kimi 事件流和 Codex JSONL 都被翻译成 Claude 形状的 SDKMessage，流式卡片、工具调用追踪、MetaMemory/调度/Agent 总线在三种引擎下表现一致。

仓库布局（Monorepo）

MetaBot 从 2026-05-19 起把 metabot-core 合并进同一个 monorepo（npm workspaces）。Bridge 运行时仍在仓库根目录，吸收进来的中心服务侧在 packages/ 下面：

metabot/                       # 仓库根 —— bridge 运行时（bot 主机用 PM2 跑）
├── src/                       # bridge 引擎、流处理、Feishu/Telegram/微信桥接
├── bin/                       # CLI（metabot 单一入口 / doubao-tts）
├── web/                       # bridge 自带的浏览器 SPA
├── packages/                  # 吸收进来的 metabot-core
│   ├── server/                # 中心 HTTP 后端（ECS 部署单元）
│   ├── cli/                   # `metabot <子命令>` 功能 CLI 实现
│   ├── web-ui/                # 中心 SPA（Vite，编译后由 server/static/ 提供）
│   ├── cli-core/              # CLI/客户端共享底层
│   ├── metamemory/            # /api/memory 的瘦客户端
│   ├── skill-hub/             # /api/skills 的瘦客户端
│   └── skills/                # 默认 skill bundle 源（metabot SKILL.md）
└── docs/                      # 全量文档

两半之间只通过 HTTP /api/* 通信，不允许跨包 import（由 ESLint no-restricted-imports + packages/server/package.json exports 锁双重护栏）。Bridge 主机的 install.sh 只安装 bridge 自己 + CLI/CLI-Core 所需依赖，不会拉中心服务专属的 fastify / react / vite / 服务端 better-sqlite3。中心 server 部署仍走 cd packages/server && bash deploy/install.sh（脚本内部用 $PKG_DIR，不受路径迁移影响）。

多端接入

MetaBot 支持 4 种方式与你的 Agent 团队交互：

Web UI

浏览器端全功能聊天界面，部署即可用。访问地址：https://your-server/web/

• 实时流式聊天 — WebSocket 推送，Markdown 渲染，工具调用展示
• 电话语音模式 — 点击电话图标，全屏免手对话，VAD 自动检测说完
• RTC 实时通话 — 基于火山引擎 RTC 的双向语音/视频通话
• 群聊模式 — 多个 Agent 在一个对话中协作，@mention 路由
• MetaMemory 浏览器 — 搜索和浏览共享知识库
• 团队看板 — 查看 Agent 组织状态概览
• 文件支持 — 上传/下载文件，内联预览
• 明暗主题 — 跟随系统或手动切换

技术栈：React 19 + Vite + Zustand + react-markdown

语音功能需要 HTTPS。推荐用 Caddy 反向代理，自动管理证书。详见 Web UI 文档。

核心能力