轻量级、可扩展的 AI Agent 框架 | 专为中文用户和国内大模型优化

中文 | English

• 2026年2月25日 - v0.2.0 发布，修复大量已知问题，优化用户体验
• 2026年2月21日 - CountBot 正式开源，代码规范化重构
• 2026年2月19日 - CountBot 项目正式上线

• 实现多模式多智能体协作，支持复杂任务分工
• 全面接入 tmux，实现调用 Codex CLI、Claude Code 等外部工具
• 增加智能硬件接入频道，实现语音控制

CountBot 是一个轻量级、可扩展的 AI Agent 框架，专为中文用户和国内大模型优化。仅用约 21,000 行 Python 代码，就实现了生产级的智能助手基础设施，具备：

• 智能记忆系统 - 自动总结对话，永不遗忘重要信息
• 主动问候机制 - 像真人助手一样，在你空闲时主动关心
• 零配置安全 - 本地访问零摩擦，远程访问自动保护
• 多渠道统一 - 一套代码，同时服务 Web、飞书、钉钉、QQ、Telegram、微信
• 个性化设置 - 12 种性格 + 自定义称呼和地址
• 消息队列 - 优先级调度、消息去重、死信处理
• 国内优化 - 深度支持智谱、千问、Kimi、MiniMax、Deepseek等国产大模型

核心理念：让 AI Agent 成为有记忆、有情感、会主动、能协作的数字伙伴。

CountBot 结合内置工具和技能插件，可以轻松应对各种日常任务：

"帮我搜索一下今天的 AI 新闻"

• 使用百度搜索技能，获取最新资讯并智能总结

"帮我找找东莞的西餐厅，我准备 18 点出发"

• 调用高德地图技能，搜索餐厅并规划路线

"今天天气怎么样？"

• 查询天气技能，获取实时天气和未来预报

"帮我看看今天有什么新的邮件"

• 通过邮件技能连接 QQ/163 邮箱，自动检查新邮件

"帮我把桌面的图片文件打包压缩，然后发送到我的邮箱"

• 使用文件工具打包文件，通过邮件技能发送附件

"帮我生成一个小猫拜年的图片，发送给我"

• 调用图像生成技能创作 AI 绘画，通过渠道发送

"帮我把电脑的屏幕做个截图，然后发送给我"

• 使用截图工具捕获屏幕，通过飞书/钉钉渠道发送

"这张图片里有什么内容？"

• 图像分析技能识别图片内容并给出详细描述

"帮我设计一个个人简历网页，然后发布到互联网上"

• 使用网页设计技能生成 HTML，自动部署到 Cloudflare Pages

"帮我用浏览器打开必应，搜索人工智能，打开第三个网站，然后截图给我"

• 通过浏览器自动化技能完成复杂的网页操作流程

"每天早上 8 点帮我查看天气情况"

• 设置 Cron 定时任务，自动执行并推送结果

CountBot 支持在 Web、飞书、钉钉、QQ 等多个渠道同时运行，所有渠道共享同一个智能记忆系统，无论在哪里对话，AI 都能记住你的偏好和历史信息。

CountBot 的记忆系统具备：

• 自动对话总结 - LLM 自动判断何时总结，提取关键信息
• 上下文滚动压缩 - 对话超出窗口时自动压缩，信息不丢失
• 关键词搜索 - 基于关键词快速检索历史记忆
• 行式存储 - 简单可靠的文件存储，易于备份和迁移

# 记忆系统自动工作，无需手动调用
用户: "我叫张三，住在北京"
AI: "好的，我记住了"

# 几天后...
用户: "我住哪儿来着？"
AI: "你住在北京" # 自动从记忆中检索

CountBot 具备主动关心能力：

• 智能空闲检测 - 监测用户最后活跃时间
• 免打扰时段 - 支持北京时间的免打扰设置（如 22:00-08:00）
• 每日限额 - 防止过度打扰（默认每天最多 2 次）
• 自然随机 - 不是机械的定时问候，而是自然的关心

# 用户 4 小时未活跃，且在活跃时段
AI: "好久不见！最近忙什么呢？需要我帮忙吗？"

独创的渐进式安全设计：

• 本地访问（127.0.0.1） → 零摩擦，直接使用
• 远程访问（192.168.x.x） → 首次引导设置密码
• 密码要求 → 至少 8 位，大小写+数字
• Session 管理 → 24 小时有效期

# 本地使用 - 无需任何配置
http://localhost:8000  ✅ 直接访问

# 远程使用 - 自动保护
http://192.168.1.100:8000  🔐 首次设置密码

在设置页面的「用户管理」中，可以配置：

12 种性格系统

CountBot 提供 12 种不同的性格设定：暴躁老哥、吐槽达人、温柔姐姐、直球选手、毒舌大佬、话痨本痨、哲学家、软萌助手、段子手、元气满满、中二之魂、佛系大师。从贴吧暴躁老哥到佛系大师，从软萌可爱到中二之魂，满足不同场景下的交互需求。你还可以完全自定义性格描述，让 AI 助手更贴合你的使用习惯。

自定义称呼和地址

• AI 名称 - 给你的助手起个名字（默认：CountBot）
• 用户称呼 - AI 如何称呼你（如：老张、小明）
• 用户地址 - 你的位置信息（如：东莞市），用于天气、地图、行程规划等场景

不是轮询，不是简单定时器，而是智能调度系统：

• 精确唤醒 - 计算最近任务时间，精确到秒
• 并发控制 - 信号量控制最大并发数
• 超时保护 - 单任务最大执行时间（默认 300 秒）
• 独立 Session - 每个任务使用独立数据库会话
• SQLite 锁重试 - 自动处理并发写入冲突

# 不是每秒轮询，而是精确计算下次唤醒时间
next_wake = min([job.next_run for job in enabled_jobs])
await asyncio.sleep((next_wake - now).total_seconds())

# 克隆仓库
git clone https://github.com/countbot-ai/countbot.git
cd countbot

# 安装依赖
pip3 install -r requirements.txt 

建议使用国内镜像进行安装，避免网络问题无法访问 pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

# 启动（自动打开浏览器）
python start_app.py

访问 http://localhost:8000，在设置页面配置 LLM 提供商即可使用。

https://github.com/countbot-ai/CountBot/releases
支持 Windows/macOS/Linux

部分国内优秀 AI 模型：GLM-5、MiniMax-M2.5、Kimi K2.5、Qwen3.5-Plus、DeepSeek Chat 等

零成本上手：使用智谱 AI 的免费 GLM-4.7-Flash 模型

1. 访问 智谱 AI 开放平台
2. 注册并获取 API Key
3. 在 CountBot 设置页面选择「智谱 AI」，填入 API Key
4. 开始使用！

countbot/
├── backend/                   # 后端代码（~21K 行）
│   ├── modules/
│   │   ├── agent/             # Agent 核心
│   │   │   ├── loop.py        # ReAct 循环
│   │   │   ├── memory.py      # 智能记忆系统
│   │   │   ├── heartbeat.py   # 主动问候
│   │   │   ├── personalities.py # 12 种性格
│   │   │   └── context.py     # 上下文构建
│   │   ├── messaging/         # 消息队列
│   │   │   ├── enterprise_queue.py # 消息队列
│   │   │   └── rate_limiter.py     # 令牌桶限流
│   │   ├── cron/              # Cron 调度
│   │   │   └── scheduler.py   # 精确按需唤醒
│   │   ├── auth/              # 安全认证
│   │   │   └── middleware.py  # 零配置安全
│   │   ├── channels/          # 渠道管理
│   │   ├── providers/         # LLM 提供商
│   │   └── tools/             # 工具系统（13 个）
├── frontend/                  # 前端（Vue 3 + TypeScript）
├── skills/                    # 技能插件（10 种）
└── docs/                      # 文档

• FastAPI - 现代化 Web 框架，原生支持异步和 WebSocket
• SQLAlchemy 2.0 - 异步 ORM，支持复杂查询
• aiosqlite - SQLite 异步驱动，零配置数据库
• LiteLLM - 统一 LLM 接口，支持主流大模型
• Pydantic v2 - 数据验证和配置管理
• Loguru - 结构化日志，易于调试
• cryptography - Fernet 加密，保护 API 密钥

• Vue 3 - 渐进式框架，Composition API
• TypeScript - 类型安全，减少运行时错误
• Pinia - 轻量级状态管理
• Vue I18n - 国际化支持（中文/英文）
• Axios - HTTP 客户端，自动重试
• Lucide Icons - 现代化图标库

CountBot 使用 LiteLLM 作为统一接口层，兼容 OpenAI / Anthropic / Gemini 协议，支持所有主流大模型：

渠道支持 allow_from 白名单进行访问控制。

本地访问（127.0.0.1）
    ↓
  零摩擦
    ↓
  直接使用

远程访问（192.168.x.x）
    ↓
  首次访问
    ↓
  引导设置密码
    ↓
  后续需要登录

• 工作空间隔离（restrict_to_workspace） //默认关闭
• 路径穿越检测
• 空字节注入阻断
• 命令白名单/黑名单
• 审计日志记录

• Fernet 对称加密
• 加密存储在 SQLite
• 运行时自动解密

• 令牌桶算法
• 按用户维度限流
• 可配置速率和突发大小

我们欢迎所有形式的贡献！

# 后端开发（热重载）
uvicorn backend.app:app --reload --host 0.0.0.0 --port 8000

# 前端开发
cd frontend
npm install
npm run dev

• 新 LLM 提供商 → backend/modules/providers/
• 新消息渠道 → backend/modules/channels/
• 新工具 → backend/modules/tools/
• 新技能 → skills/<skill-name>/

详见 CONTRIBUTING.md。

MIT License

CountBot 的诞生离不开开源社区的启发和支持。

• OpenClaw - 感谢 OpenClaw 团队开创性的 AI Agent 框架设计。CountBot 的 Agent Loop、工具系统等核心架构深受其启发。

• NanoBot - 感谢 NanoBot 团队展示了简洁的代码组织和模块化思想。

• ZeroClaw - 感谢 ZeroClaw 团队在安全性和性能方面的探索。CountBot 的安全体系设计参考了其安全优先的架构理念。

• PicoClaw - 感谢 PicoClaw 团队展示了超轻量级 AI Agent 的可能性。CountBot 的工具系统等核心架构深受其启发。

感谢以下开源项目和技术社区：

• FastAPI - 现代化的 Python Web 框架
• Vue.js - 渐进式 JavaScript 框架
• LiteLLM - 统一的 LLM API 接口
• SQLAlchemy - Python SQL 工具包和 ORM
• Pydantic - 数据验证和设置管理

特别感谢所有为 CountBot 提供反馈、建议和贡献的开发者和用户。是你们让 AI 技术变得更加普惠和易用。

CountBot 秉承开源精神，致力于让 AI Agent 技术更加透明、可控和易于使用。我们相信，通过开源协作，可以让更多人受益于 AI 技术的进步。