3 条命令跑通 OpenHands从 git clone 到 AI 编程助手出结果的上手实录【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一个自托管的 AI 编程助手控制台让你把 OpenHands、Claude Code、Codex 等编码智能体跑在自己的机器、Docker 或服务器上统一管理和自动化。读完本文你能在本机起 OpenHands 控制台配好模型并完成一个输入自然语言→agent 写代码并执行的真实任务。项目速览它能替你干什么统一控制台跑多个编码智能体支持 ACP 协议的 agent本地、Docker、远程、云端多后端一键切换定时或事件触发的自动化任务GitHub、Slack 等内置聊天、终端、浏览器、文件面板自带技能Skills与 MCP 服务器扩展能力上图是 OpenHands 的自动化面板左侧是会话列表右侧是各个自动化任务的健康状态、最近成功率和平均耗时一眼能看出哪些任务在跑、哪些出了问题。适合你如果你希望 agent 常驻在自己的硬件上、数据不出内网或者想同时管理好几款 AI 编程助手。不太适合你的如果你只想零维护开箱即用——它毕竟是个要自己起服务的自托管项目。三条命令跑起来本地、Docker 沙箱或从源码克隆先看下系统要求不达标的话后面的报错基本都能对号入座配置项最低推荐Node.js22.12.x22.12低于 22.12 时 CLI 直接装不上uv已安装已安装用来拉起 Python 的 agent-serverDocker无任意 24.0想上沙箱隔离就需要磁盘1GB4GB镜像和依赖会吃掉空间方式一最快上手npm 全局装npm install -g openhands/agent-canvas # 全局安装 agent-canvas # 一键拉起前端agent-server自动化后端跑起来后浏览器访问http://localhost:8000就能看到界面。⚠️ 注意这种方式 agent 直接跑在你本机对文件系统有完整访问权限只建议在自己的开发机上用。方式二Docker 沙箱推荐export PROJECTS_PATH$HOME/projects # agent 可访问的项目目录 mkdir -p $PROJECTS_PATH $HOME/.openhands docker run -it --rm -p 8000:8000 \ -v $HOME/.openhands:/home/openhands/.openhands \ -v ${PROJECTS_PATH}:/projects \ ghcr.io/openhands/agent-canvas:1.15.0agent 只能碰到PROJECTS_PATH里挂载进去的项目隔离得更干净。方式三从源码克隆git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev三种方式最终都指向同一个界面。跑起来再说配置和模型都留到界面里弄。第一个真实任务让 AI 编程助手写脚本并跑起来✅ 打开界面后第一件事进设置页给你的 AI 编程助手填一个 LLM 的 API key支持各家主流模型没有 key 后面全是空谈。然后点 New Chat输入一句大白话创建一个 bash 脚本输出 Hello World然后运行它。接下来看系统做什么agent 会先生成一段echo hello_world.sh加chmod x的命令再申请执行你在终端面板里能看到命令逐条落下最后输出 Hello World。你不需要盯着每一步——看到终端出现预期的那行输出任务就算跑通了如果卡在半路往下翻会话里的报错信息通常提示里已经写清了缺什么。这个任务小但把 OpenHands 的核心链路走全了自然语言→生成命令→沙箱执行→回传结果。跑通它后面什么活儿都敢丢给它。踩坑与排障四个高频问题Unsupported engine (node 22.12.0)→ 你的 Node 太老。先node -v确认版本用 nvm 之类工具升到 22.12 再重装。8000 端口被占用、页面打不开→ 本地已有别的进程占了 8000 端口。lsof -i :8000找到它停掉它或者按终端里的提示用PORT别的端口覆盖再启动。Docker 里找不到你的项目文件→ 挂载的PROJECTS_PATH必须是启动容器前就存在的目录路径写错就整个白搭。先ls确认目录真实存在再重启容器。界面正常但 agent 一直不回应→ 通常是没配 LLM API key或者 key 失效。别怀疑代码去设置页检查模型配置换个 key 试一轮。往深了用自动化、后端切换和技能扩展把活儿排进日程表。点左侧的 Automate 进 DashboardAdd Automation 就能新建任务定时触发比如每天 09:00或事件触发比如仓库有 push、PR 被打开再把结果推到 Slack 或 GitHub。PR Review、文档同步、发布说明生成这些都有现成模板可参考。多后端自由切换。同一个界面上可以挂多个 Agent Server——比如一台共享服务器跑团队的代码评审 agent你自己的笔记本跑私人 agent。在界面里添加新后端左下角切换即可会话上下文不丢。接入你自己的 agent 和技能。Customize 页签下的三个入口各管一摊MCP Servers 用来挂外部工具服务器Skills 里可启用内置技能或从仓库 URL 导入Plugins/ACP 部分可以接 Claude Code、Codex、Gemini 等第三方编码 agent方法见 docs/ACP_AGENTS.md。把整体心智模型收一下OpenHands 前端React/TypeScript代码在src/涵盖src/api/服务适配、src/components/界面和src/stores/状态管理负责渲染聊天、终端、浏览器这些面板并把你的每个动作翻译成 API 调用真正执行 agent 动作的是后端 Agent Server一个多 agent 的 REST API可部署在任意主机自动化调度则由可选的 Automation Server 负责决定什么时候跑。详细边界划分见 docs/architecture.md生产部署的安全加固看 docs/SELF_HOSTING.md。下一步到这里你已经完成了本文开头承诺的事起服务、配模型、跑通第一个任务。建议下一步就打开 LLM 设置页把 API key 换成你常用的模型再回到 Automate 面板建一个每日项目摘要的定时任务——让它今晚自己跑一次明天早上验收。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3 条命令跑通 OpenHands：从 git clone 到 AI 编程助手出结果的上手实录
3 条命令跑通 OpenHands从 git clone 到 AI 编程助手出结果的上手实录【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一个自托管的 AI 编程助手控制台让你把 OpenHands、Claude Code、Codex 等编码智能体跑在自己的机器、Docker 或服务器上统一管理和自动化。读完本文你能在本机起 OpenHands 控制台配好模型并完成一个输入自然语言→agent 写代码并执行的真实任务。项目速览它能替你干什么统一控制台跑多个编码智能体支持 ACP 协议的 agent本地、Docker、远程、云端多后端一键切换定时或事件触发的自动化任务GitHub、Slack 等内置聊天、终端、浏览器、文件面板自带技能Skills与 MCP 服务器扩展能力上图是 OpenHands 的自动化面板左侧是会话列表右侧是各个自动化任务的健康状态、最近成功率和平均耗时一眼能看出哪些任务在跑、哪些出了问题。适合你如果你希望 agent 常驻在自己的硬件上、数据不出内网或者想同时管理好几款 AI 编程助手。不太适合你的如果你只想零维护开箱即用——它毕竟是个要自己起服务的自托管项目。三条命令跑起来本地、Docker 沙箱或从源码克隆先看下系统要求不达标的话后面的报错基本都能对号入座配置项最低推荐Node.js22.12.x22.12低于 22.12 时 CLI 直接装不上uv已安装已安装用来拉起 Python 的 agent-serverDocker无任意 24.0想上沙箱隔离就需要磁盘1GB4GB镜像和依赖会吃掉空间方式一最快上手npm 全局装npm install -g openhands/agent-canvas # 全局安装 agent-canvas # 一键拉起前端agent-server自动化后端跑起来后浏览器访问http://localhost:8000就能看到界面。⚠️ 注意这种方式 agent 直接跑在你本机对文件系统有完整访问权限只建议在自己的开发机上用。方式二Docker 沙箱推荐export PROJECTS_PATH$HOME/projects # agent 可访问的项目目录 mkdir -p $PROJECTS_PATH $HOME/.openhands docker run -it --rm -p 8000:8000 \ -v $HOME/.openhands:/home/openhands/.openhands \ -v ${PROJECTS_PATH}:/projects \ ghcr.io/openhands/agent-canvas:1.15.0agent 只能碰到PROJECTS_PATH里挂载进去的项目隔离得更干净。方式三从源码克隆git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev三种方式最终都指向同一个界面。跑起来再说配置和模型都留到界面里弄。第一个真实任务让 AI 编程助手写脚本并跑起来✅ 打开界面后第一件事进设置页给你的 AI 编程助手填一个 LLM 的 API key支持各家主流模型没有 key 后面全是空谈。然后点 New Chat输入一句大白话创建一个 bash 脚本输出 Hello World然后运行它。接下来看系统做什么agent 会先生成一段echo hello_world.sh加chmod x的命令再申请执行你在终端面板里能看到命令逐条落下最后输出 Hello World。你不需要盯着每一步——看到终端出现预期的那行输出任务就算跑通了如果卡在半路往下翻会话里的报错信息通常提示里已经写清了缺什么。这个任务小但把 OpenHands 的核心链路走全了自然语言→生成命令→沙箱执行→回传结果。跑通它后面什么活儿都敢丢给它。踩坑与排障四个高频问题Unsupported engine (node 22.12.0)→ 你的 Node 太老。先node -v确认版本用 nvm 之类工具升到 22.12 再重装。8000 端口被占用、页面打不开→ 本地已有别的进程占了 8000 端口。lsof -i :8000找到它停掉它或者按终端里的提示用PORT别的端口覆盖再启动。Docker 里找不到你的项目文件→ 挂载的PROJECTS_PATH必须是启动容器前就存在的目录路径写错就整个白搭。先ls确认目录真实存在再重启容器。界面正常但 agent 一直不回应→ 通常是没配 LLM API key或者 key 失效。别怀疑代码去设置页检查模型配置换个 key 试一轮。往深了用自动化、后端切换和技能扩展把活儿排进日程表。点左侧的 Automate 进 DashboardAdd Automation 就能新建任务定时触发比如每天 09:00或事件触发比如仓库有 push、PR 被打开再把结果推到 Slack 或 GitHub。PR Review、文档同步、发布说明生成这些都有现成模板可参考。多后端自由切换。同一个界面上可以挂多个 Agent Server——比如一台共享服务器跑团队的代码评审 agent你自己的笔记本跑私人 agent。在界面里添加新后端左下角切换即可会话上下文不丢。接入你自己的 agent 和技能。Customize 页签下的三个入口各管一摊MCP Servers 用来挂外部工具服务器Skills 里可启用内置技能或从仓库 URL 导入Plugins/ACP 部分可以接 Claude Code、Codex、Gemini 等第三方编码 agent方法见 docs/ACP_AGENTS.md。把整体心智模型收一下OpenHands 前端React/TypeScript代码在src/涵盖src/api/服务适配、src/components/界面和src/stores/状态管理负责渲染聊天、终端、浏览器这些面板并把你的每个动作翻译成 API 调用真正执行 agent 动作的是后端 Agent Server一个多 agent 的 REST API可部署在任意主机自动化调度则由可选的 Automation Server 负责决定什么时候跑。详细边界划分见 docs/architecture.md生产部署的安全加固看 docs/SELF_HOSTING.md。下一步到这里你已经完成了本文开头承诺的事起服务、配模型、跑通第一个任务。建议下一步就打开 LLM 设置页把 API key 换成你常用的模型再回到 Automate 面板建一个每日项目摘要的定时任务——让它今晚自己跑一次明天早上验收。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考