mirror of
https://github.com/countbot-ai/CountBot.git
synced 2026-09-14 20:46:47 +08:00
countbot-ai
264 lines
12 KiB
Markdown
264 lines
12 KiB
Markdown
<div align="center">
|
||
<h1>CountBot</h1>
|
||
<p>面向中文用户的开源 AI Agent 框架与运行中枢</p>
|
||
<p>连接大模型、IM 渠道、工作流与外部工具，帮助 AI 真正进入执行链路</p>
|
||
|
||
<p>
|
||
中文 | <a href="README_EN.md">English</a>
|
||
</p>
|
||
|
||
<p>
|
||
<a href="https://github.com/countbot-ai/countbot/stargazers"><img src="https://img.shields.io/github/stars/countbot-ai/countbot?style=social" alt="GitHub stars"></a>
|
||
<a href="https://github.com/countbot-ai/countbot"><img src="https://img.shields.io/badge/Python-3.8+-blue.svg" alt="Python"></a>
|
||
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"></a>
|
||
</p>
|
||
<img src="https://github.com/user-attachments/assets/5a848b1f-04bf-40ff-8249-8a453294f444" alt="CountBot Logo" width="680">
|
||
</div>
|
||
|
||
---
|
||
|
||
## CountBot 是什么
|
||
|
||
CountBot 是一个更加符合中文用户习惯的轻量级 AI Agent 框架，也是一个面向本地部署与长期运行的 AI Agent 中枢。
|
||
|
||
它把角色、团队、工作流、工具调用、记忆、大模型、IM 渠道和本地工作空间连接起来，让 AI 具备长期运行、跨入口协作与任务执行能力。
|
||
|
||
你可以把 CountBot 理解为一个框架和中枢：
|
||
|
||
- 向上连接 100+ LLM 提供商与不同模型策略
|
||
- 向外连接 Web、微信、飞书、钉钉、Telegram、企业微信、QQ、微博等入口
|
||
- 向内组织角色、团队、工作流、记忆与安全边界
|
||
- 向执行层连接文件、Shell、Web、屏幕、文件传输，以及 Claude Code、Codex、OpenCode 一类外部行业工具
|
||
|
||
一句话概括：**CountBot 是连接模型、渠道、团队和工具的 AI Agent 框架与运行中枢。**
|
||
|
||
CountBot 由自然语言而生。CountBot 的愿景，不是让更多人先学会复杂配置和编程再去使用 AI，而是让普通用户也能直接通过自然语言与 AI 交互，完成信息获取、内容生成、任务拆解、工具调用、流程编排，乃至搭建属于自己的个人助手、团队协作流与自动化系统。
|
||
|
||
---
|
||
|
||
## 最新动态
|
||
|
||
- **v0.9.0**
|
||
- 新增 MCP 客户端模块，支持多服务器连接、健康检查与工具发现，扩展 AI 执行能力边界。默认关闭，为个性化用户而新增的功能
|
||
- 新增 Wiki 知识库模块，基于 BM25 全文搜索，支持批量获取、相关性过滤与 LRU 缓存加速
|
||
- 新增 MCP、Wiki 管理面板，组件模块化拆分与国际化支持
|
||
- 新增 WebSocket 状态广播模块，实时同步 MCP 连接状态至前端会话
|
||
- 改进上下文管理与心跳机制，简化问候逻辑，减少 LLM 调用成本
|
||
- 完善工具注册与初始化流程，提升系统启动一致性与可维护性
|
||
- 新增 API Key 轮换机制与故障转移能力，支持多 key 自动切换
|
||
- 改进 send_media 工具网页版兼容性，支持在WEB UI 预览图片和下载附件
|
||
- 优化模型预设界面并更新构建产物
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.9.0](https://countbot.cn/docs/releases/v0.9.0)
|
||
|
||
- **v0.8.0**
|
||
- 集中修复 issue 与用户反馈中的多项问题，修复一批高频使用场景下的已知 Bug
|
||
- 全面优化前端界面与交互体验，提升整体易用性与操作流畅度
|
||
- 持续优化系统响应链路，提升 AI 回复的准确性、及时性与整体稳定性
|
||
- 重构会话上下文维护链路，新增短期摘要缓存、溢出历史总结与整会话自动记忆沉淀
|
||
- 增强多渠道稳定性，补强微信、企微、飞书消息处理、去重与流式投递控制
|
||
- 优化主动问候与定时执行逻辑，避免未成功投递时提前计次，并支持配置变更后刷新当日计划
|
||
- 完善推理开关与运行时配置解析，补充不同提供商的思考字段映射与 persona 合并策略
|
||
- 统一启动时的监听地址与端口环境变量，补充 `COUNTBOT_HOST` / `COUNTBOT_PORT` 文档说明
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.8.0](https://countbot.cn/docs/releases/v0.8.0)
|
||
|
||
- **v0.7.0**
|
||
- 集中解决多个 issue 反馈问题，修复一批已知 Bug，提升整体稳定性
|
||
- WEBUI 新增了文件上传和处理相关逻辑，优化了 Mermaid，提供更加友好的图表展示
|
||
- 优化前端界面与交互流程，技能、配置、工具等日常使用体验更顺手
|
||
- 优化 tool 调用链路与上下文组织，相比此前版本显著降低 token 消耗
|
||
- 新增模型思考控制开关，可按场景切换思考强度，在体感上获得更快的 AI 响应
|
||
- 新增 `find-skills`，全面接入腾讯云 SkillsHub，可通过对话完成 skills 的搜索、安装、启用、禁用与删除
|
||
- 新增 `ima-knowledge-base`、`ima-notes`，全面接入 IMA 知识库与笔记能力，支持知识库搜索、上传、网页导入，以及笔记搜索、读取、新建和追加
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.7.0](https://countbot.cn/docs/releases/v0.7.0)
|
||
|
||
- **v0.6.0**
|
||
- 新增微信ClawBot接入，支持多个账号绑定
|
||
- 新增外部编程工具接入（Claude/Codex/OpenCode）,可以作为工具提供LLM调用，亦可成为代理连接IM渠道
|
||
- 新增远程首次初始化安全入口 `/setup/<random>`
|
||
- 新增 `REMOTE_SETUP_SECRET_TTL_MINUTES`，远程初始化入口有效期可控
|
||
- 强化远程认证边界，覆盖 `/api/*` 与 `/ws/chat`
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.6.0](https://countbot.cn/docs/releases/v0.6.0)
|
||
|
||
- **v0.5.0**
|
||
- Agent Team 正式成型，支持多角色分工、上下文衔接与团队级编排
|
||
- 配置体系从会话级演进到角色级、团队级与多机器人协同
|
||
- 渠道系统进一步增强，支持更多企业与社交入口
|
||
- 前端聊天、配置、技能、团队与工具面板整体升级
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.5.0](https://countbot.cn/docs/releases/v0.5.0)
|
||
|
||
- **v0.4.0**
|
||
- 引入会话级配置，支持不同会话使用不同模型与提示词
|
||
- 扩展飞书、企业微信、微博、小智 AI 等渠道能力
|
||
- 优化多智能体协作，新增 `/help` 等使用入口
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.4.0](https://countbot.cn/docs/releases/v0.4.0)
|
||
|
||
- **v0.3.0**
|
||
- 多智能体协作（`pipeline` / `graph` / `council`）首次体系化落地
|
||
- 定时任务、技能配置、工作空间管理能力显著增强
|
||
- 发布说明：[https://countbot.cn/docs/releases/v0.3.0](https://countbot.cn/docs/releases/v0.3.0)
|
||
|
||
- **v0.2.0 · 2026-02-26**
|
||
- 聚焦 Bug 修复、交互体验优化与构建流程整理
|
||
- 让 CountBot 从“基础可运行”进一步走向“稳定可迭代”
|
||
|
||
- **正式开源 · 2026-02-21**
|
||
- CountBot 首次开源，开放基础框架、启动脚本、Agent 核心、渠道系统、工具系统、技能系统与前端基础能力
|
||
- 项目从这一天开始持续公开迭代
|
||
|
||
---
|
||
|
||
## 为什么做 CountBot
|
||
|
||
CountBot 从自然语言驱动软件的趋势出发，致力于让 AI 真正落地到真实任务与日常工作中。
|
||
|
||
软件开发与使用方式正在发生变化：
|
||
1. 人与软件的交互，正从复杂指令与代码，逐步走向自然语言。
|
||
2. 工具与系统正从标准化产品，向更多人可自主定义、个性化创造的方向演进。
|
||
|
||
当前 AI Agent 的核心挑战，已不再是单一模型能力，而是如何将大模型、工具调用、多渠道接入、权限边界与长期运行能力，整合为一套可落地、可维护的系统。
|
||
|
||
OpenClaw 已经在本地执行、自主 Agent 方向上验证了可行路径。在此基础上，CountBot 聚焦补齐**中文场景适配、轻量化部署、易用性扩展、安全管控与治理能力**等关键缺口。
|
||
|
||
CountBot 不只是对话式 AI 应用，而是一套面向真实任务、可部署、可扩展、可治理的开源基础设施，让普通用户也能通过自然语言驱动 AI、组织工具、连接渠道，真正落地业务与日常流程。
|
||
|
||
---
|
||
|
||
## 核心能力
|
||
|
||
| 模块 | 说明 |
|
||
|------|------|
|
||
| Agent Loop | ReAct 推理、工具调用、结果反馈与迭代控制 |
|
||
| Agent Teams | `pipeline`、`graph`、`council` 三种协作模式 |
|
||
| 多机器人渠道矩阵 | 一个工作区可服务多个渠道、多个机器人、多个业务入口 |
|
||
| 配置分层 | 全局默认、角色、团队、会话运行时配置分层协同 |
|
||
| 工具与技能 | 文件、Shell、Web、截图、记忆、工作流、媒体发送与技能扩展 |
|
||
| 外部执行工具接入 | 将 Claude Code、Codex、OpenCode 等外部行业工具接入统一运行时 |
|
||
| 记忆与会话 | 长期记忆、摘要、上下文注入、会话隔离 |
|
||
| Cron 与 Heartbeat | 定时任务、主动提醒、后台长期运行 |
|
||
| 安全与工作空间 | 本地可控、路径限制、审计日志、超时与远程认证边界 |
|
||
| 多模型接入 | 兼容国产与国际主流模型接入，支持团队级模型覆盖 |
|
||
|
||
---
|
||
|
||
## 适用场景
|
||
|
||
- 希望把自然语言需求拆成多个角色协同完成的复杂任务
|
||
- 希望在本地或私有环境中运行自己的 AI 助手、AI 团队或自动化流程
|
||
- 需要同时服务 Web、企业微信、飞书、钉钉、Telegram、Discord 等多个入口
|
||
- 希望将工具调用、文件操作、消息通知、定时任务整合进同一运行环境
|
||
- 希望把大模型、消息渠道、工具调用和团队协作整合到一个统一中枢
|
||
- 希望在 AI 助手之外，进一步构建可持续运行的 Agent 系统
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
### 方式一：源码启动
|
||
|
||
```bash
|
||
git clone https://github.com/countbot-ai/CountBot.git
|
||
cd CountBot
|
||
|
||
# 默认安装
|
||
pip install -r requirements.txt
|
||
|
||
# 国内网络可使用阿里云镜像
|
||
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
|
||
|
||
python start_app.py
|
||
```
|
||
|
||
启动完成后默认打开 `http://127.0.0.1:8000`。
|
||
|
||
可通过环境变量覆盖默认监听地址与端口，优先级为 `COUNTBOT_HOST` / `COUNTBOT_PORT` > 默认值。
|
||
|
||
```powershell
|
||
$env:COUNTBOT_HOST = '0.0.0.0'
|
||
$env:COUNTBOT_PORT = '8001'
|
||
python start_app.py
|
||
```
|
||
|
||
```cmd
|
||
set COUNTBOT_HOST=0.0.0.0
|
||
set COUNTBOT_PORT=8001
|
||
python start_app.py
|
||
```
|
||
|
||
如果国内网络访问 GitHub 受限，可切换到 Gitee：
|
||
|
||
```bash
|
||
git clone https://gitee.com/countbot-ai/CountBot.git
|
||
```
|
||
|
||
### 方式二：桌面版体验
|
||
|
||
- Gitee Releases: https://gitee.com/countbot-ai/CountBot/releases
|
||
- GitHub Releases: https://github.com/countbot-ai/CountBot/releases
|
||
- 适用平台：Windows / macOS / Linux
|
||
|
||
---
|
||
|
||
## 文档入口
|
||
|
||
| 文档 | 说明 | 链接 |
|
||
|------|------|------|
|
||
| 快速开始 | 安装、配置、启动 | [https://countbot.cn/docs/getting-started/quick-start-guide](https://countbot.cn/docs/getting-started/quick-start-guide) |
|
||
| 配置手册 | 完整配置说明 | [https://countbot.cn/docs/getting-started/configuration-manual](https://countbot.cn/docs/getting-started/configuration-manual) |
|
||
| 部署与运维 | 启动、部署、排障 | [https://countbot.cn/docs/advanced/deployment](https://countbot.cn/docs/advanced/deployment) |
|
||
| 远程访问指南 | 远程初始化、认证、排障 | [https://countbot.cn/docs/advanced/remote-access](https://countbot.cn/docs/advanced/remote-access) |
|
||
| 认证说明 | 密码初始化与访问边界 | [https://countbot.cn/docs/advanced/auth](https://countbot.cn/docs/advanced/auth) |
|
||
| API 参考 | REST API 与 WebSocket | [https://countbot.cn/docs/api-reference](https://countbot.cn/docs/api-reference) |
|
||
| 发布说明 | 版本演进记录 | [https://countbot.cn/docs/releases/v0.8.0](https://countbot.cn/docs/releases/v0.8.0) |
|
||
|
||
完整站点文档请查看：[https://countbot.cn/docs](https://countbot.cn/docs)
|
||
|
||
---
|
||
|
||
## 开发与贡献
|
||
|
||
### 本地开发
|
||
|
||
```bash
|
||
uvicorn backend.app:app --reload --host 0.0.0.0 --port 8000
|
||
```
|
||
|
||
### 社区交流
|
||
|
||
- QQ 交流群：`1028356423`
|
||
- 讨论方向：CountBot 使用、问题反馈、二次开发、场景共创
|
||
|
||
### 问题反馈
|
||
|
||
- GitHub Issues: https://github.com/countbot-ai/CountBot/issues
|
||
|
||
---
|
||
|
||
## 开源协议与致谢
|
||
|
||
### 开源协议
|
||
|
||
MIT License
|
||
|
||
### 项目灵感
|
||
|
||
- OpenClaw
|
||
- NanoBot
|
||
- ZeroClaw
|
||
- anthropics/skills
|
||
|
||
### 技术致谢
|
||
|
||
感谢 FastAPI、Vue.js、SQLAlchemy、Pydantic、LiteLLM 等开源项目。
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
<p>连接模型、渠道、团队与工具的 AI Agent 中枢</p>
|
||
<p>
|
||
<a href="https://count bo t">官方网站</a> ·
|
||
<a href="https://github.com/countbot-ai/countbot">GitHub</a> ·
|
||
<a href="https://gitee.com/countbot-ai/CountBot">Gitee</a> ·
|
||
<a href="https://countbot.cn/docs">完整文档</a>
|
||
</p>
|
||
</div>
|