CraftBot with Living UI

CraftBot：您的 24/7 全天候个人 AI 助理全指南

在追求高效自动化的今天，CraftBot 脱颖而出，成为一款能够驻留在您的本地机器中并全天候工作的个人 AI 助理。它不仅仅是一个简单的聊天机器人，而是一个能够自主解释任务、规划行动并执行复杂流程的智能代理。通过不断学习您的偏好和目标，CraftBot 能够主动发起任务，助您实现生活与工作中的各项目标。

什么是 CraftBot？

CraftBot 是一个开源的 AI 助理平台，旨在为用户提供高度定制化的自动化体验。它直接在您的设备上运行，具备 24/7 持续工作的能力。CraftBot 的核心逻辑在于其能够“自主行动”：它不仅能回答问题，还能通过集成的技能（Skills）和模型上下文协议（MCP）来操作外部应用、管理文件系统以及与第三方服务进行深度交互。无论是复杂的科研任务、代码审查，还是日常的行程规划，CraftBot 都能在获得授权的情况下为您代劳。

CraftBot 的核心功能

CraftBot 具备多项领先的功能特性，使其在众多的 AI 助理工具中独树一帜：

• 自带密钥 (BYOK)：灵活的 LLM 提供商系统，支持 OpenAI、Google Gemini、Anthropic Claude、BytePlus 以及本地运行的 Ollama 模型。用户可以根据需求轻松切换不同的模型。
• 记忆系统 (Memory System)：CraftBot 拥有卓越的信息沉淀能力，能够在每日午夜对当天发生的事件进行提炼和整合，形成长期的语义记忆。
• 主动型代理 (Proactive Agent)：通过学习用户的偏好、习惯和生活目标，CraftBot 可以主动规划任务，并在获得用户批准后开始执行，从而帮助用户不断进步。
• Living UI：这是一个可进化的 UI 系统。用户可以构建、导入或让 CraftBot 自动生成自定义应用程序。CraftBot 能够感知 UI 状态，并直接读取、写入或操作其中的数据。
• 外部工具集成：支持连接 Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord 和 Telegram 等主流服务，内置 OAuth 支持和凭据管理。
• MCP 集成：通过模型上下文协议 (Model Context Protocol)，CraftBot 可以轻松扩展外部工具和服务的能力。
• 跨平台支持：完整支持 Windows、macOS 和 Linux，并提供 Docker 容器化部署方案。

CraftBot 的典型使用场景

由于其强大的扩展性和自主性，CraftBot 可以应用于多种场景：

1. 自动化研究与工作流

您可以要求 CraftBot 执行复杂的多步骤任务，例如针对特定课题进行深度的网络研究、撰写总结，或者对代码库进行自动化的代码审查和 Git 操作。

2. 个人生活管理

通过与 Google 日历和 Slack 的集成，CraftBot 可以协助管理您的日程，提醒重要会议，甚至在您忙碌时自动整理待办事项清单。

3. 自定义仪表盘 (Living UI)

如果您需要一个带有 AI 副驾驶的看板系统或 CRM，您可以直接告诉 CraftBot 您的需求。它会为您构建数据模型、后端 API 和 React UI，并随着您的需求变化不断演进这个“活的 UI”。

如何安装与使用 CraftBot

CraftBot 提供了多种安装方式，以适应不同技术背景的用户需求。

准备工作

• Python 3.10+
• Git (用于克隆仓库)
• 对应 LLM 提供商的 API Key
• Node.js 18+ (仅浏览器模式需要)

安装选项一：服务化安装 (推荐)

这种方式最简单，支持后台运行和开机自启：

1. 克隆仓库： git clone https://github.com/CraftOS-dev/CraftBot.git
2. 进入目录并安装： cd CraftBot python craftbot.py install

安装完成后，终端会自动关闭，CraftBot 将在后台运行并自动打开浏览器界面。桌面会创建快捷方式，方便随时访问。

安装选项二：Conda 环境安装

适合希望在隔离的 Conda 环境中管理依赖的用户：

python install.py --conda conda run -n craftbot python run.py

运行模式选择

CraftBot 支持多种交互界面，您可以通过命令行参数进行切换：

• 浏览器模式 (Browser): python run.py (推荐，功能最全)
• 终端 UI 模式 (TUI): python run.py --tui (无需 Node.js)
• 命令行模式 (CLI): python run.py --cli (轻量化运行)

重要提示：GUI 模式（桌面自动化）现已弃用，请使用上述三种模式替代。

常见问题解答 (FAQ)

Q: 运行 python run.py 时提示找不到 npm 或 Node.js？ A: 浏览器模式依赖 Node.js。请前往 nodejs.org 下载安装 LTS 版本并重启终端。或者，您可以使用无需 Node.js 的 TUI 模式：python run.py --tui。

Q: CraftBot 如何保障我的数据安全？ A: CraftBot 运行在您的本地机器上，您可以完全控制其运行环境。对于外部服务，它支持 PKCE 和 OAuth 协议进行安全连接。

Q: 我可以使用本地模型吗？ A: 是的。CraftBot 支持通过 Ollama 集成本地运行的开源模型，真正实现离线或私密环境下的 AI 辅助。

Q: 如果安装 Playwright 失败怎么办？ A: Playwright 主要用于 WhatsApp Web 等特定技能。如果失败，CraftBot 的其他核心功能仍可正常工作。您可以稍后尝试使用 playwright install chromium 手动安装。

Q: 如何连接我的 Google 账号？ A: 在 CraftBot 启动后，在对话框中输入 /google login 即可开始授权流程。