OpenHands Agent Canvas 快速上手如何自托管一个 AI 编程智能体控制中心【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一个可自托管的 AI 编程智能体控制中心让你在浏览器里运行和管理 OpenHands、Claude Code、Codex 等智能体并让它们按定时或事件自动跑任务适合想在自己的环境里管住 AI 助手的开发者。值不值得用先给结论如果你已经在用某个编程智能体希望它 7x24 在线、浏览器可访问、还能定时自动干活Agent Canvas 是少数能完全自托管且兼容多智能体的方案。它的限制同样明确——智能体运行在你部署的机器上对这台机器的文件有完整读写权限不适合随便找个机器跑一跑的用法。维度快速判断核心能力统一浏览器入口对话、文件、终端、浏览器视图与定时自动化适合谁需要自托管、想用一个入口管多个编程智能体的开发者和小团队不适合谁只想在云端用单一智能体聊天的用户部署成本更高硬性前提一台可信、可长期在线的机器智能体可读写其文件核心功能拆解用同一个入口驱动不同的编程智能体它解决的是智能体锁定问题。默认使用开源的 OpenHands 智能体但也可以通过 ACP 协议驱动 Claude Code、Codex、Gemini CLI甚至任意自定义 ACP 服务器。你在 Settings → Agent 里切换即可正在进行的对话保持原智能体新对话自动使用新选择。想象一下这个画面你同时用 Claude Code 的订阅和开源 OpenHands 做不同项目的活打开设置页切换下拉框新对话就换到另一个大脑上工作。凭据存在 Secrets 面板里智能体进程启动时自动注入本地后端还会直接复用你已登录的 CLI 会话通常不用额外填 API key。这部分机制在 docs/ACP_AGENTS.md 里讲得很细。自动化仪表盘让智能体自己排班最值得看的是 Automate 面板。Dashboard 里每个自动化任务都带触发条件定时、PR 打开、git push、webhook 等和运行统计次数、成功率、平均耗时。你给它排两个班每晚凌晨扫描后端仓库的安全漏洞每次 push 自动生成发布笔记。第二天早上打开面板看一眼最近一次运行和成功率任务跑得对不对一目了然不用自己再搭 cron 或 webhook 服务。多台后端一个面板单台机器扛不住或者你想把个人机器和团队机器分开Agent Canvas 可以连接多个 Agent Server在 UI 里随时切换。常见组合是笔记本上跑个人智能体一台 Mac Mini 或云 VM 跑团队共用的代码审查智能体。远程机器怎么搭、防火墙怎么锁、API key 怎么发docs/SELF_HOSTING.md 给出了完整的自托管安全加固步骤包括 nginx TLS 配置。技能、MCP 与插件能力上限在这里Customize → Skills 面板列出了数十个公开技能按类别和启用状态过滤点卡片查看提示词和安装流程启用或停用后对新对话生效。同一层级还有 MCP Servers 和 Plugins 两个入口。想把给 Java 类补 javadoc从仓库 URL 导入技能这类固定动作变成智能体的标准能力就在这里装。5 分钟跑起来环境要求Node.js 22.12.x 或更高加 npmuv运行 agent-server 的 Python 工具链Docker可选用于沙箱模式一个 LLM API key或 ACP 智能体侧已有的登录无沙箱模式的最短启动方式npm install -g openhands/agent-canvas agent-canvas首个验证点浏览器打开http://localhost:8000Docker 镜像的地址是http://localhost:8000/canvas走完引导流程——配置 LLM key 或选择 ACP 智能体再发出第一句对话。页面能加载、智能体能回复就算成功。新手容易踩的坑⚠️ 无沙箱模式没有隔离agent-server 直接跑在宿主机上智能体可读写任意文件。不放心就改用 README 里的 Docker 模式通过PROJECTS_PATH把项目目录挂进容器。Docker 模式要提前创建PROJECTS_PATH指向的目录并挂载否则智能体找不到你的代码。源码模式跑在 NFS 主目录或某些 devcontainer 里会因不支持 Unix 套接字启动失败设置TMUX_TMPDIR/tmp即可绕开。进阶玩法与能力边界几个值得记住的调优参数参数作用PORTingress 端口默认 8000OH_AGENT_SERVER_VERSION固定 agent-server 版本避免跟着 PyPI 最新版走TMUX_TMPDIR家目录不支持 Unix 域套接字时指向/tmp进阶方向有三个一是把智能体跑进容器做隔离examples/acp-docker/ 给了现成的 compose 配置Claude Code/Codex 在容器里运行、凭据从 UI 传入二是自托管到公开网络按 SELF_HOSTING 文档做防火墙、LOCAL_BACKEND_API_KEY和--public模式三层防护三是前后端分离部署agent-canvas --frontend-only和--backend-only可以拆开跑。边界也要说清楚这个仓库只有前端和本地编排。智能体行为、工具、服务端 API 在 sibling 仓库 software-agent-sdk 里想改智能体怎么写代码改这里没用。定时和事件触发依赖 automation 后端最小模式npm run dev:minimal下没有这个能力。智能体能力受限于运行它的机器本地模式无沙箱不加固不要直接暴露公网。下一步如果你的需求是自托管、7x24 在线、多智能体统一管理Agent Canvas 基本是现成答案如果只是想和单一智能体聊聊天云端产品更轻。更多材料见文档索引 docs/、自托管指南 docs/SELF_HOSTING.md、ACP 智能体说明 docs/ACP_AGENTS.md 和 Docker 示例 examples/acp-docker/。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考