方式一：无沙箱快速启动（适合本地测试）

⚠️ 注意：代理会直接访问本地文件系统

npm install -g @openhands/agent-canvas
agent-canvas

也可以拆分启动前后端：

• 仅启动前端：agent-canvas --frontend-only
• 仅启动后端：agent-canvas --backend-only

方式二：Docker 沙箱安装（更安全）

✅ 代理仅能访问挂载的项目目录

export PROJECTS_PATH="$HOME/projects"  # 替换为你的项目目录
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.0.0-rc.11

Windows用户可参考仓库内的 README.windows.md 获取对应命令。

方式三：源码安装

git clone https://github.com/OpenHands/agent-canvas.git
cd agent-canvas
npm install
npm run dev

场景一：日常开发任务自动化

自动完成代码review、依赖更新、issue拆解等重复性工作，减少人工投入。例如：每晚自动检查依赖更新并创建PR，或自动review PR代码并给出建议。

场景二：多环境代理管理

团队共享云端代理处理公共任务，个人本地代理处理私有开发任务，在同一界面统一管控。例如：团队用云端代理处理CI/CD任务，开发者用本地代理进行私密项目开发。

场景三：第三方工具联动

GitHub收到新Issue时自动触发代理拆解任务，定时生成项目报告推送到Slack，实现开发流程自动化。支持与Slack、GitHub、Linear、Notion等工具集成。

场景四：7×24小时任务运行

部署到云端服务器后，代理可以在本地机器关闭后持续运行，满足异步任务、定时任务的需求。例如：每晚凌晨2点自动运行测试套件并生成报告。

核心特点

• 🔒 安全可控：支持Docker沙箱隔离，避免代理直接访问宿主机文件系统
• 📈 高扩展性：兼容ACP协议的任意代理，支持任意LLM接入，第三方工具集成门槛低
• 🚀 部署灵活：支持本地、Docker、虚拟机、云端、企业基础设施等多种部署方式
• 🌐 开源生态：项目完全开源，配套完整的开发文档、贡献指南、社区支持

✅ 完整的企业级功能

不同于简单的AI编程助手，OpenHands提供了完整的工程化能力：多代理编排、定时任务、Webhook触发、第三方工具集成等。它可以真正成为你的”AI团队成员”，而不仅仅是代码补全工具。

✅ 灵活的部署选项

支持从本地测试到企业级部署的全场景覆盖。Docker沙箱模式既保证了安全性，又保留了灵活性。对于关心数据隐私的团队，可以完全自托管，不依赖任何第三方服务。

✅ 开放的生态系统

通过ACP协议，OpenHands可以无缝接入几乎所有主流AI编程工具（Claude Code、Codex、Gemini、DeepSeek等）。这种开放架构避免了供应商锁定，让你可以根据任务和预算灵活切换模型。

✅ 活跃的开源社区

截至2026年6月，OpenHands已获得77.8K+ Stars，拥有活跃的贡献者社区。活跃的社区意味着丰富的插件、快速的问题响应和持续的功能迭代。

💬 个人使用心得：OpenHands最适合有一定技术基础的开发者或团队。如果你是个人开发者，可以从无沙箱模式快速上手；如果是企业用户，建议使用Docker沙箱或云端部署。它的学习曲线略陡，但一旦掌握，能显著提升开发效率。

📦 快速安装

npm install -g @openhands/agent-canvas
agent-canvas

启动后访问 http://localhost:8000 开始使用