OpenHands Agent Canvas 实战上手4 步自建你的 AI 编码代理控制台【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHands Agent Canvas 是一个自托管的 AI 编码代理控制台。它在浏览器里统一管理代理对话、终端、文件与定时任务既能驱动内置的 OpenHands 代理也能接入 Claude Code、Codex 等外部代理。适合想在自己机器或服务器上跑一个常驻 AI 开发团队的开发者。 项目全景速览五大核心模块动手前先建立心智模型。Agent Canvas 本身是前端控制台真正干活的组件分工如下模块作用前端 UIsrc/React TypeScript 控制面板对话、文件、终端、设置Agent Server在单台机器上运行代理的 REST 服务自动化后端执行定时或事件webhook触发的任务Ingress 代理把前端、代理、自动化流量收口到本地一个端口状态目录~/.openhands/存放会话记录与 bash 事件日志数据流向很直接浏览器请求先到 ingress 代理按路径转发给 Agent Server 或自动化后端所以整个栈只暴露 8000 一个端口。界面还可以同时连接多台 Agent Server 并在其间切换无论那台机器是你的笔记本还是云端虚拟机入口都是同一个界面。 5 分钟跑通第一个对话先做四项前置检查已安装 Node.js 22.12 及以上版本已安装uv启动代理服务器时会用到uvx8000 端口未被占用网络稳定首次运行需要下载依赖全局安装。npm 包内封装了完整的本地运行栈。npm install -g openhands/agent-canvas完成后agent-canvas命令即可在系统内使用。一键启动。下面这条命令会依次拉起 Agent Server、自动化后端和 ingress 代理。agent-canvas等终端提示服务就绪即可无需单独管理进程。打开界面。访问http://localhost:8000页面会显示引导清单。配置 LLM Profile 并发一条消息。填入模型服务的 API Key然后试试解释一下当前项目的结构。代理回复、文件变更与终端输出会实时刷新。注意本地模式会让代理获得完整文件系统访问权限建议先在可信机器上体验。⚙️ 核心能力拆解对话编码、自动化与技能对话式编码主流程是用自然语言描述任务代理负责读代码、写代码、执行命令并回报结果。输入给日期解析工具补一个单元测试 输出代理新建测试文件在终端运行并展示通过结果。对话、文件差异与终端共用同一工作区不需要在窗口之间来回切换。API 层实现在 src/api/。定时自动化自动化后端让代理按时间表或 webhook 事件运行把一次性对话变成可复用的工作流。触发pull_request_opened 动作执行代码审查并把意见作为评论直接发到 PR。创建后仪表盘展示健康状态、运行次数与成功率详情页集中列出 Prompt、触发条件与通知配置改起来一目了然。前端入口在 src/api/automation-service/。技能市场技能是可复用的能力单元用来扩展代理的处理范围。可以按名称或类别搜索逐个启停。搜索 javac出现 add-javadoc 技能一键安装到当前工作区。只有启用中的技能才会加载进代理上下文上下文长度因此可控。实现在 src/api/skills-service.ts。️ OpenHands 配置与调优参数一览配置项默认值推荐值影响说明PORT80008000ingress 入口端口冲突时修改OH_AGENT_SERVER_GIT_REFmainmain用 git 分支或 commit 钉住代理服务器版本OH_AUTOMATION_GIT_REFmainmain钉住自动化后端版本OH_AGENT_SERVER_LOCAL_PATH无本地 SDK 路径调试时指向本地 software-agent-sdkPROJECTS_PATH无Docker 模式你的项目目录容器模式下代理可访问的目录大多数用户只需在界面里选好 LLM Profile。环境变量主要留给版本钉扎和调试场景。 你大概率会遇到的问题端口 8000 被占用修改PORT环境变量后重启即可。界面能打开但代理无响应首次启动会用uvx下载代理服务器网络慢时属正常现象等待几分钟或检查 PyPI 连通性。Docker 模式下看不到项目确认PROJECTS_PATH指向真实目录并已挂载到容器内/projects路径。外部代理如 Claude Code没有输出它们需要在运行机器上有 CLI 登录态或 API Key排查细节见 docs/ACP_AGENTS.md。 深入探索与延伸阅读自托管与外部代理接入系统边界与运行模式docs/architecture.md虚拟机自托管与安全加固docs/SELF_HOSTING.md接入外部 ACP 代理docs/ACP_AGENTS.md产品规格说明specs/ACP 代理 Docker 部署示例examples/acp-docker/先用本地模式跑通对话流程熟悉之后再迁移到 Docker 或虚拟机部署。届时合上笔记本代理仍然在服务器上继续干活。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考