三步自建AI编码代理控制台OpenHands Agent Canvas 实操指南【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands你已经有一个会写代码的 AI 编程助手但每次开工都要手动开终端、贴上下文、盯着结果它没法过夜运行不能被事件触发更难跟同事共享。OpenHands Agent Canvas 是一个自托管的编码代理控制中心同一个界面里开对话、切换代理、部署定时和 webhook 触发的自动化。 先说结论它能替你干什么一条命令起完整本地栈前端、Agent Server、自动化后端全部拉起浏览器打开即用。代理不绑定自带 OpenHands 开箱可跑也能换成 Claude Code、Codex、Gemini CLI 等任意 ACP 兼容代理。做之前每个代理各开一个终端手动跑只能人肉盯结果做之后对话、定时任务、事件触发集中在同一面板合上笔记本它继续跑。 从零跑起来环境要求检查清单Node.js ≥ 22.12 和uv仅 npm 安装、源码方式需要Docker Desktop 或 Docker EngineDocker 沙箱方式需要一个已建好、可供代理访问的项目目录本机 8000 端口未被占用方式一npm 全局安装npm install -g openhands/agent-canvas agent-canvas第一条命令装agent-canvas命令行工具第二条直接启动完整本地栈。注意这种方式让 Agent Server 直接跑在主机上代理对文件系统有完整权限只适合可信机器。方式二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.0这一步只把PROJECTS_PATH挂进容器代理只能看到里面的项目.openhands目录放配置和凭据。方式三从源码部署git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev前三行拿代码、装依赖npm run dev一并拉起 Agent Server、前端开发服务器和 ingress 代理。启动后浏览器打开http://localhost:8000Docker 模式下是http://localhost:8000/canvas。界面里可以直接添加更多后端接入远程或云端的 Agent Server服务器部署与安全加固细节见 docs/ 里的 SELF_HOSTING.md。 跟它做一个真实任务给新 PR 自动做代码审查你下指令。打开 Templates 页点进 GitHub Code Review Agent它内置了验证过的审查提示词、实现草案和连接 GitHub 需要的 MCP也可以直接开一段对话说盯着 frontend-app 仓库新 PR 出现时读一下 diff把审查意见留在评论里改动涉及数据库 schema 的单独标出来。它执行什么。GitHub webhook 到达后自动化后端拉起一段新对话代理拉取完整 PR 和仓库上下文逐块检查改动把结论写回 PR 评论区。你得到什么。PR 上留下一条结构化审查评论自动化仪表盘里能看到这个任务的运行次数、近期成功率和平均耗时失败会被标记为需要关注。 让它更好用的三个习惯把沙箱模式当默认。本地模式下代理对主机文件系统有完整权限笔记本或共用机器上就走 Docker 方式只挂载必要的项目目录代理就碰不到机器上的其他东西。先选模板再自己写自动化。模板库里的每个模板打包了提示词、实现草案和所需 MCP选中后拉起一段预填好的对话你只需补细节。适合 PR 审查、仓库监控、Slack 摘要这类常见任务。用技能约束代理行为。Customize 页可以按触发器或分类搜索、安装技能禁用的技能不会进入代理上下文。适合统一团队规范比如审查评论的写法、安全扫描的检查项。⚠️ 新手最容易踩的坑现象启动后界面里没有可用后端。原因Node 版本低于 22.12 或缺uvAgent Server 没起来。解法node -v检查版本装好 uv或直接改走 Docker 方式。现象本地模式下代理动了项目外的文件。原因无沙箱时 Agent Server 直接跑在主机上文件系统全量可见。解法改用 Docker 沙箱重建只挂PROJECTS_PATH把可访问范围锁死。现象配了 API keyACP 代理仍提示认证失败。原因提供商 CLI 的订阅登录优先于 API key机器上已登录时 key 字段被忽略。解法先用codex login status这类命令确认 CLI 登录状态确定要用 key 就先清掉已有登录。现象端口 8000 被占用。原因npm 安装实例和 Docker 实例默认都占 8000。解法改-p端口映射或停掉其中一个实例。⚖️ 适合谁什么时候别硬用适合你每天跑编码代理希望合上笔记本后任务继续团队里多人共用一个 Agent Server 做代码审查和依赖更新你要求代理和数据都留在自己的基础设施里。别硬用只是偶尔问一两句话直接开对应代理的 CLI 即可不必多这一层你需要零运维的全托管服务——这是自托管组件机器得自己管没有能长期开机的机器——定时和 webhook 自动化需要一台随时可达的机器来触发。 接下来可以去看docs/架构说明、自托管指南、ACP 代理接入文档examples/ACP 代理 Docker 环境示例specs/后端管理、MCP 设置等设计规格Agent Canvas 是多仓库体系里的前端真正干活的是 Agent Server 和 Automation Server分清这个边界部署和切换的问题大半就清楚了。建议从 Docker 沙箱方式起步先让一个 PR 审查自动化跑起来再决定要不要往云端迁。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 三步自建AI编码代理控制台：OpenHands Agent Canvas 实操指南
三步自建AI编码代理控制台OpenHands Agent Canvas 实操指南【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands你已经有一个会写代码的 AI 编程助手但每次开工都要手动开终端、贴上下文、盯着结果它没法过夜运行不能被事件触发更难跟同事共享。OpenHands Agent Canvas 是一个自托管的编码代理控制中心同一个界面里开对话、切换代理、部署定时和 webhook 触发的自动化。 先说结论它能替你干什么一条命令起完整本地栈前端、Agent Server、自动化后端全部拉起浏览器打开即用。代理不绑定自带 OpenHands 开箱可跑也能换成 Claude Code、Codex、Gemini CLI 等任意 ACP 兼容代理。做之前每个代理各开一个终端手动跑只能人肉盯结果做之后对话、定时任务、事件触发集中在同一面板合上笔记本它继续跑。 从零跑起来环境要求检查清单Node.js ≥ 22.12 和uv仅 npm 安装、源码方式需要Docker Desktop 或 Docker EngineDocker 沙箱方式需要一个已建好、可供代理访问的项目目录本机 8000 端口未被占用方式一npm 全局安装npm install -g openhands/agent-canvas agent-canvas第一条命令装agent-canvas命令行工具第二条直接启动完整本地栈。注意这种方式让 Agent Server 直接跑在主机上代理对文件系统有完整权限只适合可信机器。方式二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.0这一步只把PROJECTS_PATH挂进容器代理只能看到里面的项目.openhands目录放配置和凭据。方式三从源码部署git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands npm install npm run dev前三行拿代码、装依赖npm run dev一并拉起 Agent Server、前端开发服务器和 ingress 代理。启动后浏览器打开http://localhost:8000Docker 模式下是http://localhost:8000/canvas。界面里可以直接添加更多后端接入远程或云端的 Agent Server服务器部署与安全加固细节见 docs/ 里的 SELF_HOSTING.md。 跟它做一个真实任务给新 PR 自动做代码审查你下指令。打开 Templates 页点进 GitHub Code Review Agent它内置了验证过的审查提示词、实现草案和连接 GitHub 需要的 MCP也可以直接开一段对话说盯着 frontend-app 仓库新 PR 出现时读一下 diff把审查意见留在评论里改动涉及数据库 schema 的单独标出来。它执行什么。GitHub webhook 到达后自动化后端拉起一段新对话代理拉取完整 PR 和仓库上下文逐块检查改动把结论写回 PR 评论区。你得到什么。PR 上留下一条结构化审查评论自动化仪表盘里能看到这个任务的运行次数、近期成功率和平均耗时失败会被标记为需要关注。 让它更好用的三个习惯把沙箱模式当默认。本地模式下代理对主机文件系统有完整权限笔记本或共用机器上就走 Docker 方式只挂载必要的项目目录代理就碰不到机器上的其他东西。先选模板再自己写自动化。模板库里的每个模板打包了提示词、实现草案和所需 MCP选中后拉起一段预填好的对话你只需补细节。适合 PR 审查、仓库监控、Slack 摘要这类常见任务。用技能约束代理行为。Customize 页可以按触发器或分类搜索、安装技能禁用的技能不会进入代理上下文。适合统一团队规范比如审查评论的写法、安全扫描的检查项。⚠️ 新手最容易踩的坑现象启动后界面里没有可用后端。原因Node 版本低于 22.12 或缺uvAgent Server 没起来。解法node -v检查版本装好 uv或直接改走 Docker 方式。现象本地模式下代理动了项目外的文件。原因无沙箱时 Agent Server 直接跑在主机上文件系统全量可见。解法改用 Docker 沙箱重建只挂PROJECTS_PATH把可访问范围锁死。现象配了 API keyACP 代理仍提示认证失败。原因提供商 CLI 的订阅登录优先于 API key机器上已登录时 key 字段被忽略。解法先用codex login status这类命令确认 CLI 登录状态确定要用 key 就先清掉已有登录。现象端口 8000 被占用。原因npm 安装实例和 Docker 实例默认都占 8000。解法改-p端口映射或停掉其中一个实例。⚖️ 适合谁什么时候别硬用适合你每天跑编码代理希望合上笔记本后任务继续团队里多人共用一个 Agent Server 做代码审查和依赖更新你要求代理和数据都留在自己的基础设施里。别硬用只是偶尔问一两句话直接开对应代理的 CLI 即可不必多这一层你需要零运维的全托管服务——这是自托管组件机器得自己管没有能长期开机的机器——定时和 webhook 自动化需要一台随时可达的机器来触发。 接下来可以去看docs/架构说明、自托管指南、ACP 代理接入文档examples/ACP 代理 Docker 环境示例specs/后端管理、MCP 设置等设计规格Agent Canvas 是多仓库体系里的前端真正干活的是 Agent Server 和 Automation Server分清这个边界部署和切换的问题大半就清楚了。建议从 Docker 沙箱方式起步先让一个 PR 审查自动化跑起来再决定要不要往云端迁。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考