OpenHands Agent Canvas从零跑通 AI 编码助手的完整实操指南【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一个自托管的 AI 编码智能体控制中心把 OpenHands、Claude Code、Codex 等编码智能体接入同一个 Web 界面让你在一处管理对话、后端和定时自动化。本文带你从环境检查走到第一次让智能体替你跑代码。为什么需要编码智能体的统一入口现在的编码智能体各带各的 CLI每开一个任务就要开新终端、粘贴同样的提示词关掉窗口上下文全丢。更麻烦的是智能体只能跑在你手边这台机器上合上笔记本任务就停了。OpenHands 给出的解法叫 Agent Canvas即它的自托管前端一台机器上跑 Agent Server多个智能体、多个后端、定时自动化全部通过浏览器操作。适合想把自己的智能体任务常驻到服务器上、或用统一入口管理多个编码智能体的人。架构一句话浏览器通过 REST API 说话Agent Server 在运行时里执行对话与工具细节可看docs/architecture.md。图 1首次启动后左侧面板显示 Getting started 待办清单Customize 下的 Skills 页用于给智能体添加能力最短路径上手三种启动方式怎么选环境要求很简单Node.js 22.12 以上Docker 方式只需要 Docker Desktop 或 Docker Engine4GB 以上空闲内存、5GB 以上磁盘首次启动要拉取一批依赖本地运行方式另需uv来启动 agent server从源码运行# 获取代码 git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands # 安装前端依赖 npm install # 启动完整本地栈agent server 自动化后端 前端 npm run dev选它是因为npm run dev一次拉起整套栈前端热更新试功能最方便。成功的样子终端里 Vite 就绪、agent server 监听在127.0.0.1:18000浏览器打开http://localhost:8000出现主界面。左下角的 Getting started 清单会引导你依次做三件事添加 LLM API key、开始第一次对话、安排一个定时任务。⚠️ 本地方式下智能体对整台机器的文件系统有读写权也能执行 shell 命令。敏感机器请改用 Docker 方式。用 Docker 起沙箱export PROJECTS_PATH$HOME/projects # 存放项目代码的目录 mkdir -p $PROJECTS_PATH $HOME/.openhands # 智能体只能看到挂载目录状态持久化到 ~/.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。智能体只能看到PROJECTS_PATH下的目录日常使用更稳妥。全局一键安装npm install -g openhands/agent-canvas agent-canvas # 启动完整本地栈三种方式的区别方式智能体可见范围适合场景源码 / 全局安装宿主机全部文件系统本地试玩、可信机器Docker 沙箱仅挂载的目录日常使用、隔离敏感文件远程 VM专用机器可长期运行常驻任务、外部 webhook 触发VM 方式还要处理防火墙与密钥访问见docs/SELF_HOSTING.md。跑起来之后三个高频用法让智能体写代码并执行在聊天框输入“创建一个 bash 脚本输出 Hello World 并运行它”。智能体先写出hello_world.sh再执行它并把运行输出回传到对话里。你只需核对三处命令以“已执行”的块呈现而不是单纯贴一段代码建议终端输出里包含预期结果工作区文件列表里出现了生成的脚本让它处理你自己的项目新建一个指向项目目录的会话Docker 方式下即PROJECTS_PATH里的某个目录输入“给 utils 模块补充单元测试”。智能体会读代码、改文件、在沙箱里跑测试你可以随时切回去看改动 diff。建一个定时自动化进入 Automate 区域Templates 里有现成模板也可以点 Add Automation 自己写。图 2仪表盘展示每个自动化的运行次数、近期成功率和平均耗时比如 “PR Review on Open” 在新 PR 打开时自动做代码评审“Nightly Security Pass” 每天凌晨扫描漏洞。想立刻看效果点 “Run now” 手动触发一次即可。图 3Templates 页提供开箱即用的自动化模板可复制修改后启用智能体行为不对时按顺序查LLM key 是否配置、会话是否指向了正确的目录、侧边栏后端状态是否为 Healthy。避坑与调优8000 端口被占用—— 原因别的进程占用了默认 ingress 端口。解法用PORT环境变量改口例如PORT8080 npm run dev再访问新端口。首次启动为什么这么慢—— 原因第一次npm run dev时uvx会从 PyPI 下载 agent server 及其 Python 依赖前端还要装 JS 依赖。解法等它跑完即可之后启动走缓存快得多。npm install 报版本错误—— 原因package.json要求 Node 22.12 以上你当前的 Node 偏旧。解法先升级 Node 再装依赖。要开放到局域网或公网怎么办—— 直接把 agent server 暴露出去任何能连上的人都能读写你的文件。解法部署到带防火墙的 VM用openssl rand -base64 32生成密钥并导出LOCAL_BACKEND_API_KEY再以--public启动UI 首次加载会要求输入密钥才能操作。智能体表现不够聪明或太贵—— 在 Customize 里切换 LLM profile复杂重构换强模型批量小脚本用便宜模型再配合 Skills 开关控制智能体加载的能力集。现在你手里有一个跑起来的 Agent Canvas智能体可以读写你工作区的代码并按你的指令执行命令。下一步试着把一件重复性工作——比如生成每日构建报告——做成定时自动化或者直接指向一个团队共享目录试试。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenHands Agent Canvas：从零跑通 AI 编码助手的完整实操指南
OpenHands Agent Canvas从零跑通 AI 编码助手的完整实操指南【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一个自托管的 AI 编码智能体控制中心把 OpenHands、Claude Code、Codex 等编码智能体接入同一个 Web 界面让你在一处管理对话、后端和定时自动化。本文带你从环境检查走到第一次让智能体替你跑代码。为什么需要编码智能体的统一入口现在的编码智能体各带各的 CLI每开一个任务就要开新终端、粘贴同样的提示词关掉窗口上下文全丢。更麻烦的是智能体只能跑在你手边这台机器上合上笔记本任务就停了。OpenHands 给出的解法叫 Agent Canvas即它的自托管前端一台机器上跑 Agent Server多个智能体、多个后端、定时自动化全部通过浏览器操作。适合想把自己的智能体任务常驻到服务器上、或用统一入口管理多个编码智能体的人。架构一句话浏览器通过 REST API 说话Agent Server 在运行时里执行对话与工具细节可看docs/architecture.md。图 1首次启动后左侧面板显示 Getting started 待办清单Customize 下的 Skills 页用于给智能体添加能力最短路径上手三种启动方式怎么选环境要求很简单Node.js 22.12 以上Docker 方式只需要 Docker Desktop 或 Docker Engine4GB 以上空闲内存、5GB 以上磁盘首次启动要拉取一批依赖本地运行方式另需uv来启动 agent server从源码运行# 获取代码 git clone https://gitcode.com/GitHub_Trending/ope/OpenHands cd OpenHands # 安装前端依赖 npm install # 启动完整本地栈agent server 自动化后端 前端 npm run dev选它是因为npm run dev一次拉起整套栈前端热更新试功能最方便。成功的样子终端里 Vite 就绪、agent server 监听在127.0.0.1:18000浏览器打开http://localhost:8000出现主界面。左下角的 Getting started 清单会引导你依次做三件事添加 LLM API key、开始第一次对话、安排一个定时任务。⚠️ 本地方式下智能体对整台机器的文件系统有读写权也能执行 shell 命令。敏感机器请改用 Docker 方式。用 Docker 起沙箱export PROJECTS_PATH$HOME/projects # 存放项目代码的目录 mkdir -p $PROJECTS_PATH $HOME/.openhands # 智能体只能看到挂载目录状态持久化到 ~/.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。智能体只能看到PROJECTS_PATH下的目录日常使用更稳妥。全局一键安装npm install -g openhands/agent-canvas agent-canvas # 启动完整本地栈三种方式的区别方式智能体可见范围适合场景源码 / 全局安装宿主机全部文件系统本地试玩、可信机器Docker 沙箱仅挂载的目录日常使用、隔离敏感文件远程 VM专用机器可长期运行常驻任务、外部 webhook 触发VM 方式还要处理防火墙与密钥访问见docs/SELF_HOSTING.md。跑起来之后三个高频用法让智能体写代码并执行在聊天框输入“创建一个 bash 脚本输出 Hello World 并运行它”。智能体先写出hello_world.sh再执行它并把运行输出回传到对话里。你只需核对三处命令以“已执行”的块呈现而不是单纯贴一段代码建议终端输出里包含预期结果工作区文件列表里出现了生成的脚本让它处理你自己的项目新建一个指向项目目录的会话Docker 方式下即PROJECTS_PATH里的某个目录输入“给 utils 模块补充单元测试”。智能体会读代码、改文件、在沙箱里跑测试你可以随时切回去看改动 diff。建一个定时自动化进入 Automate 区域Templates 里有现成模板也可以点 Add Automation 自己写。图 2仪表盘展示每个自动化的运行次数、近期成功率和平均耗时比如 “PR Review on Open” 在新 PR 打开时自动做代码评审“Nightly Security Pass” 每天凌晨扫描漏洞。想立刻看效果点 “Run now” 手动触发一次即可。图 3Templates 页提供开箱即用的自动化模板可复制修改后启用智能体行为不对时按顺序查LLM key 是否配置、会话是否指向了正确的目录、侧边栏后端状态是否为 Healthy。避坑与调优8000 端口被占用—— 原因别的进程占用了默认 ingress 端口。解法用PORT环境变量改口例如PORT8080 npm run dev再访问新端口。首次启动为什么这么慢—— 原因第一次npm run dev时uvx会从 PyPI 下载 agent server 及其 Python 依赖前端还要装 JS 依赖。解法等它跑完即可之后启动走缓存快得多。npm install 报版本错误—— 原因package.json要求 Node 22.12 以上你当前的 Node 偏旧。解法先升级 Node 再装依赖。要开放到局域网或公网怎么办—— 直接把 agent server 暴露出去任何能连上的人都能读写你的文件。解法部署到带防火墙的 VM用openssl rand -base64 32生成密钥并导出LOCAL_BACKEND_API_KEY再以--public启动UI 首次加载会要求输入密钥才能操作。智能体表现不够聪明或太贵—— 在 Customize 里切换 LLM profile复杂重构换强模型批量小脚本用便宜模型再配合 Skills 开关控制智能体加载的能力集。现在你手里有一个跑起来的 Agent Canvas智能体可以读写你工作区的代码并按你的指令执行命令。下一步试着把一件重复性工作——比如生成每日构建报告——做成定时自动化或者直接指向一个团队共享目录试试。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考