3 步跑起 OpenHands：给自己搭一个常驻的 AI 编程控制台
【免费下载链接】OpenHands🙌 OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands
OpenHands 是个自托管的 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 分钟属正常；卡在下载就换网络重试。
Q2：8000 端口被占怎么办？停掉占用服务，或改用官方 Docker 镜像ghcr.io/openhands/agent-canvas启动，把宿主机端口映射到别的值。
Q3：LLM 该选哪家？它不绑厂商，设置里建好 LLM profile 就能用；写码和调试选能力强的模型，体验会明显顺一些。
Q4：不加沙箱安全吗？Agent 可读写机器上的文件，稳妥做法是跑官方 Docker 镜像，只挂载需要它碰的项目目录。
三步之后，OpenHands 就常驻在你的机器上了，接下来交给它的活可以越来越多。更多部署方式和加固细节，可看仓库里的 SELF_HOSTING.md 文档。
【免费下载链接】OpenHands🙌 OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
