Cybara 完全指南：用 Bun 构建的自托管 AI Agent 平台，集 CLI、桌面端、26 个渠道于一身

概述

Cybara 是一个基于 Bun/TypeScript 的自托管 AI Agent 平台，不是又一个 Chatbot 界面——它是一套完整的 Agent 操作系统。一条命令安装，就能在本地运行一个支持多 Agent 编排、浏览器自动化、26 个消息渠道、MCP 协议、加密钱包操作和桌面/移动端配套的 Agent Runtime。

GitHub 地址：https://github.com/metaspartan/cybara（MIT 开源，TypeScript/Bun）

安装：一条命令搞定

Cybara 的安装极其简单，一条命令即可在 macOS 或 Linux 上启动：

curl -fsSL https://cybara.ai/install.sh | bash

Windows 用户用 PowerShell：

powershell -c "irm https://cybara.ai/install.ps1 | iex"

如果不做系统级安装，也可以用 bunx cybara 直接运行。Docker 部署同样支持：

docker run --rm -p 4269:4269 \
  -e CYBARA_API_KEY=*** \
  -v ~/.cybara:/root/.cybara \
  cybara:latest

启动后访问 http://localhost:4269 即可打开 Web UI。

多 Agent 运行时

Cybara 的核心是它的多 Agent 运行时，内置七种 Agent 角色：

• main — 主对话 Agent
• research — 深度研究型
• coder — 编码专用
• planner — 计划编排
• ops — 运维操作
• subagent — 子任务执行
• worker — 后台工作员

每种角色可以配置不同的 Provider、工具白名单和权限策略，同一次会话中可以根据任务动态切换或并行调度。

强大的 MCP 双模式

Cybara 同时支持 MCP 客户端和服务端两种模式：

作为 MCP 客户端：在 Settings → MCP Servers 中注册外部 MCP 服务器，Agent 自动发现所有工具。支持从 MCP 官方注册中心、MCP.so、Smithery 等多个源搜索和安装服务端，也支持 Bun 兼容的 npm 包安装。

作为 MCP 服务端：运行 cybara mcp serve 将自己的内置工具暴露给 Claude Code、Cursor 等外部客户端，实现双向工具共享。

CLI 中相关命令：

cybara mcp list              # 列出已注册的 MCP 服务
cybara mcp search     # 搜索可安装的服务
cybara mcp install   # 安装 MCP 服务
cybara mcp popular           # 查看热门服务
cybara mcp serve             # 启动 MCP 服务端

26 个消息渠道适配器

Cybara 是目前支持消息渠道最多的 Agent 平台之一，覆盖 Telegram、Discord、Slack、WhatsApp、Signal、iMessage、Matrix、Mattermost、Teams、飞书/Lark、钉钉、微信企业版（WeCom）、Zulip、LINE、Google Chat、IRC、ntfy、Twitch、Nextcloud、Synology、Zalo、Home Assistant、Web Chat、Webhook、SMS 和 Email。

每个渠道的 DM 策略支持三种模式：pairing（配对授权）、allowlist（白名单）、open（开放），细粒度控制谁能与 Agent 对话。

智能 Provider 路由

Cybara 内置了丰富的 Provider 支持——OpenAI、Anthropic、Google Gemini、xAI Grok、MiniMax、Kimi、Qwen、DeepSeek、OpenRouter，以及 Ollama 和 vLLM 等本地运行时。

路由策略有五种：

• 加权轮询（weighted）
• 轮转（round-robin）
• 最低成本（lowest-cost）
• 优先级（priority）
• Mixture of Agents（MoA）— 将同一个问题发给多个 Proposer Agent，综合合成最佳答案

多 API Key 凭据池自动轮转，Anthropic 的 prompt caching 在所有 Claude 请求上默认开启，可节省约 75% 的输入 Token。

内置工具库

Cybara 内置了丰富的工具分类，覆盖 Agent 日常操作的全链路：

• 文件类：读/写/编辑/搜索/grep/workspace_index/apply_patch，并在每次写入前对凭证、SSH Key 和 .env 做硬路径安全检查
• 进程类：exec/process/git
• 浏览器类：browser/web_fetch/web_search/canvas
• 记忆类：search/get/save/context/durable save
• 核心类：sessions/agents/artifacts/wallet/http/env/data/nodes/clipboard/cron/gateway
• LSP 类：diagnostics/definition/references/hover/languages
• 媒体类：image/tts/image_generate/video_generate/music_generate
• 技能类：calc/convert/pdf/ocr/summarization/video_frames/weather（含 skill_save——Agent 可以在一次成功的操作流程后将其固化成一个可复用的技能）
• 编排类：todo（会话级任务列表）、clarify（结构化多选提问）、kanban（持久化多 Agent 任务图）、mixture_of_agents（多 Agent 综合）
• 桌面控制：computer_use 实现后台桌面控制（capture/click/type/scroll/drag），不抢占鼠标
• 发现类：tool_search/tool_describe/tool_call，实现动态工具发现

执行沙箱

对于 exec 和 git 等潜在高风险操作，Cybara 提供了可配置的执行沙箱。自动选择底层方案：

• Apple Silicon 上使用 sandbox-exec
• Linux 上使用 podman
• 跨平台容器回退到 docker

网络模式支持 allow 和 deny 两种配置，可以在 Web UI 的 Settings → Command Sandbox 中管理。

ACP 协议支持

Cybara 实现了 ACP（Agent Client Protocol）v1 服务端，通过 cybara acp 命令启动 stdio 通道。这意味着 Claude Code、Codex 等兼容 ACP 的编辑器可以直接连接到一个 workspace 隔离的 Cybara Agent，使用它的全部工具和模型路由能力。

桌面端与移动端

Cybara 提供了三层界面：

1. Web UI（Bun 服务端内置）— 覆盖聊天、IDE、终端、MCP 管理、钱包、设置等全部功能
2. Tauri 桌面端（macOS/Windows/Linux）— 原生桌面体验，含自动更新
3. React Native 移动端（iOS/Android）— 通过二维码配对连接网关，管理远程会话和设置

移动端使用一次性配对码（10 分钟有效期），配对的设备可以被单独撤销而不影响主 API Key。

Docker 及生产部署

Cybara 的生产容器支持数据卷持久化。部署在服务器上后，Tailscale/ZeroTier 等私有 mesh 网络可以让手机通过内网安全访问，而不需要暴露公网端口。

docker build -t cybara:latest .

docker run --rm -p 4269:4269 \
  -e CYBARA_API_KEY=$(openssl rand -hex 32) \
  -v /data/cybara:/root/.cybara \
  cybara:latest

总结

Cybara 解决了「Agent 工具碎片化」的问题——一个平台统一了多 Agent 运行时、消息渠道、MCP 生态和 Provider 路由，还能通过桌面端和移动端远程操控。如果你在寻找一个可以自托管的、功能完整的 Agent 基础设施，Cybara 值得一试。

相关链接：

• GitHub：https://github.com/metaspartan/cybara
• 官网：https://cybara.ai
• 安装文档：https://cybara.ai/download