大多數 Agent 框架止步於對話和工具呼叫,CraftBot 走得更遠。它會自己建立、演進並運行 SaaS 工具,然後透過這套工具層與你溝通,並替你完成自動化工作。

除此之外,CraftBot 擁有通用 Agent 框架的全部核心能力。它像一位遠端員工一樣執行任務、記住你的偏好與目標,並主動協助你規劃並推進對你來說重要的事情。

✨ 核心特色

除了能夠建立並運行自有的 SaaS 工具,CraftBot 還具備 Agent 框架的全部核心能力,可以作為通用 AI Agent 陪你處理任務、工具、記憶與日常工作流程。

Agent 設定檔 40+ Agent 設定檔(CEO Agent、財務 Agent、行銷負責人 Agent、DevOps 工程師、影片製作人 Agent 等共 37 種)隨時準備為你工作。從 CraftBot Agent Bundles 找到想要的角色,一鍵匯入。
Playbook 目錄 不知道如何用 AI Agent 自動化?CraftBot 內建 120 個 Playbook(涵蓋 19 個分類)隨時可用。從頂部列開啟 Playbook 選擇器,挑一個 Playbook,它就會開始替你執行任務。
Living UI. 在 CraftBot 內建立、匯入或演進自訂應用程式。Agent 隨時掌握 UI 的狀態,並能直接讀取、寫入並操作其中的資料。
多工與工作階段路由. 還在手動輸入 /new 指令嗎?CraftBot 能自己判斷何時該開啟新會話、何時要繼續舊任務,讓對話與上下文保持一致。
自架與 BYOK. 彈性的 LLM 供應商系統,支援 OpenAI、Google Gemini、Anthropic Claude、OpenRouter 等。也可以用 Ollama 自架模型,完全不耗 Token。
記憶系統. 透過 RAG + Agent 檔案系統 + 蒸餾,從你與 CraftBot 的互動中建立本地知識庫。CraftBot 會在午夜「做夢」,整合一整天發生的事件。
主動型 Agent. 學習你的偏好、習慣與人生目標,然後主動規劃並發起任務(當然會徵求你的同意),協助你在生活中變得更好。
外部工具整合. 連接你的應用,例如 Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord、Telegram 等(更多正在路上),支援 OAuth 或使用你自己的金鑰。
Skills 與 MCP. 已備好 150+ MCP 與 170+ Skills,支援快速安裝新的 Skills 與 MCP,也能從已完成的任務一鍵建立或改進 Skills。
瀏覽器介面與 CLI 支援. 選擇最適合你的方式使用 CraftBot:日常使用走簡潔的瀏覽器 UI,腳本與無介面環境則走 CLI。

🧰 快速開始

環境需求: Python 3.10+ · 瀏覽器模式需要 Node.js 18+

# 1. 複製儲存庫
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot

# 2. 安裝、註冊自動啟動並執行 CraftBot
python craftbot.py install

就這麼簡單。終端機會自動關閉,CraftBot 會在背景執行,瀏覽器也會自動開啟。同時還會建立一個桌面捷徑,方便你隨時重新打開瀏覽器。

安裝完成後管理服務:

python craftbot.py start      # 在背景啟動 CraftBot
python craftbot.py stop       # 停止 CraftBot
python craftbot.py restart    # 重啟 CraftBot
python craftbot.py status     # 查看執行狀態以及是否已啟用自動啟動
python craftbot.py logs       # 查看最近的日誌輸出
python craftbot.py uninstall  # 停止執行、移除自動啟動並解除安裝相依套件

Tip

執行 install 或 start 之後,系統會自動建立 CraftBot 桌面捷徑。如果關閉了瀏覽器,雙擊捷徑即可重新打開。

🌱 Living UI

Living UI 是會隨著你的需求一起演進的系統/應用/儀表板。

想要一塊內建 AI 協作夥伴的 Kanban 看板?
一套完全貼合你工作流程的客製化 CRM?
一個 CraftBot 可以代替你讀取並操作的公司儀表板?

# 1. 複製儲存庫
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot

# 2. 安裝到 conda 環境
python install.py --conda

# 3. 執行 CraftBot
conda run -n craftbot python run.py

# 若 conda 不在 PATH（僅 Windows）：
&"$env:USERPROFILE\miniconda3\Scripts\conda.exe" run -n craftbot python run.py

Note

每次要執行 CraftBot 時，請使用 conda run -n craftbot python run.py。此方式沒有背景服務——由你手動啟停。

方案三 — 手動安裝（pip）

適合你，如果： 你想完全掌控 Python 環境，不需要任何自動服務或背景程序，自己管理 CraftBot。

install.py（不帶旗標）會對目前啟用的 Python 環境執行標準 pip 安裝。透過 run.py 手動啟停 CraftBot。

# 1. 複製儲存庫
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot

# 2. 在目前 Python 環境中安裝相依套件
python install.py

# 3. 執行 CraftBot
python run.py

首次執行時會引導你完成 API 金鑰設定與偏好設定。

Note

若尚未安裝 Node.js，安裝程式會提供逐步指引。你也可以完全略過瀏覽器模式，直接使用 CLI 模式——無需 Node.js：python run.py --cli

立即能做什麼？

用自然語言與代理人對話
請它執行複雜的多步驟任務
輸入 /help 查看可用指令
連接 Google、Slack、Notion 等服務

🖥️ 介面模式

CraftBot 支援多種 UI 模式，可依個人偏好選擇：

模式	指令	需求	適用情境
Browser	`python run.py`	Node.js 18+	現代化網頁介面，最易使用
CLI	`python run.py --cli`	無	命令列，輕量化

Browser 模式為預設與建議選項。若沒有 Node.js，安裝程式會提供安裝指引，或你可改用 CLI 模式。

🧬 Living UI

Living UI 是隨你需求演進的系統／應用／儀表板。

需要一個內建 AI 副駕駛的看板？量身打造符合你工作流程的 CRM？一個 CraftBot 能讀取並驅動的公司儀表板？將它作為 Living UI 啟動——它與 CraftBot 並行運作，並隨著你的需求變化而成長。

建立 Living UI 的三種方式

從零開始建立. 用自然語言描述你想要的東西,CraftBot 會幫你搭好資料模型、後端 API 與 React 前端,並透過一套結構化的設計流程與你不斷迭代。

從市集安裝. 在 living-ui-marketplace 瀏覽社群打造的 Living UI。

匯入既有專案. 把 Go、Node.js、Python、Rust,或是靜態原始碼或 GitHub 儲存庫交給 CraftBot,它會自動偵測執行環境、設定健康檢查,並包裝成一個 Living UI。

Importing an existing project as a Living UI

讓 Agent 始終參與其中,持續演進

Living UI 永遠沒有「完成」這回事。需求一變,就讓 Agent 為它加上新功能、重新設計頁面或接上新的資料源。

CraftBot 嵌入在每一個 Living UI 中,並且對其狀態保持感知:它可以讀取目前的 DOM 與表單值、透過 REST API 查詢應用資料,並代你觸發操作。

讓 SaaS 工具保持開放且不停演進

打造、自訂並不斷演進屬於你自己的 Living UI,降低對那些根本沒為你量身打造的訂閱工具的依賴。

我們正在積極尋找願意展示自家 Living UI 的開發者,並支援將它們匯出到 Living UI 市集。歡迎送 PR!

三個 5 分鐘內就能試玩的 Living UI

📋 Kanban 看板 — 把任務、後續追蹤與待辦集中到一個地方,CraftBot 可以接手日常運營,替你完成 PM 工作。
📊 習慣追蹤器 — 培養並追蹤自己的習慣,用類 GitHub 風格的活動日曆像寫程式一樣維護你的習慣。
🐦 Luolinglo — 不是 Duolingo,但你可以學新語言、做單字卡片,並和 CraftBot 一起練習。

🧩 架構概覽

元件	說明
Agent Base	負責管理任務生命週期、協調各元件並處理主要代理人迴圈的核心編排層。
LLM Interface	支援多家 LLM 供應商（OpenAI、Gemini、Anthropic、BytePlus、Ollama）的統一介面。
Context Engine	產生最佳化的 Prompt，支援 KV-Cache。
Action Manager	從動作庫中擷取並執行動作，方便擴充自訂動作。
Action Router	依任務需求智慧挑選最合適的動作，並在需要時透過 LLM 解析輸入參數。
Event Stream	即時事件發佈系統，用於任務進度追蹤、UI 更新與執行監控。
Memory Manager	以 ChromaDB 為基礎的 RAG 語意記憶，處理記憶分塊、嵌入、檢索與增量更新。
State Manager	全域狀態管理，追蹤代理人執行脈絡、對話歷史與執行期設定。
Task Manager	管理任務定義，支援簡單與複雜任務模式、待辦清單建立，以及多步驟流程追蹤。
Skill Manager	載入並將可插拔技能注入到代理人情境中。
MCP Adapter	Model Context Protocol 整合，將 MCP 工具轉換為原生動作。

🔜 藍圖

記憶模組 — 完成。
外部工具整合 — 仍在持續新增！
MCP 層 — 完成。
技能層 — 完成。
主動式行為 — 進行中

📋 指令參考

install.py

旗標	說明
`--conda`	使用 conda 環境（選用）

run.py

旗標	說明
（無）	以 Browser 模式執行（建議，需 Node.js）
`--cli`	以 CLI 模式執行（輕量）

craftbot.py

指令	說明
`install`	安裝相依套件、註冊開機自動啟動，並啟動 CraftBot
`start`	在背景啟動 CraftBot
`stop`	停止 CraftBot
`restart`	停止後重新啟動
`status`	顯示執行狀態與自動啟動狀態
`logs [-n N]`	顯示最後 N 行記錄（預設 50）
`uninstall`	移除自動啟動註冊

安裝範例：

# 單純使用 pip 安裝（不使用 conda）
python install.py

# 使用 conda 環境（建議給 conda 使用者）
python install.py --conda

執行 CraftBot：

# Browser 模式（預設，需 Node.js）
python run.py

# CLI 模式（輕量）
python run.py --cli

# 使用 conda 環境
conda run -n craftbot python run.py

# 若 conda 不在 PATH，使用完整路徑
&"$env:USERPROFILE\miniconda3\Scripts\conda.exe" run -n craftbot python run.py

Linux/macOS（Bash）：

# Browser 模式（預設，需 Node.js）
python run.py

# CLI 模式（輕量）
python run.py --cli

# 使用 conda 環境
conda run -n craftbot python run.py

🔧 背景服務（建議）

將 CraftBot 當成背景服務執行，即使關閉終端機仍能持續運作。系統會自動建立桌面捷徑，讓你隨時可重新開啟瀏覽器。

# 安裝相依套件、註冊登入時自動啟動並啟動 CraftBot
python craftbot.py install

這樣就完成了。終端機會自動關閉，CraftBot 在背景執行，瀏覽器也會自動開啟。

# 其他服務指令：
python craftbot.py start    # 在背景啟動 CraftBot
python craftbot.py status   # 檢查是否正在執行
python craftbot.py stop     # 停止 CraftBot
python craftbot.py restart  # 重新啟動 CraftBot
python craftbot.py logs     # 檢視最近的記錄

指令	說明
`python craftbot.py install`	安裝相依套件、註冊登入時自動啟動、啟動 CraftBot、開啟瀏覽器並自動關閉終端機
`python craftbot.py start`	在背景啟動 CraftBot——若已在執行，會自動重啟（終端機自動關閉）
`python craftbot.py stop`	停止 CraftBot
`python craftbot.py restart`	停止並重新啟動 CraftBot
`python craftbot.py status`	檢查 CraftBot 是否執行中，以及自動啟動是否啟用
`python craftbot.py logs`	顯示最近的記錄（使用 `-n 100` 顯示更多行）
`python craftbot.py uninstall`	停止 CraftBot、移除自動啟動註冊、解除 pip 套件並清除 pip 快取

Tip

執行 craftbot.py start 或 craftbot.py install 後，會自動建立 CraftBot 桌面捷徑。若不小心關閉了瀏覽器，雙擊捷徑即可重新開啟。

Note

安裝： 若相依套件缺失，安裝程式會提供清楚的指引。若找不到 Node.js，會提示你安裝或切換至 CLI 模式。安裝程式會自動偵測 GPU 是否可用，必要時會自動回退至 CPU 模式。

Tip

首次設定： CraftBot 會引導你完成初始化流程，包含設定 API 金鑰、代理人名稱、MCP 與技能。

Note

Playwright Chromium： 整合 WhatsApp Web 時選用。若安裝失敗，代理人仍可正常執行其他任務。稍後可以手動安裝：playwright install chromium。

🔧 疑難排解與常見問題

缺少 Node.js (瀏覽器模式)

如果執行 python run.py 時看到 「npm not found in PATH」:

從 nodejs.org 下載 LTS 版本
安裝完成後重啟終端機
再次執行 python run.py

替代方案： 改用 CLI 模式（不需 Node.js）：

python run.py --cli

安裝時相依套件失敗

安裝程式現在會提供更詳細的錯誤訊息與解決方法。若安裝失敗:

檢查 Python 版本: 確認已安裝 Python 3.10 以上(python --version)
檢查網路連線: 安裝過程需要下載相依套件
清除 pip 快取: 執行 pip install --upgrade pip 之後再試一次

Playwright 安裝失敗

Playwright Chromium 的安裝為選用項目。即使失敗:

Agent 在其他任務上仍可正常運作
可以先略過,稍後再用 playwright install chromium 安裝
只有在使用 WhatsApp Web 整合時才需要

更完整的排解請參考 INSTALLATION_FIX.md。

🐳 使用容器執行

儲存庫根目錄包含一份 Docker 設定,內含 Python 3.10、關鍵系統套件(含用於 OCR 的 Tesseract),以及 environment.yml/requirements.txt 中定義的所有 Python 相依套件,讓 Agent 在隔離環境中也能穩定運作。

以下是使用容器執行 Agent 的步驟。

建立映像檔

從儲存庫根目錄執行:

docker build -t craftbot .

執行容器

映像檔預設會以 python -m app.main 啟動 Agent。如要互動式執行:

docker run --rm -it craftbot

需要傳入環境變數時,可以掛載一個 env 檔案(例如以 .env.example 為基礎):

docker run --rm -it --env-file .env craftbot

透過 -v 掛載需要持久化到容器外的目錄(例如資料或快取資料夾),並依部署需求調整 port 或其他參數。映像檔內建了 OCR(tesseract)所需的系統套件以及常見的 HTTP 客戶端,讓 Agent 可以直接在容器中處理檔案和網路 API。

映像檔預設使用 Python 3.10,並打包好 environment.yml/requirements.txt 中的相依套件,所以 python -m app.main 可以直接運作。

🤝 如何貢獻

歡迎送 PR!工作流程(fork → 從 dev 切分支 → 送 PR)詳見 CONTRIBUTING.md。所有 PR 都會自動跑 lint + 冒煙測試 CI。

Important

CraftBot 正在積極開發中,每週都有改進。有問題或想更快交流,歡迎加入 Discord,或寄信至 thamyikfoong(at)craftos.net。

🧾 授權

本專案以 MIT 授權開放原始碼。你可以自由地使用、自架以及商業化本專案(進行散布或商業化時,需保留對本專案的署名)。

⭐ 致謝

由 CraftOS 與貢獻者共同開發與維護。如果你覺得 CraftBot 有用,歡迎給儲存庫一顆 ⭐ 並分享給更多人!

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

✨ 核心特色

🧰 快速開始

🌱 Living UI

方案三 — 手動安裝（pip）

立即能做什麼？

🖥️ 介面模式

🧬 Living UI

建立 Living UI 的三種方式

讓 Agent 始終參與其中,持續演進

讓 SaaS 工具保持開放且不停演進

三個 5 分鐘內就能試玩的 Living UI

🧩 架構概覽

🔜 藍圖

📋 指令參考

install.py

run.py

craftbot.py

🔧 背景服務（建議）

🔧 疑難排解與常見問題

缺少 Node.js (瀏覽器模式)

安裝時相依套件失敗

Playwright 安裝失敗

🐳 使用容器執行

建立映像檔

執行容器

🤝 如何貢獻

🧾 授權

⭐ 致謝

Star 歷史

FilesExpand file tree

README.zh-TW.md

Latest commit

History

README.zh-TW.md

File metadata and controls

✨ 核心特色

🧰 快速開始

🌱 Living UI

方案三 — 手動安裝（pip）

立即能做什麼？

🖥️ 介面模式

🧬 Living UI

建立 Living UI 的三種方式

讓 Agent 始終參與其中,持續演進

讓 SaaS 工具保持開放且不停演進

三個 5 分鐘內就能試玩的 Living UI

🧩 架構概覽

🔜 藍圖

📋 指令參考

install.py

run.py

craftbot.py

🔧 背景服務（建議）

🔧 疑難排解與常見問題

缺少 Node.js (瀏覽器模式)

安裝時相依套件失敗

Playwright 安裝失敗

🐳 使用容器執行

建立映像檔

執行容器

🤝 如何貢獻

🧾 授權

⭐ 致謝

Star 歷史