CountBot

面向中文用户的开源 AI Agent 框架与运行中枢

连接大模型、IM 渠道、工作流与外部工具，帮助 AI 真正进入执行链路

中文 | English

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 交互，完成信息获取、内容生成、任务拆解、工具调用、流程编排，乃至搭建属于自己的个人助手、团队协作流与自动化系统。

为什么做 CountBot

CountBot 从自然语言驱动软件的趋势出发，致力于让 AI 真正落地到真实任务与日常工作中。

软件开发与使用方式正在发生变化：

人与软件的交互，正从复杂指令与代码，逐步走向自然语言。
工具与系统正从标准化产品，向更多人可自主定义、个性化创造的方向演进。

当前 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 系统

快速开始

方式一：源码启动

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 > 默认值。

$env:COUNTBOT_HOST = '0.0.0.0'
$env:COUNTBOT_PORT = '8001'
python start_app.py

set COUNTBOT_HOST=0.0.0.0
set COUNTBOT_PORT=8001
python start_app.py

如果国内网络访问 GitHub 受限，可切换到 Gitee：

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

v0.8.0 重点变化

1. 聚焦问题修复与高频场景稳定性提升

这一版首先集中处理来自 issue 与日常使用反馈中的多项问题，针对高频使用场景下的已知 Bug 做了系统修复，让 CountBot 在复杂链路与长期运行场景中更稳定、更可预期。

2. 前端界面与交互体验全面优化

围绕常用操作路径继续优化前端界面与交互体验，重点改善配置、会话、技能与日常管理流程的操作流畅度，进一步降低理解成本，提升整体易用性。

3. 系统响应链路继续提速

对会话上下文、执行链路与响应流程做了新一轮整理，在不牺牲能力覆盖的前提下，进一步提升 AI 回复的准确性、及时性与整体稳定性。

4. 会话上下文维护链路重构

新增短期上下文摘要缓存、溢出历史总结与整会话自动记忆沉淀机制，使长会话场景下的上下文管理更清晰，也让长期运行时的记忆维护更可控。

5. 多渠道消息处理稳定性增强

重点补强微信、企业微信、飞书等渠道的消息处理、去重控制与流式投递链路，减少重复消息、过期消息与异常中断带来的干扰。

6. 主动问候、推理控制与运行时配置进一步完善

这一版同步优化了主动问候与定时执行逻辑，避免未成功投递时提前计次；同时补充不同提供商的思考字段映射与 persona 合并策略，并统一 COUNTBOT_HOST / COUNTBOT_PORT 运行时配置入口。

文档入口

文档	说明	链接
快速开始	安装、配置、启动	https://654321.ai/docs/getting-started/quick-start-guide
配置手册	完整配置说明	https://654321.ai/docs/getting-started/configuration-manual
部署与运维	启动、部署、排障	https://654321.ai/docs/advanced/deployment
远程访问指南	远程初始化、认证、排障	https://654321.ai/docs/advanced/remote-access
认证说明	密码初始化与访问边界	https://654321.ai/docs/advanced/auth
API 参考	REST API 与 WebSocket	https://654321.ai/docs/api-reference
发布说明	版本演进记录	https://654321.ai/docs/releases/v0.8.0

完整站点文档请查看：https://654321.ai/docs

开发与贡献

本地开发

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 等开源项目。

连接模型、渠道、团队与工具的 AI Agent 中枢

官方网站 · GitHub · Gitee · 完整文档

baidu-search