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 设置里配好你自己的模型端到端跑完第一个编码任务。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考