CraftBot
一个自托管的通用 AI 代理，能自己构建并运行 SaaS 工具，记住你的偏好，并主动帮你规划与执行日常任务。
证据仅含 README/LICENse/requirements/CI 配置，无任何 Agent 行为源码。依赖面极广（pyautogui、mss 截屏、telethon、googlesearch-python、boto3 等）却无权限说明，最小权限无从证明，仅给 1；用户确认仅在"主动 Agent（当然要经过你的同意）"一句口头声明，1 分；安装器静默注册自启动、后台运行并创建桌面快捷方式，透明度弱，数据流与密钥处理完全无文档（敏感数据 0）；无锁定文件、无依赖审计说明，依赖安全 1；卸载命令存在但无数据回滚说明，rollback 1；外部效果（浏览器、UI 操控、消息平台）无确认机制文档，1；署名仅 MIT 版权行与 README 致谢，1。
conftest 显示测试体系真实存在且对配置敏感项做了 pin，但主 CI 文件被改名为 ci.yml.disabled（禁用），自洽性打折给 1；依赖可用性有详细排查（Python 版本、pip 缓存、Playwright 可选降级）给 2；故障信息有 INSTALLATION_FIX.md 与具体报错路径给 2。
多 OS 徽章、Docker、CLI/浏览器双模式、多 LLM 提供商，环境适配充分给 2；受众场景（40+ 档案、120 Playbook）描述丰富但能力边界仅一句"仍在积极开发中"，1；会话路由/触发机制无源码可验证精度，1。
README 结构清晰、多语言、快速开始/排查/Docker 齐全，信息架构 2；安装说明具体可执行，2；示例（三个 Living UI demo）与 FAQ/排查充分，2；license 为完整 MIT 文本，3；但无 CHANGELOG/版本号体系（0），命名口径不一致（craftbot.py 与 run.py 在 README 中混用，1），局限仅"每周改进"一句（1），维护责任仅有 Discord/邮箱与"CraftOS 维护"声明、无响应承诺（1）。
所有效果声明（做梦、感知 DOM、替你完成 PM 工作）均无源码或基准支持，输出可用性仅凭描述给 1；相对通用框架的边际价值（Living UI、自建工具）是差异化主张但未验证，1；安装即后台自启动 + 庞大依赖树的成本未披露，成本收益 1。
README 数字声明（40+ 档案、120 Playbook、150+ MCP、170+ Skills）指向外部仓库，本仓内不可追溯，1；无第三方测试/审计证据，跨源印证 0；营销语言与可执行事实（安装命令、环境要求）在文中混杂但大致可区分，1。
- 安装命令会在后台静默注册自启动并创建桌面快捷方式，企业环境部署前应审计安装器行为。
- 依赖清单包含截屏（mss）、桌面自动化（pyautogui）、消息平台（telethon）等高权限库，权限面与文档不匹配，建议在隔离环境先行评估。
- 主 CI 工作流被禁用（ci.yml.disabled），所称 lint + 冒烟测试在当前版本不受强制执行。
- 所有能力数字（40+ 档案、120 Playbook、150+ MCP）均指向外部仓库且无源码佐证，请勿按字面采信。
- 无版本号与 CHANGELOG，生产锁定需自行记录修订。
这个 Agent 能做什么，适合哪些场景？
CraftBot 是 CraftOS 开源的通用 AI 代理框架，定位是"一个代理胜任所有工作"。它不只是聊天和调用工具：代理可以构建、演进并运行自己的 SaaS 型应用（Living UI），并直接读写这些应用的数据。它提供 40+ 个代理角色（如 CEO、财务、营销、DevOps、视频制作人）和 120 个跨 19 个类别的 Playbook。核心组件包括混合记忆系统（RAG + 知识图谱 + Agent File System，并在午夜进行"梦境"整理）、多任务会话路由、主动式任务规划和外部工具集成（Google Workspace、Slack、Notion、Zoom、Discord、Telegram 等）。它支持浏览器 UI 和 CLI 两种交互方式，采用 BYOK 模式接入 OpenAI、Gemini、Claude、OpenRouter 或本地 Ollama，可通过一条命令安装为后台服务，也可用 Docker 容器化部署。项目采用 MIT 许可证，处于活跃开发状态。
用户通过 python craftbot.py install 安装后，CraftBot 在后台运行并自动打开浏览器界面。代理从 Playbook 目录（120 个预置自动化方案）或 Agent Bundles（40+ 角色配置，一键导入）接受任务，按远程员工的执行方式完成工作。它可以：用自然语言从零构建 Living UI 应用（自动生成数据模型、后端 API 和 React UI）；从 living-ui-marketplace 安装社区应用；或将现有 Go、Node.js、Python、Rust 或静态代码仓库导入并包装为 Living UI（自动检测运行时并配置健康检查）。代理通过读取 DOM 和表单值、调用 REST API、触发操作来驱动这些应用。它会话内记住你的偏好与目标，午夜对当日事件做记忆整合，并可经你批准后主动发起规划任务。外部集成通过 OAuth 或用户自备密钥连接 Google Workspace、Slack、Notion、Zoom、LinkedIn 等服务；内置 150+ MCP 与 170+ Skills，可快速安装并从已完成的任务一键生成新 Skill。Playwright chromium 用于浏览器自动化（如 WhatsApp Web 集成），Docker 镜像内置 Tesseract OCR 以处理文件和网络 API。
- 个人用户想要一个记住自己偏好和目标、能主动提醒并规划日程的自托管私人助理。
- 小团队负责人需要看板、CRM 或公司仪表盘，但不想为订阅工具付费，可以让代理按需生成并持续演进定制应用。
- 开发者想用 CLI 或 Docker 在无头环境中脚本化运行一个通用代理，并自由切换 OpenAI、Claude 或本地 Ollama 模型。
- 独立运营者希望代理一键导入自己现有的代码仓库，包装成可操作的 Living UI 并由代理代为维护。
- 内容创作者或运营人员想用预置 Playbook（120 个、跨 19 类别）快速自动化 Slack、Notion、LinkedIn 等渠道的日常事务。
这个 Agent 有哪些优点和局限？
- Living UI 独树一帜：代理可构建、导入并持续演进可操作的 SaaS 应用，并直接读写其 DOM、表单与 REST 数据，而非仅停留在聊天层面。
- BYOK 多提供商支持：OpenAI、Gemini、Claude、OpenRouter 均可，Ollama 允许本地零成本运行，避免单一厂商锁定。
- 记忆系统采用 RAG + 知识图谱 + Agent File System 的混合方案，并有夜间记忆整理机制，是多数代理框架缺少的能力。
- 开箱即用资产丰富：120 个 Playbook、40+ 代理角色、150+ MCP 和 170+ Skills，一条命令即可安装为后台服务，并提供 Docker 镜像。
- 安装要求 Python 3.10+，浏览器模式额外依赖 Node.js 18+；缺 npm 时需退回 CLI 模式，属于双重运行时负担。
- Playwright chromium 安装可选且可能失败（仅 WhatsApp Web 需要），OCR 依赖 Tesseract，均为额外的系统级依赖。
- 项目处于活跃的每周迭代开发状态，稳定性与 API 兼容性可能变化，采用者需承担跟随上游变更的维护成本。
- 主动式代理会学习偏好并发起任务（虽需批准），对隐私和权限敏感的用户需仔细审查其记忆与外部集成的 OAuth 授权范围。
如何安装或部署这个 Agent？
要求 Python 3.10+，浏览器模式还需 Node.js 18+。
bash
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot
python craftbot.py install安装完成后终端自动关闭，CraftBot 在后台运行并打开浏览器，同时创建桌面快捷方式。也可用 Docker：docker build -t craftbot . 然后 docker run --rm -it --env-file .env craftbot（参考 .env.example 配置环境变量）。容器基于 Python 3.10，含 Tesseract OCR 和 requirements.txt 中的全部依赖，默认以 python -m app.main 启动。
如何使用这个 Agent？
日常通过浏览器界面交互：从顶栏打开 Playbook 选择器挑选方案即可开始执行任务，或从 CraftBot Agent Bundles 仓库一键导入 40+ 代理角色。也可以纯 CLI 使用（无需 Node.js）：python run.py --cli。
服务管理命令：
bash
python craftbot.py start # 后台启动
python craftbot.py stop # 停止
python craftbot.py restart # 重启
python craftbot.py status # 查看运行状态与自启动
python craftbot.py logs # 查看日志
python craftbot.py uninstall # 停止并卸载
使用前需配置 LLM 提供商的 API Key（BYOK）：支持 OpenAI、Google Gemini、Anthropic Claude、OpenRouter，或用 Ollama 本地模型零 token 运行。外部集成（Google Workspace、Slack、Notion、Zoom 等）通过 OAuth 或自备 Key 连接，每个集成可连接多个账户。若 npm 未安装导致浏览器模式失败，可改用 CLI 模式；Playwright chromium 安装失败可跳过，仅 WhatsApp Web 集成需要它。
这个 Agent 与同类方案有什么区别？
README 将 CraftBot 与"止步于聊天和工具调用"的多数代理框架（agent harnesses）作对比，认为其独特点是能自建并运行 SaaS 工具层、支持多任务会话路由和主动式代理行为；但源文档未点名具体竞品。
常见问题
使用 CraftBot 需要付钱吗？
必须开放哪些系统权限和网络访问？
如果 Playwright 或 Node.js 安装失败怎么办？
playwright install chromium 补装；没有 Node.js 时可改用 python run.py --cli 的 CLI 模式。