OpenHands Agent Canvas 编程智能体控制台

OpenHands Agent Canvas：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Agent Canvas 要从 OpenHands 的仓库安装，地址是 https://github.com/OpenHands/OpenHands

这些说明不是 OpenHands 写的，也没有得到它的认可。README 把 Agent Canvas 称为“The self-hosted developer control center for coding agents and automations.”，意思是：自托管的编程智能体与自动化开发者控制中心。它还说，Agent Canvas 能在本地、远程和云端后端上运行 OpenHands、Claude Code、Codex、Gemini、Pi、OpenCode 或任何兼容 ACP 的智能体。文档从 https://docs.openhands.dev/openhands/usage/agent-canvas/overview 开始

许可证：MIT。LICENSE 文件（https://github.com/OpenHands/OpenHands/blob/HEAD/LICENSE）是 MIT 许可证文本，写着“Copyright © 2025 OpenHands contributors”。package.json 里也写的是 MIT。

这些说明依据仓库的 README、README.windows.md、LICENSE、package.json 和 AGENTS.md，docs 文件夹里的五个文件（README.md、architecture.md、ACP_AGENTS.md、DEVELOPMENT.md 和 SELF_HOSTING.md），以及每个文件里提到的文档页面写成，全部读于 2026 年 11 月 3 日。

它是什么

Agent Canvas 是一个浏览器应用，背后有一个后端。浏览器里显示对话、文件、终端、设置和 Automate 视图。后端叫 Agent Server，运行智能体和它的工具。文档说，后端可以运行在你的电脑上、Docker 里、虚拟机上、Modal 上或 OpenHands Cloud 上，一个 Canvas 也可以在几个后端之间切换。来源：https://docs.openhands.dev/openhands/usage/agent-canvas/overview

主要安装命令

它需要 Node.js 24 或更高版本，以及 uv。来源：https://github.com/OpenHands/OpenHands/blob/HEAD/README.md

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

然后打开 http://localhost:8000。这样运行时，智能体直接跑在你的机器上，权限就是你的用户账号的权限。README 警告说，这种模式下“the agent will have full access to your filesystem”，也就是智能体对你的文件系统拥有完全访问权。想要沙盒，请用 setup/docker.md 里的 Docker 途径。

各途径的说明

• setup/desktop-app.md：macOS、Windows 和 Linux 的桌面预览版，不用 npm，也不用终端
• setup/npm-and-npx.md：全局包、npx、启动选项、更新、卸载和源码检出
• setup/docker.md：官方镜像、每个对话一个容器，以及让智能体使用 Docker
• setup/vm-and-remote-access.md：虚拟机或常开的机器、公开模式、隧道、反向代理和手机
• setup/agents-and-models.md：它能驱动的五个外部智能体、模型密钥和 LLM 配置
• setup/automations.md：Automate 视图、预置自动化、导出和导入

更新或移除

安装页给出的 npm 安装的更新和卸载命令：

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

npm uninstall -g @openhands/agent-canvas

卸载不会删除你的设置、密钥和对话历史。该页说，它们存放在：npm 和 npx 安装在 ~/.openhands，Docker 安装在 openhands-data 卷。来源：https://docs.openhands.dev/openhands/usage/agent-canvas/setup

使用数据

package.json 列出了 posthog-js，AGENTS.md 也把贡献者指向一份涵盖 PostHog 和同意方式的遥测技能。Docker 页面给出了关掉 Agent Canvas 产品遥测的开关：把 AGENT_CANVAS_DISABLE_TELEMETRY 设为 1 或 true 会关掉它，运行时参数 --disable-telemetry 效果相同。为这些说明读过的页面没有列出具体发送什么。来源：https://docs.openhands.dev/openhands/usage/agent-canvas/backend-setup/docker

其他对外连接

你的提示词会发给你选的模型服务商，或外部智能体自己的服务商。ACP 页面上每个外部智能体的默认命令都是一行 npx -y。该页说，Pi 和 OpenCode 都没有预装在 Agent Server 镜像里，所以第一次对话会通过 npx 下载那个命令行工具。本地整套服务通过 uv 运行智能体服务器，DEVELOPMENT.md 说，npm 和 Docker 安装所用的 Python 后端版本，是 config/defaults.json 里固定的 PyPI 版本。来源：https://docs.openhands.dev/openhands/usage/agent-canvas/acp-agents 和 https://github.com/OpenHands/OpenHands/blob/HEAD/docs/DEVELOPMENT.md

来源

• README：https://github.com/OpenHands/OpenHands/blob/HEAD/README.md
• Windows 快速入门：https://github.com/OpenHands/OpenHands/blob/HEAD/README.windows.md
• 架构：https://github.com/OpenHands/OpenHands/blob/HEAD/docs/architecture.md
• 自托管：https://github.com/OpenHands/OpenHands/blob/HEAD/docs/SELF_HOSTING.md
• ACP 智能体：https://github.com/OpenHands/OpenHands/blob/HEAD/docs/ACP_AGENTS.md
• 概览：https://docs.openhands.dev/openhands/usage/agent-canvas/overview
• 安装：https://docs.openhands.dev/openhands/usage/agent-canvas/setup
• 首次设置：https://docs.openhands.dev/openhands/usage/agent-canvas/first-time-setup
• 故障排查：https://docs.openhands.dev/openhands/usage/agent-canvas/troubleshooting