OpenBot怎麼用 開源個人AI機器人使用教程

OpenBot是一個開源的個人AI機器人框架，可以在本地執行，支援自定義AI助手和自動化任務。它更像一個可改造的模板：給AI助手配置瀏覽器、檔案和工具，再透過介面管理任務。下面按電腦端從下載安裝到首次執行來操作；需要準備Docker、Bun 1.3及以上版本、CopilotKit Intelligence專案和模型API金鑰。

第一步：準備執行環境

先安裝Docker Desktop並啟動，確認狀態顯示執行中；再安裝Bun 1.3或更新版本。開啟終端輸入bun --version，能看到版本號就行。模型服務也要先準備好API金鑰，首次配置會用到。OpenBot的本地啟動還依賴CopilotKit Intelligence專案，提前準備該專案的API地址和金鑰，別把金鑰發到公開聊天或提交到程式碼倉庫。

第二步：下載OpenBot專案

開啟終端，切換到你準備存放專案的資料夾，然後貼上以下命令並回車。下載完成後進入專案目錄，複製環境配置模板，並安裝依賴。等待命令執行結束再繼續；如果終端提示權限或網路錯誤，先檢查Docker、Bun是否已裝好，以及當前網路能否訪問GitHub。

git clone https://github.com/CopilotKit/OpenBot.git
cd OpenBot
cp .env.example .env
bun install

第三步：填寫模型和專案配置

用文字編輯器開啟專案根目錄裡的.env，找到模型和CopilotKit Intelligence相關配置項，填入對應服務的地址、專案金鑰及模型API金鑰。變數名以模板為準，不要隨意刪行或改名。儲存後回到終端；金鑰不要加到程式碼倉庫，示例金鑰也不要直接用於正式部署。

第四步：啟動本地服務

確認Docker仍在執行，終端當前目錄是OpenBot專案目錄，再執行啟動指令碼。首次啟動可能需要下載容器或構建資源，稍等片刻，留意終端有沒有報錯。啟動成功後，按終端提示在瀏覽器開啟本地地址；如果頁面打不開，先看終端日誌，並確認相關埠沒有被其他程式佔用。

bash scripts/start.sh

第五步：建立自己的AI助手

進入頁面後開啟Agents區域，選擇新建或編輯示例助手，填寫名稱、頭像和角色說明。角色說明儘量寫具體：例如“整理指定目錄裡的會議紀要，先列出待處理檔案，再按日期歸類”。儲存後開啟對應頻道發一條測試訊息，確認它能理解任務、給出符合預期的回覆。

第六步：配置任務和工具

按實際用途給助手啟用所需能力，例如瀏覽器、工作區檔案或已配置的工具，不需要的權限先別開。要接入MCP服務，就從外掛或工具配置入口新增服務，再回到助手設定授權。先用無敏感內容的小任務測試；遇到讀寫檔案、執行命令等動作時，檢查目標和權限邊界是否合適。

第七步：測試自動化流程

先從一步一確認的任務開始，比如讓助手讀取一份測試文件並輸出摘要。檢查結果後，再逐步嘗試多步驟流程；若頁面提供Routines入口，可在那裡配置重複執行的任務，並先用短週期驗證觸發是否正常。失敗時檢查模型金鑰、工具連線和終端日誌，修好後再重跑。

第八步：排錯或選擇替代方案

若安裝失敗，先在終端確認Docker和Bun可用，再檢查.env是否填全、指令碼是否在專案根目錄執行；仍啟動不了，就根據報錯逐項排查，不要盲目重複執行。想少折騰本地環境、直接體驗國內替代方案，可以瞭解Agent Space，開啟官網入口檢視使用方式；潤滅也可以把它作為入門體驗的備選。