# OpenHands Agent Canvas：可自托管的AI编码平台

> OpenHands推出的开源AI编码平台，支持本地或云端部署，可手动触发、定时运行或自动响应Slack/GitHub事件，兼容Claude Code、Codex等多种Agent及主流LLM。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-14T20:15:05.000Z
- 最近活动: 2026-05-14T20:18:50.900Z
- 热度: 150.9
- 关键词: AI编码, OpenHands, 自托管, Agent平台, Claude Code, Codex, 自动化工作流, 开源工具
- 页面链接: https://www.zingnex.cn/forum/thread/openhands-agent-canvas-ai
- Canonical: https://www.zingnex.cn/forum/thread/openhands-agent-canvas-ai
- Markdown 来源: ingested_event

---

# OpenHands Agent Canvas：可自托管的AI编码平台\n\n## 项目概述\n\nOpenHands Agent Canvas是一个**可自托管的AI编码平台**，旨在为开发者提供一个统一的管理界面来运行、调度和监控各类AI Agent。与传统的云端AI编码工具不同，Agent Canvas强调**本地优先**和**自主可控**——你可以在自己的笔记本电脑、远程虚拟机或私有云基础设施上运行它。\n\n这个项目目前处于**沙盒阶段**，由OpenHands社区孵化。尽管代码可能未经充分测试，但它已经展现了一个令人兴奋的愿景：**让AI编码助手真正属于开发者自己**。\n\n## 核心功能\n\nAgent Canvas提供了一个Web前端界面，核心能力围绕三种运行模式展开：\n\n### 1. 手动触发（Manual Prompting）\n\n开发者可以直接在界面中输入提示词，与AI Agent进行交互。这适用于探索性编码任务、快速原型开发或需要人工监督的敏感操作。\n\n### 2. 定时运行（Scheduled Execution）\n\n通过集成Automation Server，Agent Canvas支持设置定时任务。例如：\n\n- 每天凌晨自动审查代码库中的潜在问题\n- 每周生成项目文档更新\n- 定时运行回归测试套件\n\n### 3. 自动触发（Event-Driven）\n\n这是Agent Canvas最具特色的功能。它可以监听外部事件并自动触发Agent执行：\n\n- **GitHub集成**：当收到Pull Request时自动审查代码\n- **Slack集成**：在特定频道提及机器人时触发响应\n- **Webhook支持**：接收任意HTTP请求作为触发器\n\n## 灵活的部署选项\n\nAgent Canvas的设计理念是"随处运行"，支持多种部署场景：\n\n### 本地开发环境\n\n最简单的启动方式是在本地机器上运行。只需要Node.js 22.12+和npm：\n\n```bash\nexport PROJECT_PATH=/path/to/your/projects\ngit clone https://github.com/OpenHands/agent-canvas.git\ncd agent-canvas\nnpm install\nnpm run dev:docker\n```\n\n访问`http://localhost:8000`即可使用。\n\n### 远程虚拟机\n\n对于团队协作场景，可以将Agent Canvas部署在远程VM上。项目提供了详细的[SELF_HOSTING.md](https://github.com/OpenHands/agent-canvas/blob/main/SELF_HOSTING.md)指南，包含安全加固建议。\n\n### 云端托管\n\nOpenHands也提供商业化的云端托管服务（OpenHands Cloud），适合不想自行维护基础设施的团队。\n\n### 企业内网\n\nAgent Canvas可以部署在企业内部网络中，与现有的代码仓库、CI/CD流水线和其他内部工具集成。\n\n## 多Agent与多模型支持\n\nAgent Canvas的一个关键优势是**不绑定特定的AI Agent或模型**。它支持：\n\n### 支持的Agent类型\n\n- **Claude Code**：Anthropic的AI编码助手\n- **Codex**：OpenAI的代码生成模型\n- **自定义Agent**：任何符合OpenHands Agent Server协议的实现\n\n### 支持的LLM提供商\n\n- Anthropic（Claude系列）\n- OpenAI（GPT系列）\n- Google（Gemini系列）\n- Mistral\n- Minimax\n- Kimi（月之暗面）\n\n这种灵活性意味着开发者可以根据任务需求、成本考虑或隐私要求选择最合适的模型，而不被锁定在单一供应商生态中。\n\n## 技术架构\n\nAgent Canvas采用前后端分离的架构：\n\n### Agent Server\n\n后端核心是[OpenHands Agent Server](https://github.com/OpenHands/software-agent-sdk/tree/main/openhands-agent-server/openhands/agent_server)，一个REST API服务，负责：\n\n- 管理多个Agent实例的生命周期\n- 处理Agent与文件系统的交互\n- 提供安全的沙箱执行环境\n- 收集和转发Agent的输出日志\n\nAgent Server可以独立运行，Agent Canvas只是它的一个Web前端。\n\n### Automation Server\n\n可选组件，用于支持定时任务和事件触发。它维护任务队列，监听外部事件，并在适当时机调用Agent Server。\n\n### 前端界面\n\n基于现代Web技术栈构建的响应式界面，包含：\n\n- **浏览器面板**：查看Agent操作的网页内容\n- **对话面板**：与Agent进行多轮交互\n- **文件浏览器**：查看和编辑代码文件\n- **设置界面**：配置Agent、模型和集成\n\n## 安全考量\n\n由于Agent Canvas会执行AI生成的代码，安全是一个关键考虑因素：\n\n### 容器化隔离\n\n默认的Docker部署模式将Agent运行在隔离的容器中，限制其对宿主系统的访问。只有明确配置的目录（如`$PROJECT_PATH`）会被挂载到容器内。\n\n### 权限控制\n\n容器默认以宿主用户的UID/GID运行，确保生成的文件在主机上保持可写。用户可以通过环境变量精细控制挂载范围。\n\n### 无Docker模式\n\n对于需要更高性能或特殊硬件访问的场景，也支持直接运行（`npm run dev:dangerously-dockerless`）。但这种方式**会直接暴露宿主机文件系统给Agent**，需要格外谨慎。\n\n## 使用场景\n\n### 个人开发者\n\n作为日常编码助手，处理重复性任务如：\n\n- 生成单元测试\n- 重构遗留代码\n- 编写文档注释\n- 探索新API\n\n### 小型团队\n\n部署在共享服务器上，团队成员可以：\n\n- 提交代码审查请求\n- 自动化日常维护任务\n- 统一代码风格\n\n### 开源项目维护\n\n通过GitHub集成自动处理：\n\n- PR初筛和标签分类\n- Issue回复和建议\n- 文档更新\n\n### 企业环境\n\n在私有云中部署，满足：\n\n- 数据不出境的合规要求\n- 与内部系统的深度集成\n- 细粒度的访问控制\n\n## 项目状态与路线图\n\n目前Agent Canvas处于**沙盒阶段**，OpenHands官方明确表示：\n\n> \"本项目可能由AI辅助生成、未经充分测试或已过时。OpenHands不对代码或其支持承担任何责任。\"\n\n这意味着：\n\n- API可能不稳定\n- 功能可能不完整\n- 文档可能滞后\n\n但这也表明项目正在积极迭代中。社区通过Slack频道和GitHub Issues收集反馈，推动项目向稳定版本演进。\n\n## 结语\n\nOpenHands Agent Canvas代表了一种**去中心化的AI编码工具**发展方向。与完全依赖云服务的解决方案不同，它赋予开发者对自身AI助手的完全控制权——从运行的硬件到使用的模型，从触发的规则到访问的数据。\n\n对于关注AI工具自主可控性的开发者来说，Agent Canvas是一个值得关注的开源项目。随着项目从沙盒阶段走向成熟，它有望成为AI辅助编程领域的重要基础设施。