如何 3 分钟本地部署 OpenHands Agent Canvas：AI 编程代理的可视化控制中心

如何 3 分钟本地部署 OpenHands Agent CanvasAI 编程代理的可视化控制中心【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHandsAgent Canvas是一个可自托管的 AI 编程代理控制中心你在浏览器里用自然语言指挥 OpenHands、Claude Code、Codex 等编码代理让它读写文件、跑命令、开 PR并把重复性工作排成定时或事件触发的自动化。适合想在自己电脑、Docker 或服务器上跑编码代理、又不想手写脚本串联 LLM 的开发者。先搞清楚它是什么再决定装在哪Agent Canvas 本身不直接执行代码它是一个前端控制台 本地编排器真正干活的是后端的 Agent Server。这个分离设计带来一个关键好处同一套界面可以切换多个后端——笔记本上跑个人代理团队共享一台服务器上的代理做代码审查互不干扰。它解决的核心问题有三类对话式干活新建会话描述任务代理自动执行命令、改文件、看结果自动化按时间表或 webhook 事件触发任务比如 PR 打开时自动审查、每晚做安全扫描扩展能力给代理装技能Skills、MCP 服务器和插件按需增强Agent Canvas 的自动化仪表盘每个任务的触发源、最近运行状态和成功率一目了然选一条安装路线npm、Docker 还是源码当前发布版本为 1.15.0。三条路线的差异如下按需取一条即可路线隔离性前置要求适合谁npm 全局安装无沙箱代理直接访问本机文件系统Node.js ≥ 22.12、uv最快上手信任本机环境Docker 沙箱有代理只看到挂载的目录Docker Desktop 或 Docker Engine想要隔离、生产更稳妥从源码构建无沙箱Node.js ≥ 22.12、npm、uv要改前端或跟进开发版两条提醒npm 和源码路线下代理对主机有完全访问权限官方 README 里明确打了警告建议先在小项目目录上试Docker 路线则要求你先建好项目目录PROJECTS_PATH代理只能看到挂载进去的文件夹。3 步跑通本地部署第 1 步安装并启动。最省事的是 npm 路线两条命令npm install -g openhands/agent-canvas agent-canvasagent-canvas默认拉起完整本地栈Agent Server、自动化后端和前端。如果你要前后端分离跑可以用agent-canvas --frontend-only或--backend-only分别启动。选 Docker 的话一条docker run即可镜像自带全部服务export PROJECTS_PATH$HOME/projects mkdir -p $PROJECTS_PATH docker run -it --rm -p 8000:8000 \ -v $HOME/.openhands:/home/openhands/.openhands \ -v ${PROJECTS_PATH}:/projects \ ghcr.io/openhands/agent-canvas:1.15.0第 2 步打开界面。npm/源码路线访问http://localhost:8000Docker 路线访问http://localhost:8000/canvas。第 3 步配置 LLM。左侧Getting started引导清单会提示你先添加 LLM API Key这是跑通对话的前置条件。支持自带模型BYO model在设置里建一个 LLM Profile 填入密钥即可。✅成功标志界面左下角出现 Local 后端徽标且状态点为绿色Getting started 中前几项打勾。看到这些说明本地栈已经就绪。第一次对话让代理干一件小事点击 New Chat选一个会话直接输入任务比如给这个项目补一个 README列出安装步骤。代理会自主决定执行哪些命令、编辑哪些文件你在事件流里能看到每一步的输入输出和文件 diff。跑通第一个任务后建议顺手做两件事在Customize → Skills里浏览技能库59 个开箱即用的技能按分类筛选、逐个启用技能只对新会话生效在Customize → MCP Servers / Plugins里接入你日常工具Customize 面板下的 Skills 页面按分类筛选并启用/禁用技能改动只影响新会话从对话到自动化给代理排上定时任务这是 Agent Canvas 和普通聊天式编码工具的分水岭。进入Automate菜单你可以Add Automation写一段 Prompt 描述任务再指定触发方式——按时间表如每晚 03:30、按事件如pull_request_openedwebhook或两者加过滤条件Import automation / Templates导入现成的自动化模板Dashboard看所有任务的运行次数、成功率、平均耗时失败的任务会标红提醒一个典型配置是PR Review on Open仓库有新 PR 时自动触发代码审查把结论以行内评论发回LLM Profile 指定用哪个模型执行。自动化详情页Prompt、触发事件、过滤条件和 LLM Profile 都在一个页面里管理想暴露给团队或公网使用时参考自托管指南 docs/SELF_HOSTING.md核心是用LOCAL_BACKEND_API_KEY开启 public 模式所有 API 调用必须携带密钥头UI 首次访问时也要粘贴密钥才能操作。常见部署问题排查端口 8000 被占用ingress 代理默认监听 127.0.0.1:8000先用lsof -i :8000排查占用Docker 容器里看不到项目确认PROJECTS_PATH目录在docker run之前就已存在且挂载路径拼写一致会话一直连不上前端连不上 Agent Server 时检查终端日志里 18000 端口是否真正起来uv未安装会导致 Agent Server 启动失败Windows 用户README 提供了 PowerShell 版本的命令见 README.windows.md架构细节可看 docs/architecture.md多仓库分工SDK、TypeScript 客户端、自动化服务各归各仓在 docs/DEVELOPMENT.md 里有说明。下一步行动清单用 npm 路线把本地栈跑起来完成 Getting started 引导清单建一个 LLM Profile跑通第一个对话任务启用 3 个与你工作流匹配的技能观察新会话行为变化创建第一个自动化给某个仓库加push 后自动更新 CHANGELOG 的定时任务需要 7x24 运行时按 docs/SELF_HOSTING.md 把栈迁到一台 VM 并配置 API Key【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考