OpenHands Agent Canvas 快速上手自托管 AI 编程代理的控制台【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一个自托管的开发者控制台把 OpenHands、Claude Code、Codex 等 AI 编程代理统一到同一个 Web 界面并让重复任务变成定时或事件触发的自动化。它解决的核心问题是代理散落在不同机器上、日常任务靠人盯。用同一个界面调度多个编程代理场景是典型的团队在服务器上共享一个做代码评审的代理开发者自己又在笔记本上跑日常开发代理两者要来回切换。Agent Canvas 支持注册多个代理后端——本地进程、Docker 容器、云端虚拟机或 OpenHands Cloud并允许在界面里直接切换。切换后会停留在同一功能页、自动对齐到新后端的数据不会残留旧后端的会话。如何验证在后端管理里添加两个后端例如本地和 Docker 各一个来回切换确认会话列表、状态和错误提示分别对应各自后端。把重复工作交给自动化流水线场景是每次有新 PR 都要做代码审查每天早上要有一份总结推送到 Slack。这类任务交给自动化最划算。Automate 板块提供仪表盘和模板库两类入口。模板库里有GitHub Code Review AgentSlack channel monitor这类现成工作流点击后打开预填好的对话补全配置即可上线。每个自动化都可以定义触发方式定时计划或事件如 PR 打开事件、过滤条件、通知目标和使用的 LLM profile。仪表盘汇总展示每个自动化的运行次数、近期成功率和平均耗时出问题的条目会标进Needs attention。如何验证打开一个模板查看它的触发器与过滤配置点Run now手动跑一次然后确认生成的会话出现在侧边栏、仪表盘计数增加。用技能目录约束代理行为场景是你希望代理遵守团队的编码约定但不想把长段指令复制进每个会话。Customize 下的 Skills 页是一个技能目录支持按名称、分类、触发词检索可以逐条启用或禁用也能关闭默认技能集。被禁用的技能不会加载进代理上下文这意味着你可以按项目控制代理知道什么。如何验证启用一个技能开新会话下发相关任务观察代理是否按该技能的描述行事禁用后再试一次做对照。快速上手与验证环境要求按安装路线二选一路线前置条件npm 直接安装Node.js 22.12 与 uvDocker 沙箱Docker Engine/Docker Desktop以及一个用于挂载项目的本地目录最小安装npm无沙箱代理可直接访问宿主机文件系统npm install -g openhands/agent-canvas agent-canvasDocker 沙箱路线先创建项目目录与 ~/.openhands 目录再运行docker run -it --rm -p 8000:8000 \ -v $HOME/.openhands:/home/openhands/.openhands \ -v $HOME/projects:/projects \ ghcr.io/openhands/agent-canvas:1.15.0如果要从源码运行克隆仓库后依次执行npm install和npm run devgit 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 API key开一个新会话发送一个小任务事件流实时滚动说明 Agent Server 已连通若装了自动化后端打开 Automate 仪表盘健康状态和运行历史有数据即整条链路就绪。常见坑无沙箱模式下代理对宿主机文件系统拥有完整读写权限README 对此有明确警告。日常笔记本上使用建议走 Docker 沙箱或专用机器。Node 版本低于 22.12 或缺少 uv 会导致启动失败开发脚本检测到没有 uvx 时会直接退出并给出提示。用--public把服务暴露到网络前必须设置 LOCAL_BACKEND_API_KEY 并收紧防火墙否则任何拿到地址的人都能驱动你的代理。边界与局限这个仓库本身只是控制台前端与本地栈编排在这里代理的执行逻辑在 software-agent-sdk 仓库定时与事件调度在 automation 仓库改代理行为或 API 需要去对应仓库。它不提供沙箱与隔离能力也不托管 LLM 密钥隔离程度完全取决于你选择哪种后端。项目当前处于 beta 阶段云端选项为商业服务它适合个人开发者或小团队自托管一到数个代理的场景不适合当作完整 IDE 的替代品也不是多租户托管平台。延伸资源跑通之后建议顺着官方文档把自托管安全加固和 ACP 外部代理的接入补上。官方文档索引docs/README.md自托管与加固指南docs/SELF_HOSTING.md架构说明docs/architecture.mdACP 代理 Docker 示例examples/acp-docker/【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考