OpenHands 本地部署实操指南5分钟跑通 3个高频开发任务【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一个可自托管的 AI 编码代理工作台用自然语言驱动代码生成、测试编写与任务自动化。想在本地或团队服务器上统一跑多个编码代理、又不想数据出内网的开发者这篇给你一条最短路径。三个真实的开发卡点以及 OpenHands 的对应解法卡点一重复性编码占用大量时间。脚手架搭建、CRUD 接口、测试填充这类工作往往占掉一周里最整块的时间。OpenHands 的代理不是只给代码片段——它在沙箱里直接读写文件、执行 shell 命令、跑起服务来验证结果。你描述一次需求它交付的是一个跑通过的第一版而不是一堆待你拼装的片段。卡点二代理工具碎片化。Claude Code、Codex、Gemini 各有各的入口、配置和会话切换项目就要切上下文。OpenHands 的 Agent Canvas 提供一个统一的浏览器控制台所有兼容 ACPAgent-Client Protocol的代理都挂在同一套界面上本地、远程、云三类后端一键切换会话历史、项目上下文和运行状态都存在一个地方。卡点三任务不会自己跑。PR 巡检、依赖检查、每日汇总这类 7x24 小时的工作传统方式靠人记着手动触发。OpenHands 的自动化服务支持定时触发和 Webhook 触发GitHub push、Slack 提及等配好之后代理在你关机时也在干活跑完在 Dashboard 里看运行历史和成功率。从生成原型到自动补测试3 个任务的完整操作路径任务 1一句话生成可运行原型要完成什么一个包含商品列表、购物车和登录功能的站点初版。怎么操作左侧栏 New Chat选中目标项目目录直接写用 React 做前端、Node 做后端搭一个含商品列表/购物车/登录的站点并保证本地能跑起来。代理自己规划文件结构、写代码、在内置终端执行验证过程中你随时可以打开内置编辑器看它改了什么。得到什么一套前后端都可运行的代码加执行记录不用手写脚手架验收标准是浏览器里能打开。任务 2跨前后端语言的联动修改要完成什么一个带分页和过滤的用户列表 APITypeScript 前端调用和 Python 后端实现要同时改对。怎么操作把两个仓库放进同一个项目目录告诉代理前端拉取分页用户数据并支持按状态过滤后端补齐对应接口。它通读两种语言的代码先定后端接口签名再改前端调用与类型定义保证契约一致。得到什么一份两边语言配套的接口改动你只需要审最终的 diff。任务 3为存量代码补全单元测试要完成什么给核心模块补齐测试覆盖边界和异常分支且本地全部通过。怎么操作对代理说为 src/utils 下的模块生成单元测试覆盖边界与异常分支。它读取函数签名和调用链、写测试文件、在环境里执行红了就自己修直到变绿。得到什么可运行的测试文件加一份全绿的通过报告。 本地一键部署最小可运行步骤与环境预检环境预检清单Node.js 22.12 及以上、已安装uv源码方式必需Docker仅沙箱方式需要4GB 以上可用内存、10GB 以上磁盘空间能访问你所用模型 API 的网络方式 A从源码启动。注意代理会对宿主机文件系统有完整读写权限生产用途建议放专用机器或虚拟机git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev启动后浏览器打开 http://localhost:8000 即可进入控制台。方式 BDocker 沙箱。代理跑在容器里与宿主机隔离更好docker run -it --rm \ -p 8000:8000 \ -v $HOME/.openhands:/home/openhands/.openhands \ ghcr.io/openhands/agent-canvas:1.15.0访问 http://localhost:8000/canvas。想让代理接触你的项目目录再加一个卷把该目录挂到容器内的/projects即可。进阶技巧技能扩展、团队共享与后端切换自定义技能扩展。左侧 Customize 入口下的 Skills 页面内置约 60 个技能支持按分类搜索、单独启用或禁用把自己的编码规范、发布流程写成 Markdown 技能文件导入工作区代理在对应任务中会自动遵循。插件与 MCP Server 也在同一入口管理。团队共享后端。在云 VM 上跑 agent server用--public模式加LOCAL_BACKEND_API_KEY控制访问防火墙默认只放行 SSH需要浏览器访问再开 80/443 并挂 TLS。同事各自在本地 Canvas 里把这个远程地址加为后端团队共用一台干活机器。多后端与规模。同一前端可同时挂多个 agent server笔记本 / VM / 云切换不丢会话。个人使用本地默认配置即可多人或长任务密集场景把后端挪到 8GB 内存以上的专用机稳定性更从容。新手最常问的 4 个问题支持哪些语言和框架TypeScript/JavaScript、Python、Java、Go、SQL 以及 Docker、K8s 等 DevOps 配置都在日常覆盖范围内跨语言混编项目也直接支持。模型方面自带BYO Key接你手里任何一家的大模型即可。生成的代码靠不靠谱代理交付前会在环境里实际执行代码和测试你在对话流里就能看到真实输出。建议复杂逻辑拆成小任务下发并要求它附验证命令验收成本会低很多。数据存在哪里控制台、会话记录、项目代码全部落在你自己的机器或你自己的 Docker 卷里不经过第三方托管。唯一的外部流量是你配置的大模型 API 请求对敏感项目可换私有化部署的模型。不装 Docker 能跑吗可以。源码或 npm 全局安装方式直接在宿主机运行最省事但权限最大日常长任务建议还是给容器沙箱。今天就做一件事按上面的 4 行命令把本地环境拉起来挑一个新项目对代理说一句搭好脚手架并跑通测试。深入细节可以看 官方文档目录、自托管与部署安全说明动手实验前也可以翻一眼 示例目录 里的参考配置。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenHands 本地部署实操指南：5分钟跑通 + 3个高频开发任务
OpenHands 本地部署实操指南5分钟跑通 3个高频开发任务【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一个可自托管的 AI 编码代理工作台用自然语言驱动代码生成、测试编写与任务自动化。想在本地或团队服务器上统一跑多个编码代理、又不想数据出内网的开发者这篇给你一条最短路径。三个真实的开发卡点以及 OpenHands 的对应解法卡点一重复性编码占用大量时间。脚手架搭建、CRUD 接口、测试填充这类工作往往占掉一周里最整块的时间。OpenHands 的代理不是只给代码片段——它在沙箱里直接读写文件、执行 shell 命令、跑起服务来验证结果。你描述一次需求它交付的是一个跑通过的第一版而不是一堆待你拼装的片段。卡点二代理工具碎片化。Claude Code、Codex、Gemini 各有各的入口、配置和会话切换项目就要切上下文。OpenHands 的 Agent Canvas 提供一个统一的浏览器控制台所有兼容 ACPAgent-Client Protocol的代理都挂在同一套界面上本地、远程、云三类后端一键切换会话历史、项目上下文和运行状态都存在一个地方。卡点三任务不会自己跑。PR 巡检、依赖检查、每日汇总这类 7x24 小时的工作传统方式靠人记着手动触发。OpenHands 的自动化服务支持定时触发和 Webhook 触发GitHub push、Slack 提及等配好之后代理在你关机时也在干活跑完在 Dashboard 里看运行历史和成功率。从生成原型到自动补测试3 个任务的完整操作路径任务 1一句话生成可运行原型要完成什么一个包含商品列表、购物车和登录功能的站点初版。怎么操作左侧栏 New Chat选中目标项目目录直接写用 React 做前端、Node 做后端搭一个含商品列表/购物车/登录的站点并保证本地能跑起来。代理自己规划文件结构、写代码、在内置终端执行验证过程中你随时可以打开内置编辑器看它改了什么。得到什么一套前后端都可运行的代码加执行记录不用手写脚手架验收标准是浏览器里能打开。任务 2跨前后端语言的联动修改要完成什么一个带分页和过滤的用户列表 APITypeScript 前端调用和 Python 后端实现要同时改对。怎么操作把两个仓库放进同一个项目目录告诉代理前端拉取分页用户数据并支持按状态过滤后端补齐对应接口。它通读两种语言的代码先定后端接口签名再改前端调用与类型定义保证契约一致。得到什么一份两边语言配套的接口改动你只需要审最终的 diff。任务 3为存量代码补全单元测试要完成什么给核心模块补齐测试覆盖边界和异常分支且本地全部通过。怎么操作对代理说为 src/utils 下的模块生成单元测试覆盖边界与异常分支。它读取函数签名和调用链、写测试文件、在环境里执行红了就自己修直到变绿。得到什么可运行的测试文件加一份全绿的通过报告。 本地一键部署最小可运行步骤与环境预检环境预检清单Node.js 22.12 及以上、已安装uv源码方式必需Docker仅沙箱方式需要4GB 以上可用内存、10GB 以上磁盘空间能访问你所用模型 API 的网络方式 A从源码启动。注意代理会对宿主机文件系统有完整读写权限生产用途建议放专用机器或虚拟机git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev启动后浏览器打开 http://localhost:8000 即可进入控制台。方式 BDocker 沙箱。代理跑在容器里与宿主机隔离更好docker run -it --rm \ -p 8000:8000 \ -v $HOME/.openhands:/home/openhands/.openhands \ ghcr.io/openhands/agent-canvas:1.15.0访问 http://localhost:8000/canvas。想让代理接触你的项目目录再加一个卷把该目录挂到容器内的/projects即可。进阶技巧技能扩展、团队共享与后端切换自定义技能扩展。左侧 Customize 入口下的 Skills 页面内置约 60 个技能支持按分类搜索、单独启用或禁用把自己的编码规范、发布流程写成 Markdown 技能文件导入工作区代理在对应任务中会自动遵循。插件与 MCP Server 也在同一入口管理。团队共享后端。在云 VM 上跑 agent server用--public模式加LOCAL_BACKEND_API_KEY控制访问防火墙默认只放行 SSH需要浏览器访问再开 80/443 并挂 TLS。同事各自在本地 Canvas 里把这个远程地址加为后端团队共用一台干活机器。多后端与规模。同一前端可同时挂多个 agent server笔记本 / VM / 云切换不丢会话。个人使用本地默认配置即可多人或长任务密集场景把后端挪到 8GB 内存以上的专用机稳定性更从容。新手最常问的 4 个问题支持哪些语言和框架TypeScript/JavaScript、Python、Java、Go、SQL 以及 Docker、K8s 等 DevOps 配置都在日常覆盖范围内跨语言混编项目也直接支持。模型方面自带BYO Key接你手里任何一家的大模型即可。生成的代码靠不靠谱代理交付前会在环境里实际执行代码和测试你在对话流里就能看到真实输出。建议复杂逻辑拆成小任务下发并要求它附验证命令验收成本会低很多。数据存在哪里控制台、会话记录、项目代码全部落在你自己的机器或你自己的 Docker 卷里不经过第三方托管。唯一的外部流量是你配置的大模型 API 请求对敏感项目可换私有化部署的模型。不装 Docker 能跑吗可以。源码或 npm 全局安装方式直接在宿主机运行最省事但权限最大日常长任务建议还是给容器沙箱。今天就做一件事按上面的 4 行命令把本地环境拉起来挑一个新项目对代理说一句搭好脚手架并跑通测试。深入细节可以看 官方文档目录、自托管与部署安全说明动手实验前也可以翻一眼 示例目录 里的参考配置。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考