OpenHands 完整上手指南3 步在本地搭建 AI 编程智能体控制台【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHandsOpenHandsAgent Canvas是一款开源自托管的 AI 编程智能体控制台它不替代编码智能体而是把 OpenHands 内置智能体、Claude Code、Codex、Gemini CLI 等多个智能体收进同一个网页界面帮你发起对话、切换后端、把重复任务变成自动化。适合想给个人电脑或团队服务器配一个AI 开发工作台、又不想依赖第三方 SaaS 的开发者。能力拆解它能帮你做什么一个界面驱动多个编码智能体过去你只能在终端里绑某一个智能体。Agent Canvas 通过 ACPAgent-Client Protocol协议把不同智能体当作可切换的子进程来管理左侧是会话列表中间是对话流右侧有文件、终端和 Git 视图全部在一个浏览器里完成。想换智能体在设置里改选择即可会话上下文跟随后端走不会丢。把重复工作变成定时自动化不只是你问它答。它内置 Automation 模块可以按日程如每天 03:30 扫描安全漏洞或按事件如 PR 打开时自动审查、push 时同步文档触发智能体任务并记录每次运行的成功率和耗时。详见 specs 中的自动化定义集成 Slack、GitHub 等服务的能力在 README 中有说明。用技能与 MCP 扩展智能体边界在 Customize 页面可以管理技能Skills和 MCP Server。技能是带触发条件的提示词包例如code-review聚焦数据结构、简洁性与安全评估add-javadoc自动补充 JavaDocMCP 则让智能体连上你现有的工具链。技能按类别组织自动化配方、环境与工具、代码托管与 CI、智能体授权等可搜索、启用或禁用变更即时生效于新会话。后端可插拔本地到云端自由切换Agent Server 可以跑在你笔记本上、专用小主机如 Mac Mini、云虚拟机或容器里Canvas 前端同时连接多个后端并随时切换。团队里可以共享一台跑代码审查和依赖更新的服务器同时保留自己笔记本上的个人智能体。架构细节见 docs/architecture.md。上手路径从零到跑通只需 3 步检查清单已安装 Docker推荐方式智能体被隔离在容器里或已安装 Node.js 22.12 及以上版本 uv直接安装方式预留一个存放项目代码的目录容器方式下挂载为/projects浏览器可用能访问本机 8000 端口推荐方式Docker 沙箱约 2 分钟创建一个项目目录后运行一条docker run命令即可镜像ghcr.io/openhands/agent-canvas:1.15.0挂载你的项目目录和~/.openhands配置目录映射 8000 端口。智能体只能访问挂载进来的项目碰不到你整台机器的文件系统——对新手这是最稳妥的姿势。备选方式直接安装不想用 Docker 的话全局安装 npm 包后执行agent-canvas一条命令就能拉起完整本地栈。注意官方明确警告此模式下智能体对你本机文件系统有完全访问权限请仅在受信任的机器上使用。跑通后浏览器访问http://localhost:8000容器方式访问/canvas路径。首次进入会看到引导清单添加 LLM 配置、开始第一次对话、安排第一个自动化任务。实操演示让智能体每天自动做安全扫描挑一个最有代表性的任务走完全程——从输入需求到看到结果。第一步定义自动化。在 Automate 页面点 Add Automation选Daily Security Pass这类预置模板或自己描述触发条件和目标仓库。第二步设置触发。选择定时触发每天固定时间或事件触发每次 push 后绑定到某个后端。第三步查看运行结果。仪表盘为每个自动化提供卡片最近一次运行时间、总运行次数、近期成功率、平均耗时一目了然出错的会话在左侧列表标红Error 标签点进去即可看到智能体的完整执行过程而不是只给你一个失败二字。整个过程不需要写任何代码——你描述的每一句自然语言都被翻译成了可重复执行的智能体任务。常见疑问Q1必须接云端大模型或付费服务吗不一定。它遵循自带模型/智能体原则你可以接任意 LLM也可以使用已订阅的 Claude CodePro/Max 登录、CodexChatGPT 登录、Gemini CLIGoogle 登录。官方文档说明只要智能体运行的机器上已有对应 CLI 的登录态它会直接复用连 API key 都不用填见 docs/ACP_AGENTS.md。Q2智能体直接跑在我电脑上安全吗两层防护可选其一用 Docker 方式时智能体被关在容器里只能访问你显式挂载的目录其二若部署到服务器供他人访问官方自托管指南要求先生成 API key 并开启 public 模式所有 API 调用必须携带密钥。指南还建议 2 核 4GB 内存的机器即可支撑单用户使用见 docs/SELF_HOSTING.md。Q3不会写前端代码还能贡献或定制吗可以。UI 本身是 React React Router 项目但多数定制不碰代码技能是 Markdown 描述文件MCP 配置是表单自动化是自然语言。真想深入docs/DEVELOPMENT.md 提供了完整的开发指南。延伸与资源文档总入口docs/README.md自托管与服务器加固docs/SELF_HOSTING.md接入外部 ACP 智能体Claude Code / Codex / Gemini CLIdocs/ACP_AGENTS.md系统架构与运行时模式docs/architecture.mdACP 智能体的 Docker 示例examples/acp-docker/各功能行为规格后端管理、MCP 设置等specs/测试矩阵各安装方式与操作系统的冒烟覆盖docs/TESTING_MATRIX.md下一步如果你今天就想试用 Docker 方式把 Agent Canvas 跑起来先完成引导清单里的第一次对话再挑一个你最烦的重复任务比如每周整理 changelog建一个自动化——从这两件事开始比先读完所有文档更能让你摸清它的脾气。【免费下载链接】OpenHands OpenHands: AI-Driven Development项目地址: https://gitcode.com/GitHub_Trending/ope/OpenHands创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考