CraftBot
CraftBot:您的 24/7 全天候个人 AI 自动化助手
CraftBot 是一款运行在本地机器上的个人 AI 助手。它能够自主理解任务、规划并执行操作。支持多种 LLM 模型,集成 Google Workspace、Slack、Notion 等外部工具,并具备记忆系统与主动代理功能,通过 MCP 和技能扩展框架帮助用户高效达成生活目标。
2026-04-20
634285.6K
CraftBot 产品信息
CraftBot:您的全天候个人 AI 智能助手
CraftBot 是一款部署在您本地机器上的个人 AI 助手(Personal AI Assistant),致力于为您提供 24/7 全天候的自动化支持。它不仅是一个简单的聊天机器人,更是一个能够自主解释任务、规划行动并执行操作以实现目标的智能代理。CraftBot 会不断学习您的偏好和习惯,主动协助您规划并启动任务,助您达成生活目标。
什么是 CraftBot (What's CraftBot)
CraftBot 是由 CraftOS 开发的一款开源 AI 代理(AI Agent)。它直接运行在用户的计算机内部,通过整合先进的大语言模型(LLM)和外部工具,实现高度的自动化办公与个人事务管理。CraftBot 的核心理念是“主动性”,它能通过 Proactive Agent 机制理解用户意图,并在获得授权的情况下自动处理复杂流程。
主要功能 (Features)
CraftBot 具备一系列强大的功能,旨在将其打造为最全能的 AI 助理:
1. 自备密钥系统 (BYOK)
CraftBot 提供灵活的 LLM 供应商支持。用户可以根据需求轻松切换不同的模型,包括:
- OpenAI
- Google Gemini
- Anthropic Claude
- BytePlus (字节跳动)
- Ollama (本地运行)
2. 记忆系统与主动代理
- Memory System:每天午夜会自动提炼并巩固当天发生的事件,形成长期记忆。
- Proactive Agent:学习您的习惯与目标,主动提议并执行任务。
3. 外部工具与 MCP 集成
- 工具集成:原生支持 Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord 和 Telegram。
- Model Context Protocol (MCP):通过 MCP 协议扩展代理能力,无缝连接外部服务。
- 技能框架 (Skills):内置研究、代码审查、Git 操作等丰富技能。
4. 跨平台与多模式操作
- 支持 Windows 和 Linux 系统。
- 提供多种 UI 模式:Browser (默认网页模式)、TUI (终端界面)、CLI (命令行) 以及 GUI (实验性桌面自动化模式)。
使用场景 (Use Case)
- 自动化办公:通过连接 Slack 和 Notion,CraftBot 可以帮您整理会议纪要并分发任务。
- 深度研究与开发:利用其内置的 Git 技能和代码审查功能,CraftBot 能辅助开发者进行项目维护。
- 生活规划:基于记忆系统,CraftBot 能提醒您未完成的长期目标,并提供主动的执行计划。
- 社交媒体管理:集成 LinkedIn 和 Telegram,帮助用户在多个平台上保持活跃。
如何安装与使用 (How to Use)
环境要求
- Python 3.10+
- Git
- LLM API 密钥 (OpenAI, Gemini 或 Anthropic)
- Node.js 18+ (仅网页模式需要)
快速安装步骤
- 克隆仓库:
git clone https://github.com/zfoong/CraftBot.git - 进入目录:
cd CraftBot - 安装依赖:
python install.py - 启动代理:
python run.py
运行模式切换
- 网页模式(推荐):
python run.py - 终端界面模式:
python run.py --tui - 桌面自动化模式(实验性):
python run.py --gui
后台服务运行
如果您希望 CraftBot 在后台持续运行,可以使用以下命令安装为服务:
python service.py install
常见问题 (FAQ)
Q: 运行 python run.py 时提示找不到 npm?
A: 这是因为 Browser 模式需要 Node.js 环境。请前往 nodejs.org 安装 LTS 版本,或者使用 --tui 参数运行终端模式,该模式无需 Node.js。
Q: CraftBot 支持哪些 AI 模型? A: CraftBot 支持主流的云端模型(如 OpenAI, Gemini, Claude)以及通过 Ollama 部署的本地模型,确保了隐私与灵活性。
Q: GUI 模式有什么特别之处?
A: GUI 模式目前处于实验阶段,它允许 CraftBot 像人类一样“看见”并操作桌面屏幕。这需要额外的依赖(约 4GB 模型权重),可通过 python install.py --gui 进行安装。
Q: 外部工具连接需要提供密码吗? A: CraftBot 主要通过 OAuth 2.0 或 PKCE 协议进行授权(如 Google, Zoom),安全且无需暴露您的主账号密码。








