Metabot
构建受监督的、自我进化的 Agent 组织的基础设施 | Infrastructure for supervised, self-improving agent organization. 飞书/Telegram 手机端运行 Claude Code 或 Kimi Code（双引擎，两家原生订阅直接用），共享记忆、Agent 工厂、定时任务、通信总线。
Last verified:
What is Metabot?
MetaBot is infrastructure for building a supervised, self-improving agent organization. It frees AI coding agents like Claude Code and Kimi Code from being trapped in laptop terminals by giving every agent a Claude Code brain, persistent shared memory, the ability to create new agents, and a communication bus. All accessible from Feishu or Telegram on your phone.
Key features include the Claude Code Kernel (every bot is a full Claude Code instance with Read, Write, Edit, Bash, Glob, Grep, WebSearch, MCP capabilities), MetaSkill (agent factory that generates complete agent teams), MetaMemory (embedded SQLite knowledge store with full-text search), IM Bridge for chat integration, Web UI with WebSocket streaming and voice mode, Agent Bus (REST API on port 9100 for inter-agent communication), Task Scheduler with cron jobs, and CLI tools for management.
MetaBot is designed for developers and teams building AI agent organizations, companies wanting to run as agent-native organizations, and anyone who wants to use Claude Code, Kimi Code, or Codex CLI from mobile devices via chat interfaces. XVI Robotics uses MetaBot internally to run their company as an agent-native organization.
The system supports federation through Peers for cross-instance bot discovery and task routing, bypassPermissions mode for autonomous operation, and works with all three top AI coding agents (Claude Code from Anthropic, Kimi Code from Moonshot, Codex CLI from OpenAI).
Metabot pricing
Pricing model: Freemium
MetaBot is open-source and free to install. The installer uses curl or PowerShell to download from GitHub. Your existing AI coding agent subscriptions (Claude Code from Anthropic, Kimi Code from Moonshot, Codex CLI from OpenAI) work directly - MetaBot is not tied to any single provider. Token budgets are controlled via maxBudgetUsd setting and turn limits via maxTurns setting.
Metabot pros
- Gives Claude Code brain to every agent
- Persistent shared memory across sessions with MetaMemory
- Agents can create new agents at runtime
- Communication bus for inter-agent messaging
- Accessible from Feishu or Telegram on mobile
- Full Claude Code capabilities including Read, Write, Edit, Bash, Glob, Grep, WebSearch, MCP
- MetaSkill agent factory generates complete agent teams instantly
- Embedded SQLite knowledge store with full-text search
- Web UI with WebSocket streaming and dark/light themes
- Voice assistant via iOS Shortcuts (Jarvis mode) and Web UI phone call mode
- REST API on port 9100 for agent-to-agent communication
- Federation system for cross-instance bot discovery
- Task Scheduler with timezone-aware cron jobs that persist across restarts
- bypassPermissions mode for autonomous operation
- Supports three top AI coding agents - Claude Code, Kimi Code, Codex CLI
- CLI tools for easy management, memory, and agent bus control
- Auto-start with PM2 after installation
- Streaming cards with color-coded status in chat
Metabot cons
- Requires Claude auth setup during installation
- Requires IM credentials configuration for Feishu/Telegram
- Self-hosted - must run on your own infrastructure
- Installation walks through multiple setup steps
- Only works with specific AI coding agents (Claude Code, Kimi Code, Codex CLI)
- Requires PM2 for process management
- Agent auto-driven turns count toward token budget and turn limits
- One active goal per chat limitation
Frequently asked questions about Metabot
What is MetaBot?
MetaBot is infrastructure for building a supervised, self-improving agent organization. It gives AI agents like Claude Code a full Claude Code brain, persistent shared memory through MetaMemory, the ability to create new agents, and a communication bus. Everything is accessible from Feishu or Telegram on your phone.
How do I install MetaBot?
Run either curl -fsSL https://raw.githubusercontent.com/xvirobotics/metabot/main/install.sh | bash on Linux/Mac or irm https://raw.githubusercontent.com/xvirobotics/metabot/main/install.ps1 | iex on Windows. The installer walks you through setting the working directory, Claude auth, IM credentials, and auto-start with PM2.
What AI coding agents does MetaBot support?
MetaBot supports three top AI coding agents with native integration: Claude Code from Anthropic, Kimi Code from Moonshot, and Codex CLI from OpenAI. Your existing subscriptions to these services work directly with MetaBot.
What is MetaSkill?
MetaSkill is an agent factory. When you send /metaskill followed by a request like 'ios app', it generates a complete .claude/ agent team including an orchestrator, specialists, and code-reviewer. The system researches the project structure, generates configuration files, and saves them to the bot's working directory.
How does MetaMemory work?
MetaMemory is an embedded SQLite knowledge store with full-text search and a Web UI. Agents can read and write Markdown documents across sessions, allowing them to remember information and share knowledge with other agents in the organization.
Can I use MetaBot on my phone?
Yes. MetaBot includes an IM Bridge that lets you chat with any agent from Feishu/Lark or Telegram, including on mobile. You get streaming cards with color-coded status showing the agent's response in real-time.
What is the Agent Bus?
The Agent Bus is a REST API running on port 9100 that allows agents to talk to each other using the mb talk command. You can create and remove bots at runtime, enabling dynamic agent organization.
Does MetaBot support voice control?
Yes. MetaBot has a Voice Assistant with hands-free voice control via iOS Shortcuts in Jarvis mode or Web UI phone call mode with VAD (voice activity detection) that auto-detects when you finish speaking. It uses server-side STT and TTS.
How do agents communicate across different MetaBot instances?
MetaBot includes Peers, a federation system for cross-instance bot discovery and task routing. This allows agents from different MetaBot installations to find each other and route tasks appropriately.
How do I update MetaBot?
Use the metabot update command, which is the recommended way to update. It performs git pull to fetch the latest code, npm install && npm run build to rebuild, and pm2 restart to restart the service - all in one command. The metabot CLI also supports start, stop, restart, logs, and status commands.