CraftBot

CraftBot 是什麼？

CraftBot 是一款個人 AI 助理，在你自己的電腦上運行，設計用來理解任務、規劃行動並執行，以協助達成目標。它旨在持續運作，能主動根據你的偏好與目標，幫助規劃並啟動任務。

專案支援多種語言模型供應商，並包含整合、記憶系統，以及可擴充框架，透過 MCP（Model Context Protocol）和自訂技能來擴充代理的功能。

自帶金鑰（BYOK）LLM 供應商系統：選擇並切換支援的 LLM 供應商，包括 OpenAI、Google Gemini、Anthropic Claude、BytePlus，以及本機 Ollama。
每日整合記憶系統：午夜時提煉並整合當天事件，以支援持續個人化。
主動代理行為（需經批准）：學習偏好、習慣與人生目標；能規劃並啟動任務，批准作為工作流程一部分。
支援 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 金鑰。
選擇介面模式：
- Browser（預設）：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（明確描述為實驗性；切換時可能出現問題）。
開始互動：使用自然語言與代理對話，輸入 /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。