MetaBot 个人 Agent 工作台
在聊天工具或浏览器中监督多引擎编程 Agent 完成长期工作。
- Star 数
- ★ 987
- 最近更新
- 8 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeOpenAI API · Claude API（部分支持）
- 开始前需要
- 典型场景
- 个人开发者在外出时通过飞书或 Telegram 向已登录 Codex Bot 下达改代码、运行测试和查看输出的任务。
- 主要局限
- 运行环境要求 Node.js >= 22.19、Git、至少一个外部引擎和聊天渠道凭证，首次配置并非零依赖。
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
MetaBot 是可自托管的个人 Agent 工作台，由本地 Core、Core Console、IM Bridge 和 metabot CLI 组成。它将飞书/Lark、Telegram、微信或本地 Web Chat 的消息路由到配置好的 Bot，再由 Codex CLI、Kimi Code 或 Claude Code 兼容路径在各自工作区执行。每个 Bot 可单独设置渠道凭证、引擎、工作目录和会话，并能通过 Agent Teams 与 Agent Bus 协作。Core Console 集中提供 Chat、Agents、Memory、Skills、T5T、Teams、CLI Access 和诊断，使用本地 Bearer Token 鉴权。产品面向愿意在自己的机器上运行服务、并接受 Agent 具备工作区读写和代码执行权限的个人开发者。
Bridge 接收飞书/Lark WebSocket、Telegram/微信长轮询或 Web Chat 输入，并按 Bot 配置路由消息。Codex 路径调用 codex exec --json 与 codex exec resume，输出 JSONL 流式结果、工具执行和会话续接；Kimi Code 路径使用官方本地 Server API，支持持久 Session、原子快照、问题交互、停止/续接、工具、子 Agent 和 Goal。界面会展示流式回复、工具执行和输出文件，并允许回答 Agent 提问或停止运行。系统还提供 MetaMemory 跨会话检索、Agent Teams 持久任务与运行状态、/goal 多轮检查点，以及受支持的 /background 后台任务。
- 个人开发者在外出时通过飞书或 Telegram 向已登录 Codex Bot 下达改代码、运行测试和查看输出的任务。
- 维护多个项目的工程师为不同 Bot 分配独立工作目录，并让 Codex 开发 Bot 与 Kimi 审阅 Bot 在 Agent Teams 中协作。
- 希望从浏览器监督本机代码任务的用户，在 Core Console 查看流式回答、工具调用和生成文件，并在需要时停止执行。
- 需要跨会话保留项目知识的开发者，使用 MetaMemory 检索记忆，并可选择同步到飞书知识库。
- 在飞书群管理多个自动化开发助手的群主，通过
@Bot /group-reply mention|all|status控制每个 Bot 的响应范围。
如何安装或部署这个 Agent？
前提：Node.js >= 22.19、Git、至少一个引擎及一个聊天渠道的凭证。在终端运行：
curl -fsSL https://github.com/xvirobotics/metabot/releases/latest/download/install.sh | bash另开终端安装并登录引擎，例如：
npm install -g @openai/codex
codex login或：
npm install -g @moonshot-ai/kimi-code@latest
kimi login按安装引导配置飞书/Lark、Telegram 或微信，然后运行 metabot status 和 metabot health。本地控制台默认地址为 http://localhost:9200；使用 ~/.metabot-core/token 中的 Token 登录并选择 Bot。
如何使用这个 Agent？
在 bots.json 中为每个 Bot 设置 name、engine、渠道凭证和 defaultWorkingDirectory；未指定 engine 时默认使用 codex。从已配置的聊天渠道或 http://localhost:9200 发送任务，使用 /model 查看或切换当前引擎/模型、/effort low|medium|high|xhigh|max|ultra 设置 Codex 推理强度、/status 查看会话、/stop 停止任务。需要受监督的跨轮执行时使用 /goal <条件>；支持的后台任务可用 /background <提示> 启动。
这个 Agent 有哪些优点和局限？
- 一个 Bridge 进程可混用 Codex、Kimi Code 与 Claude Code 兼容 Bot，并为每个 Bot 隔离工作区、会话和渠道凭证。
- 飞书/Lark 使用长连接 WebSocket，Telegram 和微信使用长轮询，文档明确说明无需开放公网入站端口。
- Core Console 将聊天、工具输出、停止控制、Memory、Skills、T5T、Teams 和诊断收敛到同一 Token 鉴权入口。
- 安装器会校验 Release 校验和；更新会验证
SHA256SUMS、完整 Manifest 与版本。
- 运行环境要求 Node.js >= 22.19、Git、至少一个外部引擎和聊天渠道凭证，首次配置并非零依赖。
- Codex 公开适配器当前基于
codex exec；README 明确称 Codex app-server 及 Codex/Kimi 在飞书执行中的 steering 尚待后续开放。 - 微信集成标注为灰测中，不能视为成熟稳定的渠道承诺。
- Agent 可在配置工作区读、写和执行代码；部署者必须保管 Token、限制 IM Bot 可见范围，并自行通过反向代理或私有网络保护端口。
这个 Agent 与同类方案有什么区别？
引擎选择：Codex 是默认引擎；Kimi Code 是一级可选引擎；Claude Code 以兼容路径保留，用于现有 Claude Bot、会话、Skills 和工作区。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| MetaBot 个人 Agent 工作台 当前 | 51 · 缺口较多 | ★ 987 | 8 天前 | TypeScript | Codex · Claude Code |
| Codexia | 57 · 缺口较多 | ★ 919 | 11 天前 | TypeScript | Codex · Claude Code |
| Claude-to-IM 桥接器 | 52 · 缺口较多 | ★ 2.9k | 6 个月前 | TypeScript | Codex · Claude Code |
| Claudexor | 76 · 表现良好 | ★ 480 | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：安装器生成 Bearer Token 并以 0600 权限保存，不写入日志；Release 资源解压前验证校验和；更新时验证 SHA256SUMS。但缺少对 Agent 权限最小化的明确设计（如工作区访问控制、命令白名单），用户确认机制仅在聊天中提及（如回答交互问题），未详细说明。数据流透明度有限，未说明哪些数据被发送到外部引擎。敏感数据处理有基本措施（Token 保护），但未提及加密存储。依赖安全有 overrides 和 CI，但未提供依赖漏洞扫描。外部影响（如代码执行）有警告，但未提供沙箱或审批流程。回滚机制未明确，仅提到更新保留数据。来源归属：发布者未验证，但 README 声明了开发方。
证据显示：README 与 package.json 版本一致（1.3.0），文档结构清晰，测试覆盖 CLI 功能，CI 配置了类型检查、测试和构建。但依赖可用性未验证，部分依赖来自 CDN（xlsx），存在可用性风险。失败消息方面，测试覆盖了错误处理（如缺失 token、无效日期），但未全面评估。
证据显示：明确目标用户（个人开发者），支持多种 IM 渠道和引擎，场景描述详细（移动端写代码、Agent Teams 等）。能力边界有说明（如仅 @ 路由、群回复模式），但未明确限制 Agent 可执行的操作。触发精度有命令列表和路由规则，但未详细说明所有触发条件。环境适配：支持 Node.js >=22.19，提供安装脚本和文档，但未提及操作系统兼容性细节。
证据显示：信息架构清晰，有文档站和目录结构。安装说明详细，包括自定义目录和更新。命名稳定，版本号明确。示例和 FAQ 有部分（如最小双 Bot 配置），但缺少 FAQ 部分。已知限制未明确列出，仅在安全部分提及风险。许可证为 MIT，版本化有 package.json 和更新命令，但缺少 changelog。维护责任：有贡献指南，但发布者未验证。
证据显示：输出可用性高，提供 CLI、Web UI 和 IM 集成，输出格式清晰。边际价值：提供多引擎支持和移动端访问，有独特功能（Agent Teams、MetaMemory）。成本效益：需要 Node.js 和多个引擎订阅，但未提供性能或资源消耗数据。
证据显示：README 中的功能声明有文档链接，但未提供独立验证。测试覆盖部分功能，但未覆盖所有声明。事实与推断分离：README 区分了功能描述和安装说明，但未明确标注哪些是推断。
- 发布者身份未验证，需谨慎对待来源。
- Agent 可执行代码，但缺少沙箱或审批机制，需限制工作区权限。
- 依赖来源包括 CDN，存在供应链风险。
- 未提供已知限制和故障排除的完整列表。
常见问题
是否必须使用 Codex？
engine 时默认是 codex。是否需要公网 IP？
本地控制台如何访问？
http://localhost:9200，粘贴 ~/.metabot-core/token 中由安装器生成的 Bearer Token。