MetaBot 个人 Agent 工作台

在聊天工具或浏览器中监督多引擎编程 Agent 完成长期工作。

Star 数
★ 1k
最近更新
13 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
自托管服务命令行工具网页应用
可在哪里用
通用 · 跨平台Codex · Claude CodeOpenAI API · Claude API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js >= 22.19GitCodex CLI、Kimi Code 或兼容 Claude 的 CLI 配置聊天渠道凭证Shell / 命令行网络访问本地文件系统
典型场景
个人开发者在外出时通过飞书或 Telegram 向已登录 Codex Bot 下达改代码、运行测试和查看输出的任务。
不适合
  • 不想在本机运行常驻服务、维护 Token 与端口的人
  • 需要零依赖、开箱即用托管服务的团队
  • 把微信渠道当作稳定生产通道的用户

这个 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 后台任务。

  1. 个人开发者在外出时通过飞书或 Telegram 向已登录 Codex Bot 下达改代码、运行测试和查看输出的任务。
  2. 维护多个项目的工程师为不同 Bot 分配独立工作目录,并让 Codex 开发 Bot 与 Kimi 审阅 Bot 在 Agent Teams 中协作。
  3. 希望从浏览器监督本机代码任务的用户,在 Core Console 查看流式回答、工具调用和生成文件,并在需要时停止执行。
  4. 需要跨会话保留项目知识的开发者,使用 MetaMemory 检索记忆,并可选择同步到飞书知识库。
  5. 在飞书群管理多个自动化开发助手的群主,通过 @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 工作台 当前 59 · 缺口较多 自托管服务免费 + 模型费 ★ 1k 13 天前 TypeScript Codex · Claude Code
Codexia 57 · 缺口较多 桌面应用免费 + 模型费 ★ 941 17 天前 TypeScript Codex · Claude Code
Oh My Codex(OMX) 67 · 存在缺口 命令行工具免费 + 模型费 ★ 34k 今天 TypeScript Codex
Claude-to-IM 桥接器 55 · 缺口较多 Agent 插件 / 技能免费 + 模型费 ★ 2.9k 7 个月前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
59/ 100 五分制 3.0 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 12/18
规范维护 13/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

安全文档给出工作区范围、Core/Bridge loopback 绑定、Token 0600、渠道凭证保管和显式 Memory 分享规则,且 Kimi 默认不自动批准工具请求;因此最小权限与敏感数据处理有实质依据。Codex 默认 approvalPolicy=never,用户确认不足;材料说明了主要数据和外部渠道路径,但没有完整的数据清单或逐项流向。依赖只列版本范围与覆盖项,未提供审计或漏洞处置证据;Agent 可读写执行并接入 IM、外部 Core 和调度,外部影响控制说明有限。更新保留用户数据并支持固定版本回退,但没有完整恢复流程。开发者署名和 MIT 文件存在,发布者身份与维护责任仍未在材料中充分确立。

可靠稳定8 / 14 · 2.9/5

README、安装文档、CLI 与引擎选择代码对默认 Codex、Kimi/Claude 兼容、端口和主要命令大体一致;局部能力边界也有说明。依赖可从 npm/GitHub 等渠道安装,但包清单含版本范围及一个 URL 依赖,材料没有供应链审计或离线可用性保障。安装失败诊断、health/doctor/status、运行日志和故障排除步骤较具体,因此常见故障有一定可诊断性。

适用触发12 / 18 · 3.3/5

材料清楚面向自托管个人用户,并覆盖飞书、Telegram、Slack、微信、Web、多引擎和工作区配置。引擎支持差异、Windows 当前不具备完整 Core/Web 生命周期、Codex app-server 尚未开放等边界写明;技能也限定各自命令用途。技能触发条件明确,但产品级场景、触发策略和环境限制并非处处详尽,故未给满分。

规范维护13 / 18 · 3.6/5

文档按安装、配置、功能、参考和排障组织,README 链接丰富;安装、更新、平台差异和故障排除步骤具体。CLI/技能命名收敛到 metabot,但仍保留多引擎和旧兼容路径,不能据此认定所有命名稳定。示例充足,FAQ 证据较少;已披露若干限制,但未见全面限制清单。LICENSE 明确为 MIT。包版本为 1.3.4,但样本没有变更日志或清晰版本治理说明。AGENTS.md 说明项目指导方式,LICENSE 指向 MetaBot contributors;维护主体和更新责任仍较有限。

有效结果7 / 13 · 2.7/5

产品提供统一 CLI、跨渠道 Agent 会话、共享记忆、Teams、调度和本地控制台,具有明显的整合用途;示例命令、运行标识符和故障处理提升输出可操作性。价值和常见使用成本有安装指南支撑,但运行 Agent 需要本地服务、引擎登录、渠道凭证及维护多个集成,且没有量化成本或适用性评估,因此只给中低分。

证据核验5 / 8 · 3.1/5

README 的若干产品声明可在安装/安全文档、CLI/引擎代码与技能说明中找到对应依据;CI 配置和测试样本展示了部分工程验证意图,但本评估不推断测试已执行或结果正确。文档通常将当前支持能力、限制和配置建议分开陈述,不过发布与安全声明仍主要是项目自述,交叉来源和独立证据有限。

风险与缓解建议
  • Codex 默认 approvalPolicy=never;自动运行前应确认工作区边界、渠道可见范围和主机隔离符合预期。
  • 安装材料提到校验和校验;所给样本未展示发布签名验证实现或依赖审计证据。
  • 远程 Core/Bridge、IM Bot 和调度会扩大数据及执行影响范围;请按文档保持 loopback 或使用自有鉴权网络边界,并谨慎共享 Memory。
证据充分度:低 评估于 2026年11月8日 审查版本 f884e605c5fc
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/metabot.svg?lang=zh)](https://followagents.com/zh/agents/metabot)
<a href="https://followagents.com/zh/agents/metabot"><img src="https://followagents.com/badge/metabot.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.3.4
    发布说明摘录
    What's Changed * 新增 Codex 和 Claude Code 执行中插话:支持 /append 与 /steer by @wengxiaoxiong in https://github.com/xvirobotics/metabot/pull/427 * 新增 Codex 和 Claude Code 手动压缩:保留会话并排队处理消息 by @wengxiaoxiong in https://github.com/xvirobotics/metabot/pull/428 * feat: sync public-safe session Bus, Console, automation and runtime updates by @floodsung in https://github.com/xvirobotics/metabot/pull/431 * release: prepare v1.3.4 patch release by @floodsung in https://github.com/xvirobotics/metabot/pull/432 Full Changelog: https://github.com/xvirobotics/metabot/compare/v1.3.3...v1.3.4
    在 GitHub 查看 ↗
  2. v1.3.3
    发布说明摘录
    What's Changed * feat: add /new reset and /? help aliases by @wengxiaoxiong in https://github.com/xvirobotics/metabot/pull/421 * 修复飞书单独 @机器人无响应:先读取聊天历史再回复 by @wengxiaoxiong in https://github.com/xvirobotics/metabot/pull/426 * fix(agent-teams): keep in-flight turns from failing when the store closes during shutdown by @Ivancheng7 in https://github.com/xvirobotics/metabot/pull/412 * feat(observability): make prompt/response persistence in activity and audit logs opt-out by @Ivancheng7 in https://github.com/xvirobotics/metabot/pull/413 …
    在 GitHub 查看 ↗
  3. v1.3.2
    发布说明摘录
    What's Changed * test: redirect USERPROFILE alongside HOME for Windows by @Ivancheng7 in https://github.com/xvirobotics/metabot/pull/401 * fix: recover undeliverable AskUserQuestion answers by @Ivancheng7 in https://github.com/xvirobotics/metabot/pull/396 * fix: prefer native claude executables on Windows by @Ivancheng7 in https://github.com/xvirobotics/metabot/pull/397 * fix: fall back to metabot-core bootstrap token by @Ivancheng7 in https://github.com/xvirobotics/metabot/pull/398 …
    在 GitHub 查看 ↗

常见问题

是否必须使用 Codex?
不必须。Bot 可选择 Codex、Kimi Code 或 Claude Code 兼容路径;省略 engine 时默认是 codex。
是否需要公网 IP?
文档说明不需要:飞书/Lark 使用 WebSocket 长连接,Telegram 和微信使用长轮询。
本地控制台如何访问?
默认访问 http://localhost:9200,粘贴 ~/.metabot-core/token 中由安装器生成的 Bearer Token。
它会获得哪些权限?
配置的 Agent 可在其工作区读、写和执行代码;应仅授权可信工作区与聊天成员。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。