让 AI 替你值班：OpenHands Agent Canvas 完整部署与自动化配置全解

让 AI 替你值班OpenHands Agent Canvas 完整部署与自动化配置全解【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands 是一个可以自部署的 AI 编程代理控制台正式名称叫 Agent Canvas。它装在你自己的电脑或服务器里把 OpenHands、Claude Code、Codex、Gemini 这些编码代理统一管理起来聊天式改代码、按定时任务跑依赖升级、在新 PR 提交时自动做代码评审。和云端 SaaS 不同的是它跑在你掌控的硬件上代理有权限访问哪些目录、连哪个模型全部由你说了算。这篇分享来自我在一台 Mac 上实际部署的体验目标是让你从零到第一个自动化任务跑起来全程不超过 10 分钟。先搞清楚它能干什么OpenHands 的定位不是又一个聊天框而是一个代理调度中枢。它的价值主要体现在三块多代理统一管理开源的 OpenHands 代理开箱即用同时支持任何符合 ACPAgent-Client Protocol代理客户端协议的第三方代理比如 Claude Code 和 Codex可以在同一个界面里来回切换。多后端灵活部署代理可以跑在你笔记本上、Docker 容器里、一台云服务器比如 Mac Mini 或 VM上甚至 OpenHands 官方云。同一个前端可以同时接多个后端——公司共享一台服务器做代码评审自己笔记本上跑个人代理互不干扰。自动化工作流这是它最值钱的部分。定时任务、Webhook 事件触发、对接 Slack / GitHub / Linear 都是原生能力比如每晚扫描安全漏洞、每次 push 自动生成 changelog。上面这张就是自动化仪表盘每个自动化任务的健康状态、运行次数、成功率、平均耗时一目了然还能手动点Run now触发一次。三种启动方式选最适合你的部署前只需要确认一件事你想让代理接触你机器的哪些文件。这决定了走哪条路。方式一npm 全局安装最快但无沙箱前提是需要 Node.js 22.12 和 uv。两条命令npm install -g openhands/agent-canvas # 全局安装 agent-canvas # 启动完整本地栈注意这种方式代理服务器直接跑在你本机上代理对你的文件系统有完全访问权限。只在信任环境使用。也可以拆开启动agent-canvas --frontend-only或--backend-only。方式二Docker 沙箱推荐隔离最省心代理被关进容器只能通过挂载的目录访问你指定的项目文件夹是日常使用最稳妥的选择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.15.0PROJECTS_PATH目录必须在容器启动前创建好否则挂载会失效——这是新手最常踩的第一个坑。方式三从源码跑适合想改前端或跟进开发git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev启动后浏览器访问 http://localhost:8000 即可Docker 方式的路径是 http://localhost:8000/canvas后端也可以在界面里随时追加。打开界面后先做这三件事左下角有个 Getting started 清单按顺序走完就能开始干活添加 LLM 配置OpenHands 支持自带任何模型BYOK 思路在 Customize 区域填好 API key 并选择模型。没有 key 之前代理无法对话这一步卡住的人最多。确认后端连接左下角显示当前后端如 Local backend, localhost:5199状态点是绿色的就是通了。挑一个会话开始聊天直接输入自然语言指令即可代理会生成代码、跑命令、把结果贴回对话里。把重复劳动交给自动化模板聊天解决一次性任务真正拉开效率差距的是 Automate 模块。点进 Templates 页面OpenHands 提供了一批现成配方GitHub 代码评审代理、GitHub 仓库监控盯着 issue 和 PR 里的 OpenHands 提及、Slack 频道监听还有一批 Beta 模板如 Slack 每日摘要、Linear 工单分诊。点开任意模板比如GitHub Code Review Agent就是预填好的配置确认细节后启动即可。以新 PR 自动评审这个自动化为例详情页里能看到完整链路Prompt评审聚焦正确性、安全性和性能结果以行内评论形式发回 PRTriggerGitHub 的pull_request_opened事件触发并用 Filter 表达式限定只处理指定仓库LLM profile指定用哪个模型跑示例里用的是 review-fast说明评审类任务可以挂一个更快更便宜的模型Notification结果通过 GitHub 评论回传。也就是说谁在什么时候、用什么模型、处理什么事件全部显式可配出问题时看 Activity 里的 Last run 就能定位。给代理装技能Skills 市场Customize → Skills 页面内置了 59 个可安装的技能skill每个技能本质上是给代理注入的一段结构化提示词和工作流例如add-javadoc给 Java 类补文档、agent-memory把代码库的关键信息持久化到 AGENTS.md 文件里、code-review严格模式代码审查。左侧筛选器支持按状态Enabled/Disabled、推荐度和分类自动化配方、环境工具、CI、写作文档等过滤。技能变更后对新会话生效已开启的旧会话不受影响——调完技能想立刻验证记得开个新聊天。容易踩的坑与排障建议无沙箱模式的权限边界npm/源码方式下代理能碰你整台机器的文件。如果这台机器上有敏感数据强烈建议走 Docker 方式或者干脆把后端放到一台独立服务器上。端口冲突本地栈默认占用 8000 端口Docker 沙箱内部代理服务器在 5199 端口起多个实例时留意区分。Windows 用户PowerShell 下的挂载和路径写法有差异直接看仓库里的 README.windows.md。想长期跑在云服务器上官方有一份面向自托管的安全加固指南覆盖了反向代理、认证和持久化等细节见 docs/SELF_HOSTING.md。想接入第三方代理Claude Code、Codex、Gemini CLI 的接入步骤写在 docs/ACP_AGENTS.md系统各模块的边界划分可参考 docs/architecture.md。写在最后部署只是起点真正值得花时间的是想清楚你手头哪些事是规则明确、重复发生的——依赖升级、issue 分诊、每周安全扫描这些都是自动化模板最对口的场景。建议先从一个模板开始跑起来把触发条件、模型、通知渠道调顺了再逐步加自己的定制自动化。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考