CraftBot

CraftBot 是什么？

CraftBot 是个人 AI 助手，可在本机运行，旨在理解任务、规划行动并执行，以帮助实现目标。它旨在持续运行，从而能根据您的偏好和目标主动帮助规划并启动任务。

该项目支持多种语言模型提供商，并包含集成、记忆系统以及可扩展框架，通过 MCP（Model Context Protocol）和自定义技能扩展代理功能。

自带密钥（BYOK）LLM 提供商系统：在 OpenAI、Google Gemini、Anthropic Claude、BytePlus 和本地 Ollama 等支持的 LLM 提供商之间选择和切换。
每日整合的记忆系统：在午夜提炼并整合当日事件，以支持持续个性化。
主动代理行为（需批准）：学习偏好、习惯和生活目标；可规划并启动任务，批准作为工作流程的一部分。
支持 OAuth 的外部工具集成：连接 Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord 和 Telegram 等服务（后续将添加更多）。
MCP 集成扩展能力：使用 Model Context Protocol 通过外部工具和服务扩展代理功能。
技能框架：可扩展技能框架，内置规划任务、研究、代码审查和 git 操作等技能。

安装先决条件：使用 Python 3.10+ 并克隆仓库。您还需要所选 LLM 提供商的 API 密钥（提及 OpenAI、Gemini 或 Anthropic）。
安装依赖：在克隆的 CraftBot 目录中运行 python install.py。
启动代理：运行 python run.py。首次运行将引导您设置 API 密钥。
选择界面模式：
- 浏览器（默认）：python run.py（推荐；需要 Node.js 18+）。
- TUI：python run.py --tui（无 Node.js 依赖）。
- CLI：python run.py --cli。
- GUI（实验性）：python run.py --gui install.py --gui（GUI 模式明确描述为实验性；切换时可能出现问题）。
开始交互：使用自然语言与代理对话，使用 /help 查看可用命令。设置后可连接 Google、Slack 和 Notion 等集成。

个人任务规划与启动：让代理规划多步骤任务并启动符合您偏好和生活目标的工作，工作流程包括批准。
跨工作应用工具协助：使用集成连接（如 Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord、Telegram）处理跨多个服务任务。
通过 MCP 扩展能力：通过 MCP 添加或连接外部工具和服务，让代理互动超出内置功能。
开发者工作流程帮助：使用内置技能如研究、代码审查和 git 操作，直接从助手支持软件工作。
选择适合环境的界面：浏览器模式提供网页界面，TUI/CLI 用于轻量终端工作流，或尝试实验性 GUI 模式获取视觉反馈。

CraftBot 支持哪些模型？ CraftBot 支持 BYOK LLM 系统，包含多种提供商，包括 OpenAI、Google Gemini、Anthropic Claude、BytePlus 和本地 Ollama。
需要 Node.js 吗？ Node.js 18+ 为可选，仅浏览器界面需要；若未安装，安装程序提供说明，或使用 TUI 模式。
GUI 模式稳定吗？ 不——GUI 模式为实验性，代理切换到 GUI 模式时可能遇到问题。项目注明正在积极改进。
可以扩展 CraftBot 功能吗？ 可以。仓库列出支持 MCP 集成和 skills 框架，二者均用于扩展代理功能。
哪些集成开箱即用？ 页面列出 Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord 和 Telegram 的集成，支持嵌入凭据和 OAuth。