首页教程中心OpenHands 开源编程 Agent 部署与使用:搭建你的私有 AI 编程团队
🤖
🚀 进阶技巧
🚀 进阶技巧进阶

OpenHands 开源编程 Agent 部署与使用:搭建你的私有 AI 编程团队

OpenHands 1.0(原 OpenDevin)是 2026 年 9 月发布的开源自主 AI 编程 Agent,内置 Docker 沙箱和安全策略。本教程教你从零部署 OpenHands、配置模型后端、分配编程任务,让 AI 在自己服务器上完成代码编写、测试和调试。

40 分钟 5 个步骤2026-09-12
分享:

1环境准备与安装

OpenHands 1.0 的安装方式有多种,推荐使用 Docker 一键部署。 **最低要求:** - Linux 服务器(推荐 Ubuntu 22.04+)或 macOS - Docker 24+ & Docker Compose v2+ - 至少 8GB 内存(建议 16GB+) - 100GB 可用磁盘空间 **一键部署:** ```bash git clone https://github.com/All-Hands-AI/OpenHands.git cd OpenHands # 使用 Docker Compose 启动 cp config.toml.example config.toml # 编辑 config.toml 配置 LLM API Key docker compose up -d ``` **配置 LLM 后端(config.toml):** ```toml [llm] model = "claude-sonnet-4-6" api_key = "sk-xxxxx" # 可选:使用 DeepSeek 降低 token 成本 [llm.economy] model = "deepseek-chat" api_key = "sk-xxxxx" ``` 部署完成后访问 http://localhost:3000 即可进入 OpenHands 控制台。 💡 首次启动会自动拉取 Docker 镜像(约 2-3GB),请确保网络稳定。

小贴士

  • OpenHands 适合「一次性任务」而非「长期运行」——每次任务都是全新容器,不会记住上次的上下文
  • 安全策略要逐步收严:先在低风险项目上测试,确认沙箱行为后再应用到生产项目
  • 配合 GitHub Actions / GitLab CI 使用,让 OpenHands 自动处理 PR 审查
  • 挂载 volume 持久化代码时注意:OpenHands 可能修改你不想改的文件,建议先用 Git 分支隔离
  • 不是所有任务都适合 OpenHands——需要深厚业务理解的功能建议人工完成
1 / 5

📖 相关使用指南

💡 相关解决方案

⚖️ 工具对比