OpenHands Agent Canvas 是编程智能体的自托管控制台，可统一连接本机、Docker、虚拟机或云端后端。它能运行 OpenHands 智能体，也可连接 Claude Code、Codex、Gemini 等兼容 Agent-Client Protocol 的工具，部署复杂度高于普通 IDE 插件。
当前项目是什么状态
官方仓库当前以 Agent Canvas 为主，并在 README 中标记为 beta。它支持对话、多个后端及与 GitHub、Slack 等服务结合的自动化。准备长期部署前，应查看官方 Release 和自托管文档，不要把旧版 OpenHands Docker 教程直接套到当前架构。
三种本地安装方式
- npm：安装 @openhands/agent-canvas 后启动完整本地栈，前提是满足官方列出的 Node.js 与 uv 要求。
- Docker 沙箱：macOS、Windows 使用 Docker Desktop，Linux 可用 Docker Engine 或 Desktop，并只挂载准备让智能体访问的项目目录。
- 源码运行：面向开发和调试，需要 Node.js、npm、uv 等环境，不适合只想快速体验的普通用户。
为什么优先考虑 Docker 沙箱
官方对 npm 直接运行和源码运行都明确警告：agent-server 会直接运行在主机上，并可访问文件系统。Docker 方案仍然能访问挂载进容器的全部项目，所以 PROJECTS_PATH 不能指向整个用户目录、磁盘根目录、备份盘或包含密钥的目录。
模型和第三方智能体怎么配置
Agent Canvas 可以自带模型，也能连接不同智能体后端。每个模型或商业智能体的账号、费用、数据使用政策和地区限制独立计算；Agent Canvas 采用 MIT 许可证，不代表连接的服务免费或开源。API Key 应放在官方支持的密钥配置中，不写入仓库与自动化日志。
远程与自动化部署风险
- 不要把本地 8000 端口直接暴露到公网；远程使用需增加身份验证、HTTPS、访问控制和网络隔离。
- Slack、GitHub、Notion 等连接器只授予完成任务所需的仓库和频道权限。
- 定时任务和 Webhook 会在无人查看时运行，应限制可执行命令、并发、预算和持久化目录。
- 私有代码上线前先确认模型数据政策、日志保留、备份和事故回退流程。
部署结论
个人测试优先使用 Docker，并单独创建只含测试项目的挂载目录；不使用沙箱的 npm 和源码方式只适合清楚主机权限影响的用户。团队常驻部署还要按官方自托管指南补齐认证、密钥、网络和日志治理。
