3 步跑起 OpenHands：给自己搭一个常驻的 AI 编程控制台

3 步跑起 OpenHands给自己搭一个常驻的 AI 编程控制台【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是个自托管的 AI 编程助手控制台接上 LLM就能让 Agent 替你写代码、跑脚本、盯任务。第一次跑通它最常卡在环境和配置上。本文按启动、上手、排坑三步走约 10 分钟即可在本地开聊。OpenHands 能替你干什么先看 3 件实事聊天式编码一句话描述需求Agent 写代码、执行、回结果内置开源 Agent也接 ACP 协议的第三方 Agent。任务自动化设好定时或事件触发Agent 自己干活比如 PR 一提交就自动做代码审查。后端可切换本地进程、Docker 沙箱、远程服务器都能挂进来同一界面随时切。3 步启动 OpenHands 本地控制台注意需要 Node.js 22.12 和 Python 包管理器 uv。不配沙箱时 Agent 能读写本机文件初学建议先跑在容器或虚拟机里。第 1 步拿代码git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands拉下整个仓库ls能看到package.json和src目录就是成功。第 2 步装依赖npm install装前端依赖看到added xxx packages且没有红色报错即可。第 3 步启动npm run dev拉起完整本地栈浏览器打开http://localhost:8000看到左侧 Getting started 清单即成功。跟着 Getting Started 跑通 OpenHands 第一个任务打开界面侧栏清单直接给了顺序配模型密钥、开第一次对话、排一个定时任务。点Customize在 LLM 设置里填模型商和 API key它不绑定任何厂商。点New Chat输入写一个 bash 脚本输出 Hello World 并运行它。 Agent 把命令拆开执行终端区回显Hello World第一单完成。想让任务常驻去Automate加个定时或事件触发即可。跑完顺手自查一遍密钥填好模型能正常回话脚本执行成功输出可见Automate 页面能看到内置任务模板切换后端后会话列表不丢新手最容易问的 4 个问题Q1首次启动终端长时间不动是卡死了吗第一次要构建前端、拉 Agent 运行时等 1-3 分钟属正常卡在下载就换网络重试。Q28000 端口被占怎么办停掉占用服务或改用官方 Docker 镜像ghcr.io/openhands/agent-canvas启动把宿主机端口映射到别的值。Q3LLM 该选哪家它不绑厂商设置里建好 LLM profile 就能用写码和调试选能力强的模型体验会明显顺一些。Q4不加沙箱安全吗Agent 可读写机器上的文件稳妥做法是跑官方 Docker 镜像只挂载需要它碰的项目目录。三步之后OpenHands 就常驻在你的机器上了接下来交给它的活可以越来越多。更多部署方式和加固细节可看仓库里的 SELF_HOSTING.md 文档。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考