OpenHands Agent Canvas：一条命令自托管你的 AI 编程代理工作台

OpenHands Agent Canvas一条命令自托管你的 AI 编程代理工作台【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一个自托管的编程代理控制中枢让开发者在一块画布上启动、切换和自动化 OpenHands、Claude Code、Codex 等 ACP 兼容代理适合想私有化运行 AI 编码助手的开发者和小团队。 快速认识OpenHands 能替你跑哪些活本地开箱即用一条命令启动前端、Agent Server、自动化后端浏览器访问 8000 端口多后端切换本机、Docker 沙箱、VM、云同一界面来回切自带开源 OpenHands 代理也支持接入任意 ACP 兼容代理自动化任务定时或 webhook 触发结果可推送到 Slack、GitHub 等️ 上手实操完成一个真实任务任务一让代理改一个项目的代码。在界面里新建会话用自然语言描述需求比如给 /projects 下的 demo 项目补上 README 和 CI 配置。代理在选定的后端环境里执行命令、编辑文件改动过程在事件流里逐条可见你可以在左侧切换会话、打开文件面板核对结果。任务二让工作自动跑。进入 Automations 创建任务选择触发方式定时或 webhook绑定要执行的操作。到点后代理自动运行一轮运行历史保留在界面上可直接查看每次的执行记录。 最短部署路径Docker 一行启动 Agent Canvas最短路径是用官方镜像起容器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.15.0 # 挂载配置与项目后启动完整栈然后访问 http://localhost:8000/canvas镜像版前端挂在 8000 端口的/canvas路径下。若走 npm 或源码方式启动则直接访问 http://localhost:8000。⚙️ 三个值得调整的点配置 LOCAL_BACKEND_API_KEY 开启公开访问保护把LOCAL_BACKEND_API_KEY设为随机密钥openssl rand -base64 32再用npx openhands/agent-canvas --public启动。所有/api/*请求必须携带该 Key未授权的人打不开界面里的代理。配置 LLM Profile 指定模型和密钥OpenHands 开箱可用但你可以在设置里保存 LLM Profile指定供应商、模型名和 API Key接入任意兼容的 LLM不被默认值限制。规划 PROJECTS_PATH 控制代理的文件边界容器里/projects的内容由PROJECTS_PATH决定代理只能看到这个目录下的项目。多仓库场景建议挂载一个父目录少挂载少暴露。⚠️ 避坑指南部署前必看的三个坑错误本机直接裸跑 Agent Server 当生产用 后果代理可读写宿主机整个文件系统并执行 shell 命令权限等于本地用户 正确做法生产或团队场景一律走 Docker 沙箱只挂载必要目录错误PROJECTS_PATH目录没建就启动容器 后果容器能起来但代理看不到任何项目任务全部落空 正确做法按上面步骤先mkdir -p再docker run错误Docker 启动后去访问 3000 端口 后果页面打不开误以为部署失败 正确做法访问 http://localhost:8000/canvas8000 才是入口端口更多细节看 docs/ 目录、自托管指南 和 架构说明下一步建议先用 Docker 沙箱在测试机上把一条自动化任务跑通再考虑上服务器。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考