chibi-bot Skill 技能

技能简介

chibi-bot 是一款自托管的异步 Telegram 数字伴侣，能够同时协调多个 AI 提供商（OpenAI、Anthropic、Google、DeepSeek、MiniMax 等）、工具和子 Agent，通过 Telegram 界面完成代码修改、研究综合、媒体生成和运营任务。它不是一款普通 AI 工具，而是一个能主动帮你完成工作的数字伙伴。

核心能力

• 多模型协调：支持 10+ 家第一方模型提供商和 20+ 家推理聚合商，可按任务选择最优模型
• 异步自主执行：子 Agent 并行工作，长任务异步运行，无需守着监控
• MCP 工具集成：内置文件系统、终端、GitHub、浏览器、数据库等 MCP 工具
• 自托管部署：数据、密钥、规则完全由你掌控，不依赖任何第三方服务
• 多模态支持：图像生成（Google Imagen、OpenAI GPT Image、阿里 Wan 等）、音乐生成（Suno、ElevenLabs Music）、语音合成与转录
• Telegram 原生界面：手机/桌面/Web 随时可用，无需额外安装
• Docker 一键部署：docker-compose 方式快速启动，无需配置环境

安装配置

方式一：pip 安装

pip install chibi-bot
chibi config
chibi start

首次运行 chibi config 生成配置文件，填入你的 Telegram Bot Token 和 AI 提供商密钥。

方式二：Docker 部署（推荐）

创建 docker-compose.yml：

version: '3.8'
services:
  chibi:
    image: pysergio/chibi:latest
    restart: unless-stopped
    environment:
      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
      OPENAI_API_KEY: ${OPENAI_API_KEY}
    volumes:
      - chibi_data:/app/data
volumes:
  chibi_data: {}

然后：

docker-compose up -d

方式三：源码安装

git clone https://github.com/s-nagaev/chibi.git
cd chibi
pip install -e .
chibi config
chibi start

使用步骤

第 1 步：获取 Telegram Bot Token

在 Telegram 中搜索 @BotFather，发送 /newbot，按提示创建机器人，获取 Token。

第 2 步：配置 API 密钥

chibi config

在配置文件中填入 Telegram Bot Token 和至少一个 AI 提供商的 API Key（如 OpenAI API Key）。

支持的密钥类型：

• 第一方模型：OpenAI、Anthropic (Claude)、Google (Gemini)、DeepSeek、MiniMax、Mistral、阿里（Qwen/Wan）、xAI (Grok)、Moonshot (Kimi)、ZhipuAI (GLM)
• 推理聚合商：OpenRouter、Together AI、Fireworks AI、DeepInfra、Nebius 等
• 自托管：Ollama、vLLM、LM Studio 或任何 OpenAI 兼容端点

第 3 步：启动服务

chibi start

服务以后台守护进程运行。使用 chibi logs 查看日志，chibi restart 重启，chibi stop 停止。

第 4 步：通过 Telegram 开始对话

在 Telegram 中找到你的机器人，直接发送任务指令。chibi 会分析任务、协调多个模型和工具、异步执行并返回结果。

第 5 步：本地客户端集成（可选）

chibi stdio --tui      # 终端 TUI 界面
chibi stdio --vscode   # VS Code 集成
chibi stdio --pycharm  # PyCharm 集成
chibi stdio --neovim   # Neovim 集成

适用场景

• 日常任务助手：通过 Telegram 随时发送指令，让 AI 帮你完成代码编写、资料查找、内容创作等任务
• 多模型对比：同一个任务同时发给多个模型，比较输出质量，选择最优结果
• 后台自动化：需要长时间运行的任务（如批量数据处理、大文件分析），chibi 在后台异步执行，完成后通知
• 跨工具工作流：需要同时调用文件系统、GitHub、浏览器、API 的复杂任务，chibi 协调多个 MCP 工具完成
• 多模态创作：图像生成、音乐创作、语音合成，一套配置支持多种模态输出
• 隐私敏感场景：所有数据自托管，不经过任何第三方 AI 服务，数据完全私有

适用人群

• 技术开发者：需要通过 Telegram 随时调用 AI 能力完成编码任务
• AI 爱好者：希望在一个应用中同时使用多个 AI 模型，按需切换
• 隐私关注者：不希望聊天数据经过第三方服务，需要完全自托管
• 多任务处理者：需要并行运行多个 AI 任务，无需等待一个完成再发下一个
• 多模态创作者：需要图像、音乐、语音等多种 AI 生成能力

工作原理

chibi 本质上是一个运行在 Telegram 上的 AI 协调层：

1. 指令接收：用户在 Telegram 发送自然语言指令
2. 任务分解：主 Agent 将任务分解为子任务，确定需要的工具和模型
3. 并行执行：多个子 Agent 同时工作（文件操作、代码生成、网络搜索等）
4. 结果汇总：各子 Agent 返回结果，主 Agent 整合后通过 Telegram 回复用户
5. 状态保持：所有对话历史和上下文保存在本地存储，新消息携带完整历史

整个过程中，你的 AI API 密钥只发送给配置的提供商，不经过 chibi 服务器中转（chibi 部署在你自己的机器上）。

官方链接

• PyPI：https://pypi.org/project/chibi-bot/
• GitHub：https://github.com/s-nagaev/chibi
• 官方文档：https://chibi.bot
• 安装指南：https://chibi.bot/installation
• 配置参考：https://chibi.bot/configuration