OpenHands 部署教程4 條命令完成本地 Agent Canvas 搭建【免費(fèi)下載鏈接】OpenHands OpenHands: AI-Driven Development項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一個(gè)自托管的編碼智能體控制面板它統(tǒng)一管理對(duì)話(huà)、自動(dòng)化任務(wù)和多個(gè) Agent 后端把 AI 編程工具變成常駐的開(kāi)發(fā)團(tuán)隊(duì)。按本教程操作4 條命令就能在本機(jī)跑通服務(wù)并完成一次基礎(chǔ)功能驗(yàn)證。最短路徑4 條命令完成本地部署git clone https://gitcode.com/GitHub_Trending/ope/OpenHands拉取項(xiàng)目代碼到本地。cd OpenHands進(jìn)入項(xiàng)目根目錄。npm install安裝前端依賴(lài)。npm run dev啟動(dòng)完整本地棧隨后瀏覽器訪(fǎng)問(wèn) http://localhost:8000 。環(huán)境自檢命令清單開(kāi)始之前確認(rèn)你的機(jī)器滿(mǎn)足以下條件? Node.js 22.12 或更高版本? npm 可用隨 Node 一起提供? 已安裝 uv并能提供 uvx 命令? 端口 8000、3001、18000、18001 未被占用? 磁盤(pán)剩余空間 2GB 以上前端依賴(lài)加首次后端下載自檢命令node -v uvx --version第一條輸出 v22.12.0 或更高版本號(hào)、第二條輸出 uvx 的版本號(hào)即合格。部署步驟構(gòu)建并啟動(dòng)本地服務(wù)棧上面 4 條命令是最小集合下面拆解每一步在做什么。獲取并進(jìn)入項(xiàng)目代碼目的拿到最新源碼并進(jìn)入根目錄。git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHandsclone 下來(lái)的是 Agent Canvas 前端與本地棧編排腳本cd 之后所有后續(xù)命令都在根目錄執(zhí)行。接下來(lái)安裝前端依賴(lài)目的裝好 React、Vite 等依賴(lài)為構(gòu)建做準(zhǔn)備。npm install正常結(jié)束時(shí)根目錄會(huì)出現(xiàn) node_modules 目錄耗時(shí)取決于網(wǎng)絡(luò)。完成上一步后啟動(dòng)完整本地棧。npm run dev啟動(dòng)腳本會(huì)先檢查 Node、uvx 是否可用以及 8000、3001、18000、18001 四個(gè)端口是否空閑然后通過(guò) uvx 拉起 PyPI 上的 agent-server 與 automation 后端再啟動(dòng) Vite 前端和 ingress 反向代理。首次運(yùn)行需要下載后端包耐心等待終端出現(xiàn) Ready at 日志。注意該模式會(huì)把 agent-server 直接跑在你本機(jī)Agent 可訪(fǎng)問(wèn)本地文件建議在你信任的開(kāi)發(fā)目錄運(yùn)行。如果只跑對(duì)話(huà)、不需要自動(dòng)化服務(wù)可以改用更輕的棧。npm run dev:minimal只啟動(dòng) agent-server 和前端訪(fǎng)問(wèn)地址變?yōu)?http://localhost:3001/ 。關(guān)鍵配置項(xiàng)與建議值啟動(dòng)腳本支持用環(huán)境變量覆蓋默認(rèn)行為把它們寫(xiě)進(jìn)項(xiàng)目根目錄的 .env 文件即可被自動(dòng)加載。下面幾項(xiàng)改錯(cuò)會(huì)直接影響運(yùn)行參數(shù)作用建議值PORTingress 入口端口決定訪(fǎng)問(wèn)地址保持8000被占用時(shí)改為PORT8080 npm run devOH_AGENT_SERVER_VERSION指定從 PyPI 拉取的 agent-server 版本不設(shè)置默認(rèn)用最新發(fā)布版VITE_WORKING_DIR新建對(duì)話(huà)時(shí)使用的默認(rèn)工作區(qū)路徑不設(shè)置默認(rèn)當(dāng)前 checkout 目錄LOCAL_BACKEND_API_KEY會(huì)話(huà) API 密鑰局域網(wǎng)公開(kāi)部署--public時(shí)必填本機(jī)默認(rèn)自動(dòng)生成對(duì)外暴露時(shí)顯式設(shè)置跑通驗(yàn)證與常見(jiàn)問(wèn)題快速修復(fù)成功標(biāo)志終端里各服務(wù)依次打出 Ready at 日志且不再報(bào)錯(cuò)瀏覽器打開(kāi) http://localhost:8000 出現(xiàn) Agent Canvas 主界面左側(cè)能看到 New Chat 與對(duì)話(huà)列表說(shuō)明服務(wù)已跑通。問(wèn)題一端口沖突導(dǎo)致啟動(dòng)退出你看到什么npm run dev剛執(zhí)行終端就報(bào) EADDRINUSE 類(lèi)錯(cuò)誤并退出。為什么啟動(dòng)腳本會(huì)檢查 8000、18000、18001、3001 四個(gè)端口任一被占就直接失敗。怎么改換入口端口執(zhí)行PORT8080 npm run dev或先關(guān)閉占用端口的進(jìn)程再啟動(dòng)。問(wèn)題二提示 uvx 不存在你看到什么啟動(dòng)自檢階段打印 uvx not found進(jìn)程退出。為什么agent-server 與 automation 后端都靠 uvx 拉起而機(jī)器上沒(méi)有安裝 uv。怎么改按 uv 官方文檔安裝裝完即提供 uvx 命令然后重新執(zhí)行npm run dev。問(wèn)題三界面能打開(kāi)但 Agent 無(wú)法干活你看到什么頁(yè)面正常但左側(cè) Getting started 清單中 Add LLM API key 未勾選對(duì)話(huà)發(fā)不出有效任務(wù)。為什么OpenHands 依賴(lài) LLM 生成并執(zhí)行代碼本地后端默認(rèn)沒(méi)有任何模型憑據(jù)。怎么改進(jìn)入 Settings 的 LLM 設(shè)置填入一個(gè)模型服務(wù)商與 API Key再新建一次對(duì)話(huà)驗(yàn)證。用起來(lái)之后你可以先試一個(gè)小任務(wù)新建對(duì)話(huà)讓 Agent「列出工作目錄下的文件并總結(jié)項(xiàng)目結(jié)構(gòu)」觀察它的執(zhí)行過(guò)程。接著按左側(cè) Getting started 清單走完「配置 LLM 密鑰 → 第一次對(duì)話(huà) → 創(chuàng)建定時(shí)任務(wù)」把自動(dòng)化能力也用起來(lái)。想深入的話(huà)docs/ 目錄里有自托管、開(kāi)發(fā)與架構(gòu)文檔前端源碼在 src/ 下。OpenHands Agent Canvas 的核心價(jià)值是給你一個(gè)能在本機(jī)運(yùn)行、并能連接外部后端的統(tǒng)一智能體面板。下一步建議在 LLM 設(shè)置里配好你自己的模型端到端跑完第一個(gè)編碼任務(wù)?！久赓M(fèi)下載鏈接】OpenHands OpenHands: AI-Driven Development項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考