MetaBot 是一个可自托管的开源个人 Agent 工作台：它运行在你自己的电脑上，让你通过飞书、Telegram、Slack、微信或浏览器，随时随地操控Codex CLI和Kimi Code两款代码智能体（Claude Code 作为兼容引擎继续保留）。出门在外打开手机，就能让 Agent 改代码、跑测试、跟进长任务——这就是 MetaBot 想解决的核心问题。

一、为什么你需要 MetaBot

传统用法里，Codex 和 Kimi Code 都只活在终端里：人坐在电脑前，盯着进度条等结果。MetaBot 把这套体验搬进了你每天都在用的 IM 软件：

• 📱手机上写代码—— 在飞书里 @Bot 发一句"给项目 A 加个单元测试"，Agent 就开始干活，工具调用和流式输出实时回传成卡片
• 🔁长任务不掉线—— 用/goal设定完成条件，Agent 跨轮持续工作；用/stop随时叫停，用/reset开新会话
• 🧠知识不丢—— MetaMemory 跨会话沉淀知识，还能同步到飞书知识库
• 🤝Agent 组队—— 一句话生成专门的 Agent 团队，并行分工、持久保存任务状态

它的定位可以用官方架构图上的"三大支柱"概括（源码见 src/index.ts 与 docs/concepts/architecture.zh.md）：

二、双引擎架构：Codex 与 Kimi Code 怎么选

MetaBot 的引擎层设计在 src/engines/index.ts，每个 Bot 可在 bots.example.json 中独立选择引擎，缺省为 Codex。三者能力对比：

一句话建议：有 OpenAI 订阅就用 Codex 做主力，Kimi Code 作为一级可选引擎并行跑；两个引擎可以继续各自的工作区约定（Codex/Kimi 用AGENTS.md，Claude 兼容CLAUDE.md）。消息从 IM 进入后，由 src/bridge/message-bridge.ts 这个核心调度器完成命令解析、队列排队、会话与媒体管理，再路由到对应引擎执行。

💡 同一台机器可以跑多个 Bot：bots.json里配置codex-dev和kimi-reviewer各管一个项目，互不干扰又能通过 Agent Bus 协作。详见 docs/configuration/multi-bot.zh.md。

三、五个渠道：飞书是主力，Telegram 最快

飞书侧配置非常轻量：在开放平台创建应用、添加"机器人"能力、开启长连接和im.message.receive_v1事件即可，详细步骤见 docs/getting-started/feishu-app-setup.zh.md。群聊里只有被准确 @的 Bot 才会收到消息，群主还可用/group-reply按群、按 Bot 切换"仅 @"或"回复全部"模式。

四、快速开始：四步跑通 MetaBot

前置条件：Node.js ≥ 22.19、Git，以及至少一个引擎和一个聊天渠道的凭证。

第 1 步：安装。MetaBot 提供带签名校验的一键安装脚本，约 5 分钟部署完整个人版（本地 Core、Token 登录的 Web UI、IM Bridge、CLI、Skills 和 PM2 服务）：

curl -fsSL https://github.com/xvirobotics/metabot/releases/latest/download/install.sh | bash

第 2 步：登录引擎。在独立终端安装并登录你要用的引擎：

npm install -g @openai/codex codex login npm install -g @moonshot-ai/kimi-code@latest # Kimi Code 0.27+ kimi login

第 3 步：连接渠道。按引导填写飞书 AppId/Secret 或 Telegram Token（最快路径见 docs/getting-started/quick-setup.zh.md）。

第 4 步：验证并打开控制台：

metabot status metabot health

打开http://localhost:9200，粘贴~/.metabot-core/token里的 Token，选择 Bot 即可开始。

五、Core Console：统一的本地控制台

个人版只有一个 Web 前端——Core Console（源码在 packages/web-ui/）。Chat 页面把实时执行和持久数据放在同一处：流式回复、工具执行、输出文件、交互问答、一键停止，都在这一个页面完成。Agents、Memory、Skills、T5T、Teams 和 CLI Access 共用同一套 Token 与导航，不再维护第二套 Bridge Web UI。功能细节见 docs/features/web-ui.zh.md。

六、进阶能力：让 Agent 自己组织自己

• Agent Teams🤝 —— 创建专门队友、并行分工，任务和运行状态持久保存。指南见 docs/features/agent-teams.zh.md
• MetaMemory🧠 —— 跨会话检索知识，可同步到飞书知识库。指南见 docs/features/metamemory.zh.md
• T5T 与 Goal🎯 —— 持久项目检查点 + 受监督的多轮执行，Core Console 内置 T5T 看板，常用命令见 docs/usage/chat-commands.zh.md
• Skill Hub🧩 —— 通过统一的metabotCLI 安装和发布可复用 Skills，内置 Skills 位于 src/skills/

七、安全须知

MetaBot Agent 在你配置的工作区中拥有读、写和执行代码的权限，请牢记三点：

1. 妥善保管 Core 与 Bridge 的 Token（安装器以0600权限保存在~/.metabot-core/token，不会写入日志）
2. 限制 IM Bot 的可见范围，群聊默认"仅 @"模式
3. 仅通过自有鉴权反代或私有网络暴露本地端口，不要把 9200/9100 直接暴露公网

更多说明见 docs/concepts/security.zh.md 与 docs/deployment/production.zh.md。

八、常用聊天命令速查

完整命令参考 docs/usage/chat-commands.zh.md，CLI 参考 docs/reference/cli-metabot.zh.md。

MetaBot 用一套引擎无关的消息流水线，把 Codex 和 Kimi Code 从"终端里的手艺活"变成了"手机上的日常工作"。如果你希望 Agent 组织真正受监督、可沉淀、能协作，不妨用上面的四步流程，把这套个人 Agent 工作台跑起来试试。