OpenHands Agent Canvas：把编程 AI 变成你的专属工程团队

最近在 GitHub 上看到一个项目，Star 数已经到了 7.8 万，叫 OpenHands Agent Canvas。看了一下文档和功能介绍，觉得这东西确实有点东西。

简单说，它是一个自托管的开发者控制中心，让你能同时管理多个编程 AI 代理，包括 OpenHands 自家的代理、Claude Code、Codex、Gemini，以及任何兼容 ACP 协议的代理。

解决什么问题

现在编程 AI 工具越来越多，Claude Code 一个、Codex 一个、Gemini 一个，每个都有自己的界面和用法。你可能在笔记本上跑一个，在服务器上跑另一个，切来切去很烦。

Agent Canvas 就是把这些全部整合到一个界面里。你可以在同一个面板上启动对话、分配任务、切换不同的代理后端，不用反复跳转。

更关键的是，它支持自动化工作流。比如你可以设置一个任务：每天早上自动检查 GitHub 上的新 Issue，分解成子任务分配给代理处理，结果发到 Slack 频道。这种流程以前得自己写脚本搭，现在在界面上点几下就搞定了。

三种部署方式

第一种是裸机安装，不用 Docker，直接 npm 全局安装 agent-canvas 包就能跑。前提是装好 Node.js 22.12 以上版本和 uv。这种方式代理直接访问你的文件系统，适合个人开发机。

第二种是 Docker 沙箱模式，把代理跑在容器里，和宿主机文件系统隔离。你需要指定一个 PROJECTS_PATH 目录，代理只能访问这个目录下的项目。适合团队共用或者对安全性有要求的场景。

第三种是从源码构建，clone 仓库后 npm install 再 npm run dev，适合想参与开发或者需要定制功能的人。

架构设计

Agent Canvas 的后端叫 Agent Server，本质是一个 REST API，负责在单台机器上运行多个代理。每个 Agent Server 绑定一个端口，Agent Canvas 前端可以同时连接多个 Agent Server，在它们之间自由切换。

这个设计的灵活性在于：你可以在笔记本上跑一个本地 Agent Server 做日常开发，同时连一个团队共享的 Agent Server 做代码审查和依赖更新，两边互不干扰。

Agent Server 还能配合 Automation Server 使用，后者负责定时任务和 Webhook 事件触发。和 Slack、GitHub、Linear、Notion 这些第三方服务的集成也是通过 Automation Server 实现的。

适合谁用

如果你是个人开发者，平时用 Claude Code 或者 Codex 写代码，Agent Canvas 能给你一个统一的操作面板，省去在多个工具间切换的麻烦。

如果你是团队的技术负责人，想让 AI 代理参与到代码审查、Issue 分解、自动化测试这些流程里，Agent Canvas 的自动化功能值得看看。特别是它支持自托管，数据和代码都跑在自己的服务器上，不用担心隐私问题。

需要注意的地方

项目目前还是 Beta 状态，代码仓库正在迁移中。Agent Server 的源码已经搬到 software-agent-sdk 仓库，Agent Canvas 的源码在 agent-canvas 仓库。如果你打算深度使用或者贡献代码，要注意这个变化。

另外，裸机安装模式下代理有完整的文件系统访问权限，操作不当可能影响本地文件。如果对安全性有要求，建议用 Docker 沙箱模式。

总的来说，这个项目把分散的编程 AI 工具整合成了一个统一的控制中心，自动化能力也做得比较完善。7.8 万 Star 不是白来的，确实解决了实际问题。

一的控制中心，自动化能力也做得比较完善。7.8 万 Star 不是白来的，确实解决了实际问题。