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