🔥 BRAVE 質押池已上線 — 在錢包搜尋 BRAVE 即可委託

比特币生态的 OpenClaw 方案:用 Umbrel 部署 OpenClaw

    • #33866

      Umbrel是一个来自比特币生态的自托管工具,提供了目前对技术小白最友好的自托管OpenClaw方案。

      UmbrelOS 官方支持在任何兼容 EFI 启动的虚拟化软件上运行——包括 VirtualBox 和 Proxmox。这意味着你可以在现有的 Windows、macOS 或 Linux 电脑上,用虚拟机零成本搭建一个完整的 Umbrel 环境,并在其中安装和体验 OpenClaw。

      本文将以两种主流开源虚拟化平台为线索,手把手带你完成从虚拟机创建到 OpenClaw 正常运行的全流程。


      1. 前置知识:什么是虚拟机?为什么用虚拟机

      📖 虚拟机的核心概念

      虚拟机(Virtual Machine, VM)是一台”软件模拟的计算机”——它在你现有的物理主机上,通过虚拟化技术创建出一台独立的、隔离的计算环境。 对于虚拟机内部运行的操作系统(如 umbrelOS)来说,它”以为”自己运行在一台真实的物理机器上。

      ┌─────────────────────────────────────────────┐
      │  你的物理电脑 (宿主机 / Host)                  │
      │  ├── Windows / macOS / Linux                │
      │  │                                          │
      │  ├── 虚拟化软件 (Hypervisor)                 │
      │  │   ├── 🖥️ 虚拟机 A: umbrelOS              │
      │  │   │   ├── Matrix Synapse                 │
      │  │   │   ├── OpenClaw                       │
      │  │   │   ├── Nextcloud                      │
      │  │   │   └── ...                            │
      │  │   │                                      │
      │  │   └── 🖥️ 虚拟机 B: 其他系统 (可选)         │
      │  │                                          │
      │  └── 宿主机上的其他应用                       │
      └─────────────────────────────────────────────┘

      🤔 为什么选择虚拟机方式?

      优势说明
      💰 零额外成本不需要购买任何额外硬件,利用现有电脑即可体验
      🧪 安全的实验环境虚拟机与宿主机隔离,即使操作失误也不会影响你的主系统
      📸 快照与回滚可以在关键步骤前创建快照,出错后一键回滚到之前的状态
      🔄 可复制性配置好的虚拟机可以导出为文件,方便在不同电脑间迁移
      📚 学习价值在虚拟机中实践服务器管理技能,为未来部署到专用硬件做准备

      ⚠️ 虚拟机方式的局限性

      限制影响缓解措施
      🐢 性能开销虚拟化本身会消耗一部分 CPU 和内存资源,整体性能低于原生安装分配足够的核心和内存,启用硬件虚拟化加速(VT-x/AMD-V)
      🎮 GPU 直通复杂将物理 GPU 传递给虚拟机需要额外配置,且并非所有硬件组合都支持入门阶段使用云端 API 进行 AI 推理,避免本地 LLM 对 GPU 的需求
      🌐 网络配置虚拟机的网络默认使用 NAT 模式,局域网内其他设备可能无法直接访问配置”桥接网络”模式,使虚拟机获得与宿主机同一网段的独立 IP
      💤 不适合 7×24 运行你的电脑关机或休眠时,虚拟机也会停止运行长期使用建议迁移到专用硬件或 Proxmox 服务器

      2. 系统要求与准备工作

      💻 硬件最低要求

      umbrelOS 官方文档明确列出了以下最低硬件要求。请注意,这些是 umbrelOS 本身的要求——虚拟化层还需要额外的资源:

      资源umbrelOS 最低要求推荐配置(含 OpenClaw)说明
      🧮 CPU双核 64 位 Intel 或 AMD 处理器四核及以上你的 CPU 必须支持硬件虚拟化(Intel VT-x 或 AMD-V)——这是运行虚拟机的前提条件
      🧠 内存4 GB8 GB 分配给虚拟机(宿主机总内存建议 16 GB+)OpenClaw + Matrix + Nextcloud 同时运行时内存消耗较大
      💾 存储32 GB100 GB+(虚拟磁盘)32 GB 仅能安装系统和少量应用;100 GB 可以舒适运行多个应用并存储一定量的文件
      🌐 网络有线或无线网络连接有线连接优先虚拟机桥接网络在有线连接下更稳定

      🔧 检查你的 CPU 是否支持硬件虚拟化

      这一步至关重要——如果 CPU 不支持虚拟化或未在 BIOS 中启用,虚拟机将无法运行。

      Windows 用户:

      1. Ctrl + Shift + Esc 打开任务管理器
      2. 切换到”性能”选项卡 → 点击”CPU”
      3. 在右下方查找”虚拟化”字段——应显示为”已启用”

      macOS 用户:

      • Intel Mac:打开终端,执行 sysctl -a | grep machdep.cpu.features,输出中应包含 VMX
      • Apple Silicon Mac(M1/M2/M3/M4):原生支持虚拟化,无需额外检查。⚠️ 但注意:umbrelOS 的安装镜像目前仅提供 amd64(x86_64)架构。在 Apple Silicon 上运行需要使用支持 x86 模拟的虚拟化工具(如 UTM),性能会有显著损失。建议 Apple Silicon 用户考虑使用 Docker 方式部署,或直接使用 Raspberry Pi 5。

      Linux 用户:

      • 执行 egrep -c '(vmx|svm)' /proc/cpuinfo,返回值大于 0 即表示支持

      如果显示”未启用”或不支持:

      进入电脑的 BIOS/UEFI 设置(开机时按 Del/F2/F10,具体按键因主板品牌而异),找到类似 “Intel Virtualization Technology” 或 “SVM Mode” 的选项,将其设为 “Enabled”。


      📥 下载准备

      在开始之前,需要下载以下文件:

      文件下载地址用途
      🏠 umbrelOS 安装镜像GitHub Releases — getumbrel/umbrel选择最新版本的 umbrelos-amd64-usb-installer.iso 文件。⚠️ 不要下载 .img.xz 格式——该格式与部分虚拟机不兼容
      🖥️ 虚拟化软件根据你选择的平台下载(见下节)运行虚拟机的宿主软件

      3. 选择你的虚拟化平台

      本文将覆盖两种最常用的开源虚拟化平台。根据你的使用场景和技术水平选择:

      平台适合人群宿主系统价格特色
      🟦 VirtualBox🔰 初学者 / 个人学习Windows / macOS / Linux免费开源图形界面友好,社区资源丰富,上手最快
      🟩 Proxmox VE🚀 家庭实验室 / 长期运行直接安装在裸机上(替代宿主 OS)免费开源(企业订阅可选)专业级虚拟化平台,支持 GPU 直通,适合 7×24 运行的家庭服务器

      4. 方案一:VirtualBox 安装 umbrelOS(推荐初学者)

      📥 步骤一:安装 VirtualBox

      1. 前往 VirtualBox 官网 下载适合你操作系统的安装包
      2. 按照向导完成安装(Windows 用户需允许安装网络驱动组件)
      3. 安装完成后启动 VirtualBox

      🖥️ 步骤二:创建虚拟机

      1. 点击 “新建 (New)” 按钮
      2. 填写基本信息:
      字段设置值说明
      名称umbrelOS你可以自定义名称
      文件夹默认或自定义路径虚拟机文件的存放位置
      类型 (Type)Linux
      版本 (Version)Debian (64-bit)umbrelOS 基于 Debian 12 构建
      ISO 镜像选择下载的 .iso 文件umbrelos-amd64-usb-installer.iso
      1. ⚠️ 取消勾选 “Unattended Install”(无人值守安装) ——umbrelOS 有自己的安装程序

      🧠 步骤三:分配硬件资源

      在创建向导的”硬件”页面中:

      资源推荐设置说明
      内存 (RAM)8192 MB (8 GB)最低 4096 MB,但运行 OpenClaw 建议 8 GB
      处理器 (CPU)4 核最低 2 核,4 核可以更流畅地运行多个服务

      在”硬盘”页面中:

      选项推荐设置说明
      硬盘大小100 GB选择”动态分配(Dynamically Allocated)”——虚拟磁盘文件不会立刻占用 100 GB 物理空间,而是随着实际使用逐渐增长
      硬盘格式VDI (VirtualBox Disk Image)默认即可

      ⚡ 步骤四:关键设置——启用 EFI 模式

      🚨 这一步是最容易被忽略,也是导致安装失败的最常见原因。umbrelOS 安装程序要求 EFI 启动模式,不支持传统 BIOS 模式。

      1. 选中刚创建的虚拟机 → 点击 “设置 (Settings)”
      2. 导航到 “系统 (System)”“主板 (Motherboard)” 选项卡
      3. ✅ 勾选 “启用 EFI (Enable EFI (special OSes only))”
      4. 确保启动顺序中 “光驱 (Optical)”在”硬盘 (Hard Disk)”之前(首次安装时需要从 ISO 引导)
      5. 点击 “确定 (OK)” 保存设置

      🌐 步骤五:配置网络(推荐桥接模式)

      默认的 NAT 模式下,虚拟机可以访问外网,但你局域网内的其他设备(如手机、平板)无法直接访问虚拟机。为了让 umbrelOS 像一台真正的服务器一样在局域网中可发现,建议切换为桥接模式:

      1. 在虚拟机设置中,导航到 “网络 (Network)”
      2. “连接方式 (Attached to)” 改为 “桥接网卡 (Bridged Adapter)”
      3. “界面名称 (Name)” 选择你电脑实际使用的网络接口(如 eth0en0 或你的 WiFi 适配器名称)
      4. 展开 “高级 (Advanced)” → 混杂模式 (Promiscuous Mode) 设为 “全部允许 (Allow All)”

      💡 如果你不确定选哪个网络接口:选择你当前用来上网的那个。有线用户通常是 eth0 或包含 “Ethernet” 的选项;WiFi 用户选择包含 “Wireless” 或 “Wi-Fi” 的选项。


      🚀 步骤六:安装 umbrelOS

      1. 启动虚拟机 → 点击”启动 (Start)” 按钮
      2. 虚拟机将从 ISO 引导,显示 umbrelOS 安装界面
      3. 选择安装目标磁盘——你会看到一个磁盘列表,选择你创建的虚拟硬盘(通常是唯一的选项,显示为 ATAVBOX HARDDISK,容量与你设置的一致)
      4. 输入对应的编号并按 Enter 确认
      5. 等待安装完成——安装程序会将 umbrelOS 写入虚拟硬盘

      🔧 步骤七:首次启动配置

      1. 安装完成后,关闭虚拟机
      2. ⚠️ 关键操作:移除 ISO 镜像!
        • 进入虚拟机设置 → “存储 (Storage)”
        • 在控制器中找到挂载的 ISO 文件 → 点击右侧光盘图标 → 选择”移除虚拟光盘 (Remove Disk from Virtual Drive)”
        • 如果不移除 ISO,虚拟机会再次进入安装程序而非启动 umbrelOS
      3. 重新启动虚拟机
      4. 首次启动需要约 5 分钟——请耐心等待,不要中途关闭
      5. 启动完成后,在浏览器中打开 http://umbrel.local
        • 如果 umbrel.local 无法解析,在 VirtualBox 的虚拟机控制台中查看 umbrelOS 启动完成后显示的 IP 地址,然后在浏览器中输入 http://该IP地址

      🎉 步骤八:完成 umbrelOS 初始设置

      1. 浏览器打开 umbrelOS 界面后,你会看到欢迎页面
      2. 创建你的账户——设置用户名和密码(这是你登录 umbrelOS 的凭证,请务必牢记)
      3. 设置完成后进入 umbrelOS 主界面——一个优雅的应用商店仪表板

      🖼️ 你应该看到的界面:一个简洁的深色/浅色主题面板,顶部显示你的 Umbrel 名称,下方是应用商店入口和已安装应用列表。


      5. 方案二:Proxmox VE 安装 umbrelOS

      🏗️ 为什么选择 Proxmox

      如果你的目标不仅仅是”体验”,而是打算将 Umbrel 作为长期运行的家庭服务器,Proxmox VE 是最佳选择。

      Proxmox VE(Proxmox Virtual Environment)是一个基于 Debian 的开源服务器虚拟化管理平台,直接安装在裸机(bare metal)上,不需要宿主操作系统。它是专业数据中心和家庭实验室用户的首选。

      Proxmox 优势说明
      🔄 7×24 无人值守运行作为裸机 Hypervisor,Proxmox 随服务器开机自动启动,无需人工干预
      🎮 GPU 直通 (Passthrough)支持将物理 GPU 传递给虚拟机,OpenClaw 可以利用 GPU 运行本地 LLM
      📸 企业级快照与备份支持实时快照、定时自动备份、增量备份
      🖥️ Web 管理界面通过浏览器管理所有虚拟机,无需本地客户端
      🐳 LXC 容器支持除虚拟机外,还支持更轻量的 Linux 容器

      📥 前提:Proxmox VE 已安装

      本文假设你已经在一台物理服务器或旧电脑上安装了 Proxmox VE。如果尚未安装:

      1. 前往 Proxmox VE 下载页面 下载 ISO
      2. 使用 Rufus (Windows) 或 Etcher (macOS/Linux) 将 ISO 写入 USB 闪存盘
      3. 从 USB 启动目标设备,按照向导完成安装
      4. 安装完成后,通过浏览器访问 https://服务器IP:8006 进入 Proxmox 管理界面

      🖥️ 方法一:使用 ISO 安装(推荐)

      📤 上传 ISO 到 Proxmox

      1. 登录 Proxmox Web 界面 (https://服务器IP:8006)
      2. 在左侧导航中,展开你的节点 → 点击 “local (存储名)”
      3. 切换到 “ISO Images” 选项卡
      4. 点击 “Upload” → 选择下载的 umbrelos-amd64-usb-installer.iso 文件 → 等待上传完成

      🔨 创建虚拟机

      1. 点击右上角 “Create VM”
      2. 按照以下各选项卡进行配置:

      📋 General(常规)选项卡:

      字段设置值
      Node你的 Proxmox 节点名称
      VM ID自动分配(如 100)
      NameumbrelOS

      💿 OS(操作系统)选项卡:

      字段设置值
      ISO image选择刚上传的 umbrelos-amd64-usb-installer.iso
      TypeLinux
      Version6.x - 2.6 Kernel或最新的内核版本选项

      ⚙️ System(系统)选项卡(⚠️ 关键步骤):

      字段设置值说明
      BIOSOVMF (UEFI)🚨 必须选择 UEFI,不可使用 SeaBIOS
      EFI Storage选择你的存储(如 local-lvm
      Machineq35推荐使用 q35 机型,兼容性更好
      Add EFI Disk✅ 勾选存储 UEFI 启动变量
      SCSI ControllerVirtIO SCSI Single性能最佳

      💾 Disks(磁盘)选项卡:

      字段设置值
      Bus/DeviceVirtIO BlockSCSI
      Storage你的存储池(如 local-lvm
      Disk size100 GB(或更多)
      Discard✅ 勾选(如果使用 SSD 存储)

      🧠 CPU 选项卡:

      字段设置值
      Cores4
      Typehost推荐——让虚拟机直接使用宿主 CPU 特性,性能最佳

      🧮 Memory 选项卡:

      字段设置值
      Memory (MiB)8192

      🌐 Network 选项卡:

      字段设置值
      Bridgevmbr0(Proxmox 默认桥接网络)
      ModelVirtIO (paravirtualized)
      1. 点击 “Finish” 创建虚拟机

      🚀 安装 umbrelOS

      1. 选中创建的虚拟机 → 点击 “Start”
      2. 打开 “Console” 查看虚拟机屏幕
      3. umbrelOS 安装程序会显示磁盘选择界面 → 选择虚拟硬盘 → 确认安装
      4. 安装完成后,在 Proxmox 界面中 停止虚拟机
      5. 移除 ISO:导航到虚拟机 → “Hardware” → 双击 CD/DVD Drive → 选择 “Do not use any media” → OK
      6. 重新启动虚拟机 → 等待约 5 分钟 → 浏览器打开 http://umbrel.local 或虚拟机 IP

      🖥️ 方法二:直接导入磁盘镜像(高级用户)

      如果你更熟悉命令行,可以直接将 umbrelOS 的磁盘镜像导入 Proxmox,跳过 ISO 安装步骤。

      # 1. SSH 进入 Proxmox 主机
      ssh root@你的Proxmox主机IP
      
      # 2. 下载并解压 umbrelOS 磁盘镜像
      wget https://github.com/getumbrel/umbrel/releases/download/v1.5.0/umbrelos-amd64.img.xz
      xz -d umbrelos-amd64.img.xz
      
      # 3. 先在 Web 界面创建一个空虚拟机(VM ID 假设为 100)
      #    OS 选项卡选择"Do not use any media"
      #    System 选项卡:BIOS 选 OVMF (UEFI),勾选 Add EFI Disk
      #    Disks 选项卡:删除默认磁盘(稍后通过导入替换)
      
      # 4. 将磁盘镜像导入虚拟机
      qm importdisk 100 umbrelos-amd64.img local-lvm
      # 其中 100 是你的 VM ID,local-lvm 是你的存储名称
      
      # 5. 在 Web 界面中:
      #    Hardware → 找到新出现的"Unused Disk" → 双击 → 点击 Add 添加
      #    Options → Boot Order → 启用新磁盘并拖到最上面
      
      # 6. 可选:调整磁盘大小
      qm resize 100 scsi0 +68G
      # 将磁盘从默认约 32GB 扩展到 100GB

      🎮 进阶:GPU 直通配置(可选)

      如果你计划使用本地 LLM(如 Ollama + Qwen3)运行 OpenClaw,可以通过 GPU 直通将物理显卡传递给 umbrelOS 虚拟机。

      ⚠️ 前置条件:

      • CPU 支持 IOMMU(Intel VT-d 或 AMD-Vi)
      • 在 BIOS 中启用 VT-d / AMD-Vi 以及 “Above 4G Decoding”
      • 建议:宿主机拥有集成显卡(iGPU)用于 Proxmox 界面显示,独立显卡(dGPU)传递给虚拟机

      配置步骤概览(每一步的具体命令因硬件而异):

      步骤操作命令/设置
      1️⃣ 启用 IOMMU修改 GRUB 引导参数/etc/default/grub 中添加 intel_iommu=on(Intel)或 amd_iommu=on(AMD)
      2️⃣ 加载 VFIO 模块修改内核模块配置/etc/modules 中添加 vfiovfio_pcivfio_iommu_type1vfio_virqfd
      3️⃣ 屏蔽宿主 GPU 驱动防止 Proxmox 宿主占用 GPU/etc/modprobe.d/blacklist.conf 中添加 blacklist nouveaublacklist nvidia
      4️⃣ 绑定 GPU 到 VFIO指定 GPU 的 PCI ID/etc/modprobe.d/vfio.conf 中添加 options vfio-pci ids=你的GPU_ID
      5️⃣ 更新引导配置应用更改执行 update-grubupdate-initramfs -u -k all,然后重启
      6️⃣ 添加 PCI 设备到 VM在虚拟机中添加 GPUVM → Hardware → Add → PCI Device → 选择你的 GPU → 勾选 “All Functions”、”ROM-Bar”、”PCI-Express”

      📚 GPU 直通是一个复杂话题,具体配置高度依赖你的硬件组合。强烈建议参考 Proxmox 官方 PCI Passthrough 文档 以及针对你 GPU 型号的社区指南。


      6. 在 umbrelOS 上安装 OpenClaw

      无论你使用哪种虚拟化平台,一旦 umbrelOS 成功运行并完成初始设置,安装 OpenClaw 的过程是完全一致的——这也正是 Umbrel 的魅力所在。


      📦 步骤一:从应用商店安装

      1. 在浏览器中打开 umbrelOS 界面(http://umbrel.localhttp://虚拟机IP
      2. 点击 “App Store”(应用商店)
      3. 在搜索框中输入 “OpenClaw”
      4. 点击 OpenClaw 应用卡片 → 点击 “Install”(安装)
      5. 等待安装完成——应用会自动下载 Docker 镜像并配置运行环境

      💡 安装过程通常需要 2-5 分钟,取决于你的网络速度。安装完成后,OpenClaw 会出现在 umbrelOS 主界面的已安装应用列表中。


      ⚙️ 步骤二:首次配置 OpenClaw

      点击已安装的 OpenClaw 应用,你会看到一个控制面板(Control UI)。首次使用需要配置 LLM 提供商。

      🔑 认证步骤:

      1. 获取 App Password(应用密码):在 umbrelOS 主界面中,点击 OpenClaw 应用卡片上的 “…” 菜单 → “Show app password”
      2. 复制该密码
      3. 在 OpenClaw 的 Control UI 中,粘贴此密码作为 Gateway Token 进行认证

      🤖 步骤三:配置 LLM 提供商

      OpenClaw 支持多种 LLM 提供商。根据你的需求选择:

      🌐 选项 A:使用云端 API(推荐入门)

      这是最快速的上手方式——不需要 GPU,不需要下载模型文件,只需要一个 API 密钥。

      提供商获取 API Key推荐模型特点
      Anthropic (Claude)console.anthropic.comClaude Sonnet 4.5编程和复杂推理能力最强
      OpenAI (GPT)platform.openai.comGPT-5.2通用能力均衡,生态丰富
      Google (Gemini)aistudio.google.comGemini 3 Flash1M 上下文窗口,速度快,成本低

      在 Control UI 中配置:

      1. 进入 OpenClaw Control UI
      2. 在 “Provider” 设置中选择你的 LLM 提供商(如 Anthropic
      3. 输入你的 API Key
      4. 选择默认模型(如 claude-sonnet-4-5-20241022
      5. 保存配置

      🏠 选项 B:使用本地 Ollama(完全离线)

      如果你希望 AI 推理完全在本地完成(数据不离开你的服务器),可以先在 Umbrel 上安装 Ollama,然后让 OpenClaw 连接到它。

      📦 安装 Ollama:

      1. 在 umbrelOS 应用商店中搜索 “Ollama” → 安装
      2. Ollama 安装完成后,会在 Umbrel 上运行一个本地 LLM 推理服务

      🔗 连接 OpenClaw 到 Ollama:

      ⚠️ 关键提醒:在 Umbrel 的 Docker 化环境中,OpenClaw 和 Ollama 运行在不同的容器中。需要使用正确的内部网络地址进行连接。

      配置项设置值说明
      ProviderOllama
      Base URLhttp://ollama_server:11434⚠️ 不要使用 127.0.0.1(那指向 OpenClaw 自己的容器)。使用 Umbrel 的内部 Docker 网络地址。具体地址可能因版本而异——请查阅 Umbrel 社区论坛 获取最新的连接地址
      API Keyollama-localOllama 不需要真正的 API Key,但 OpenClaw 要求填写一个值。任意字符串即可
      API Formatopenai-completions明确指定 API 兼容格式,避免自动检测失败

      📥 下载模型:

      通过 SSH 进入 Umbrel(或使用 Ollama 的 Web UI)下载模型:

      # 通过 Umbrel 的 SSH 访问 Ollama
      ssh umbrel@umbrel.local
      
      # 拉取推荐的模型
      # 轻量级(适合 8GB 内存虚拟机)
      ollama pull qwen3:8b
      
      # 中等规模(需要 16GB+ 内存)
      ollama pull qwen3:14b
      
      # 大型模型(需要 32GB+ 内存 + GPU)
      ollama pull qwen3:32b
      模型内存需求适用场景
      qwen3:8b~6 GB轻量级任务:对话、简单文本处理、基础编程
      qwen3:14b~10 GB中等任务:文档分析、代码生成、多步骤推理
      llama3.1:8b~6 GBMeta 的开源模型,英文任务表现优秀
      qwen3:32b~22 GB高级任务:复杂推理、长文档处理(需要 GPU)

      ⚠️ 已知问题:OpenClaw 2026.2.19-2 版本曾报告与 Ollama 集成时出现”No API key found for provider ollama”错误(GitHub Issue #22055)。如果遇到此问题,请确保更新到最新版本的 OpenClaw。


      🧪 步骤四:验证安装

      配置完成后,进行简单的功能验证:

      1. 📝 基础对话测试:在 OpenClaw 的 Chat 界面中输入 “Hello, introduce yourself.”——AI 应该正常回复
      2. 🔧 工具调用测试:输入 “What files are in my home directory?”——AI 应该调用文件系统工具并返回结果
      3. 🌐 网页浏览测试:输入 “Search the web for the latest news about AI agents”——AI 应该使用内置浏览器进行搜索

      如果一切正常,恭喜你!🎉 你已经在虚拟机上成功部署了 OpenClaw。


      7. 安装后:推荐的下一步操作

      📋 推荐安装的配套应用

      在 umbrelOS 应用商店中,以下应用与 OpenClaw 配合使用可以构建完整的私有化数字基础设施:

      应用用途与 OpenClaw 的关系
      🔐 Matrix (Synapse)去中心化加密通信OpenClaw 的安全通信通道——通过 Matrix 客户端远程指挥 AI 代理
      ☁️ Nextcloud私有云存储与协作OpenClaw 的数据访问层——AI 可以操作你的文件、日历、任务
      🦙 Ollama本地 LLM 推理引擎OpenClaw 的本地大脑——完全离线的 AI 推理能力
      🔒 Tailscale零配置 VPN安全的远程访问——从外部网络安全地访问你的 Umbrel
      🎬 Jellyfin媒体服务器可选——AI 可以帮助管理和整理你的媒体库

      🔐 安全加固清单

      操作优先级说明
      ✅ 修改默认 SSH 密码🔴 高umbrelOS 默认 SSH 密码为你在初始设置时创建的密码。确保密码足够复杂
      ✅ 安装 Tailscale🔴 高如果需要从外部网络访问 Umbrel,通过 Tailscale VPN 而非端口转发
      ✅ 定期更新应用🟡 中在 umbrelOS 界面中定期检查并更新所有已安装应用
      ✅ 创建虚拟机快照🟡 中在安装重要应用前创建虚拟机快照,以便出错时快速回滚
      ✅ 配置自动备份🟢 标准利用 umbrelOS 1.5 的自动加密备份功能,将数据备份到 NAS 或外部存储

      8. 常见问题与故障排除

      🔴 安装失败:启动后黑屏或进入 UEFI Shell

      症状原因解决方案
      启动后看到 UEFI Interactive Shell未正确设置 EFI 启动确认虚拟机设置为 EFI/UEFI 模式(VirtualBox: 勾选 Enable EFI; VMware: 选择 UEFI; Proxmox: BIOS 选 OVMF)
      安装程序无法识别磁盘磁盘控制器不兼容Proxmox: 确保使用 VirtIO Block 或 SCSI 控制器; VirtualBox/VMware: 使用默认 SATA 控制器
      ISO 无法引导使用了 .img.xz 格式请使用 umbrelos-amd64-usb-installer.iso 格式

      🟡 网络问题:无法访问 umbrel.local

      症状原因解决方案
      umbrel.local 无法解析mDNS 不被网络支持直接使用虚拟机的 IP 地址访问。在虚拟机控制台中,umbrelOS 启动完成后会显示 IP 地址
      虚拟机无法获取 IP网络模式为 NAT切换到桥接模式(Bridged),确保虚拟机与宿主机在同一网段
      桥接模式下无法联网WiFi 适配器不支持桥接部分 WiFi 芯片不支持虚拟机桥接。解决方案:使用有线连接,或回退到 NAT 模式并通过端口转发访问

      🟢 OpenClaw 相关问题

      症状原因解决方案
      OpenClaw 安装后无法打开Docker 容器启动失败等待几分钟后刷新页面。如果仍无法打开,在 umbrelOS 中重启该应用
      Ollama 连接失败Docker 网络地址错误不要使用 127.0.0.1。查阅 Umbrel 社区获取正确的内部网络地址
      “No API key found” 错误已知 Bug(v2026.2.19-2)更新到最新版本的 OpenClaw
      AI 回复为空或超时本地模型过大,内存不足选择更小的模型(如从 32B 降到 8B),或增加虚拟机内存分配

      9. 从虚拟机到专用硬件:迁移路径

      虚拟机是绝佳的学习和体验平台,但如果你决定长期使用 Umbrel 作为家庭服务器,最终迁移到专用硬件是更好的选择。以下是推荐的迁移路径:

      🧪 阶段一:虚拟机体验
          │  VirtualBox / VMware
          │  学习 Umbrel 操作、配置 OpenClaw、
          │  熟悉 Matrix / Nextcloud
          │
          ▼
      🔧 阶段二:Proxmox 家庭实验室
          │  旧电脑 / 迷你主机安装 Proxmox
          │  7×24 运行,GPU 直通
          │  可同时运行多个虚拟机
          │
          ▼
      🏠 阶段三:专用硬件
            Umbrel Home / Umbrel Pro / NUC / Mini PC
            原生性能,低功耗,长期稳定运行
      硬件选项价格区间适合场景
      Raspberry Pi 5 (8GB)~$80-100极低功耗,适合轻量级使用(云端 LLM)
      旧笔记本 / 台式机$0(利用现有设备)零成本入门,性能取决于设备配置
      Intel NUC / 迷你主机$200-500低功耗 + 足够性能,理想的家庭服务器
      Umbrel Home$499开箱即用,官方支持,2TB NVMe SSD
      Umbrel Pro$149916TB 存储,企业级性能

      总结

      通过本文,你应该已经能够:

      • ✅ 理解虚拟机的基本概念及其在 Umbrel 部署中的价值
      • ✅ 在 VirtualBox 或 Proxmox 上成功安装 umbrelOS
      • ✅ 从 Umbrel 应用商店安装并配置 OpenClaw
      • ✅ 选择合适的 LLM 提供商(云端 API 或本地 Ollama)
      • ✅ 了解常见问题的排查方法和解决方案
      • ✅ 规划从虚拟机到专用硬件的迁移路径

      虚拟机是你探索私有化 AI 基础设施的第一步。在这个安全的沙箱环境中,你可以自由实验、大胆试错,为最终部署到生产环境积累宝贵的经验。


      📚 参考资料与延伸阅读

      umbrelOS 安装相关:

      虚拟化平台相关:

      OpenClaw 相关:

      Ollama 相关:

  • 抱歉,回覆主題必需先登入。