ghcr.io/openhands/runtime:8c0a12e-nikolaik-arm64

OpenHands Agent Canvas

面向编码代理和自动化的自托管开发者控制中心。

跨本地、远程和云后端运行OpenHands、Claude Code、Codex、Gemini或任何ACP兼容代理。

快速入门 | 文档 | 自托管 | ACP代理 | 自动化 | Slack

OpenHands Agent Canvas将您的编码代理转变为自托管、始终在线的工程团队。它是一个开发者控制中心，用于发起对话和自动化日常任务——例如生成发布到Slack的报告，或自动将GitHub问题分解为任务。

默认情况下，它在您的本地机器上运行，但可以连接到多个“代理后端”，例如在Docker容器、虚拟机或公司基础设施中运行代理。您可以选择在OpenHands Cloud或OpenHands Enterprise基础设施上运行代理。

Agent Canvas开箱即运行开源的OpenHands代理，也可使用任何第三方代理，如Claude Code和Codex。

如有问题或反馈，请提交GitHub issue或加入Slack中的#proj-agent-canvas频道。

[!NOTE]

OpenHands Agent和Agent Server的源代码位于https://github.com/OpenHands/software-agent-sdk%E3%80%82

Agent Canvas的源代码位于https://github.com/OpenHands/agent-canvas%E3%80%82

快速入门

您可以安装OpenHands在任何机器上运行代理：笔记本电脑、Mac Mini等专用计算机，或云服务器。

运行OpenHands最强大的方式是在云服务器上。这使您的代理即使在笔记本电脑关闭时也能继续运行，并更容易通过Slack、GitHub和Datadog等第三方服务触发代理。有关详细信息，特别是安全强化方面，请参见SELF_HOSTING.md。

值得注意的是，您可以在多个不同环境中运行后端，并从同一个Agent Canvas前端在这些环境之间切换。例如，您可以与团队共享一个Agent Server，用于执行代码审查和依赖项更新的代理，然后在您的笔记本电脑上运行个人代理。

选项1：无沙箱

[!WARNING] 此方式直接在您安装的机器上运行agent-server——代理将拥有对您文件系统的完全访问权限！

前提条件：Node.js 22.12.x或更高版本、uv

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

agent-canvas命令默认启动完整的本地堆栈。当您想单独运行各个部分时，也可以拆分：

agent-canvas --frontend-only # 仅静态前端 + 入口
agent-canvas --backend-only # 仅代理服务器 + 自动化后端 + 入口

选项2：使用Docker沙箱

前提条件：

• Docker：macOS/Windows上的Docker Desktop，或Linux上的Docker Engine/Docker Desktop。
• 用于PROJECTS_PATH的主机目录，包含您希望代理访问的项目文件夹。启动容器前请创建此目录。

macOS / Linux:

export PROJECTS_PATH="$HOME/projects" # 包含您项目文件夹的目录
mkdir -p "$PROJECTS_PATH" "$HOME/.openhands"

docker run -it --rm \
-p 8000:8000 \
-v "$HOME/.openhands:/home/openhands/.openhands" \
-v "${PROJECTS_PATH}:/projects" \
ghcr.io/openhands/agent-canvas:1.0.0-rc.11

Windows (PowerShell / Windows终端): 有关等效命令，请参见https://github.com/OpenHands/agent-canvas/blob/main/README.windows.md%E3%80%82

代理将能够访问PROJECTS_PATH下的任何项目。

选项3：从源代码运行

[!WARNING] 此方式直接在您安装的机器上运行agent-server——代理将拥有对您文件系统的完全访问权限！

前提条件：Node.js 22.12.x或更高版本、npm、uv（用于通过uvx运行代理服务器）

git clone https://github.com/OpenHands/agent-canvas.git
cd agent-canvas
npm install
npm run dev

---

通过http://localhost:8000%E8%AE%BF%E9%97%AEUI%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E7%9B%B4%E6%8E%A5%E4%BB%8EUI%E6%B7%BB%E5%8A%A0%E5%85%B6%E4%BB%96%E5%90%8E%E7%AB%AF%E3%80%82

架构

Agent Canvas由https://github.com/OpenHands/software-agent-sdk/tree/main/openhands-agent-server/openhands/agent_server%E6%8F%90%E4%BE%9B%E6%94%AF%E6%8C%81%EF%BC%8C%E8%BF%99%E6%98%AF%E4%B8%80%E4%B8%AA%E7%94%A8%E4%BA%8E%E5%9C%A8%E5%8D%95%E5%8F%B0%E6%9C%BA%E5%99%A8%E4%B8%8A%E8%BF%90%E8%A1%8C%E5%A4%9A%E4%B8%AA%E4%BB%A3%E7%90%86%E7%9A%84REST API。每个Agent Server在单个主机/端口上运行；Agent Canvas可以连接到多个Agent Server并轻松在它们之间切换。

您可以在任何地方运行Agent Server：

• 直接在您的笔记本电脑上（请注意！）
• 在Mac Mini等专用机器上
• 在云中的虚拟机上
• 在OpenHands Cloud（我们的商业产品）中

Agent Server通常与https://github.com/OpenHands/automation%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%8C%E5%90%8E%E8%80%85%E5%85%81%E8%AE%B8%E6%82%A8%E8%AE%BE%E7%BD%AE%E6%8C%89%E8%AE%A1%E5%88%92%E8%BF%90%E8%A1%8C%E6%88%96%E5%93%8D%E5%BA%94%E4%BA%8B%E4%BB%B6%E7%9A%84%E4%BB%A3%E7%90%86%E3%80%82

更多文档

• 文档索引
• 架构概述
• 开发指南
• 自托管指南