OpenHands Agent Canvas

OpenHands Agent Canvas 是什么

OpenHands Agent Canvas 是 OpenHands 项目推出的自托管开发者控制中心，目标是把编码智能体变成一支「常驻在线」的工程团队。你可以在同一个界面里发起对话、编排自动化任务，并让 Agent 真正动手改代码、发报告、处理 Issue。

它默认运行开源的 OpenHands Agent，同时也兼容 Claude Code、Codex、Gemini CLI、Pi、OpenCode 等第三方 Agent，以及任何遵循 ACP（Agent-Client Protocol）的智能体。

核心能力

• 自托管部署：可跑在本机、Docker 容器、虚拟机或公司内网服务器上，也可选择 OpenHands Cloud / Enterprise。
• 多后端切换：本地、远程、云端 Agent 后端可在同一前端中自由切换，互不打断。
• 自动化工作流：支持定时任务与 Webhook 触发，例如把 GitHub Issue 自动拆解为任务、生成报告并推送到 Slack。
• 工具集成：与 Slack、GitHub、Linear、Notion 等服务打通。
• 自带模型：可接入任意 LLM，通过 LLM Profiles 管理配置。
• 任意 Agent：除内置 OpenHands 外，可接入 ACP 兼容的第三方 Agent。

三种运行方式

1. 无沙箱（直接本机运行）

注意：Agent 将拥有对本机文件系统的完整访问权限，请谨慎使用。

前置条件：Node.js 24+ 与 uv。

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

也可拆分启动：

agent-canvas --frontend-only  # 仅静态前端 + 入口
agent-canvas --backend-only   # 仅 Agent Server + 自动化后端 + 入口

2. Docker 沙箱

准备一个 PROJECTS_PATH 目录存放项目，然后以容器方式启动，Agent 只能访问挂载进去的项目目录，隔离性更好。

3. 多 Docker 沙箱

每个新会话运行在独立容器中，各自拥有 Agent Server 与工具，适合并行跑多个 Agent：

OH_CONVERSATION_RUNTIME=docker agent-canvas

适合谁

• 想把 AI 编码助手接入团队日常流程的研发团队
• 需要长期在线、可被 Slack/GitHub 触发的自动化 Agent
• 希望自托管、数据不出内网的团队

注意事项

• 无沙箱模式安全性最低，生产环境建议使用 Docker 或独立服务器，并参考官方自托管文档做安全加固。
• 完整功能依赖 Node.js 24、uv、Docker 等环境，首次配置需要一定经验。
• 项目迭代较快，建议以官方文档为准。