ESXi 虚拟机与 QNAP NAS Virtualization Station 部署 Ubuntu 并安装 OpenClaw 完整指南

发布日期: 2026-04-13标签: [OpenClaw, Ubuntu, ESXi, QNAP, NAS, 虚拟机, AI助手, 部署指南]分类: [技术实践]提要: 本文详细介绍了在ESXi虚拟机和QNAP NAS Virtualization Station上部署Ubuntu 24.04并完整安装配置OpenClaw AI助手平台的完整步骤。涵盖硬件要求、系统安装、虚拟机工具配置、OpenClaw安装、技能管理、QQ机器人、、微信机器人配置等全流程确保系统稳定、功能完整。关键词: OpenClaw部署, Ubuntu安装, ESXi虚拟机, QNAP NAS, Virtualization Station, AI助手配置, 多Agent架构前言OpenClaw 是一个功能强大的 AI 助手平台支持多模型集成、插件扩展和跨平台部署。本文将严格按步骤详细介绍如何在 ESXi 虚拟机或 QNAP NAS Virtualization Station 上部署 Ubuntu 24.04并完整安装配置 OpenClaw确保系统稳定、中文输入正常、功能完整。一、环境准备1.1 硬件要求ESXi 虚拟机环境CPU: 4 核以上推荐 8 核支持虚拟化技术内存: 8GB 以上推荐 16GBOpenClaw 运行需要较大内存存储: 50GB 以上 SSD 存储建议使用 NVMe SSD 提升 I/O 性能网络: 千兆网络建议配置虚拟交换机优化网络性能虚拟化: 确保 ESXi 主机已开启 CPU 虚拟化支持QNAP NAS Virtualization Station以 Qu805 为例CPU: ntel® N300 八核心處理器支持虚拟化技术内存: 标配16GBQu805 支持最大单条 48GB 内存存储: 100GB 以上 SSD 存储建议使用 M.2 NVMe SSD 作为虚拟机存储池网络: 2.5GbE 网络接口确保虚拟机网络性能系统要求: QTS 5.1.0 或更高版本Virtualization Station 3.6.0 或更高1.2 软件版本Ubuntu: 24.04 LTS长期支持版OpenClaw: 最新稳定版虚拟机工具:ESXi: open-vm-tools-desktopQNAP Virtualization Station: qemu-guest-agent spice-vdagent二、Ubuntu 24.04 安装与完整配置2.1 虚拟机创建ESXi 环境登录 ESXi Web 管理界面通常为 https://ESXi-IP创建新虚拟机 → 选择 Linux → Ubuntu Linux 64 位重要设置固件类型选择UEFI现代 Ubuntu 推荐使用 EFI 启动CPU分配 4 核vCPU内存分配 8GB硬盘创建 50GB 精简置备磁盘网络适配器VMXNET3高性能虚拟网卡CD/DVD 驱动器选择 Ubuntu 24.04 LTS ISO 镜像完成创建并启动虚拟机QNAP Virtualization Station以 Qu805 为例登录 QNAP NAS 管理界面通常为 https://NAS-IP:5000进入 Virtualization Station 应用点击创建虚拟机 参考ESXi 创建重要设置固件类型选择UEFI确保兼容性CPU 核心数分配 4 核Qu805 支持最多 8 核内存分配 8GB基于标配 16GB存储位置选择 SSD 存储池建议使用 M.2 NVMe SSD磁盘大小创建 50GB 动态分配磁盘网络选择桥接模式连接到 2.5GbE 网络接口ISO 文件上传 Ubuntu 24.04 LTS ISO 镜像配置完成后启动虚拟机安装2.2 Ubuntu 安装步骤语言选择中文简体键盘布局Chinese安装类型最小安装节省资源不安装额外软件磁盘分区选择使用整个磁盘重要确保使用 GPT 分区表UEFI 要求系统会自动创建 EFI 系统分区ESP时区设置Asia/Shanghai用户设置创建管理员账户建议用户名ubuntu设置强密码勾选自动登录方便虚拟机使用等待安装完成并重启2.3 安装虚拟机工具2.3.1 ESXi 环境安装 open-vm-tools-desktop# 更新系统sudoaptupdatesudoaptupgrade-y# 安装 open-vm-tools-desktopVMware 专用sudoaptinstall-yopen-vm-tools-desktop# 重启生效sudoreboot2.3.2 QNAP Virtualization Station安装虚拟机增强工具重要说明QNAP Virtualization Station (QVS) 底层基于 KVM/QEMU 技术需要安装对应的虚拟机增强工具以获得最佳性能。# 1. 更新系统sudoaptupdatesudoaptupgrade-y# 2. 安装 QEMU/KVM 虚拟机代理核心组件sudoaptinstall-yqemu-guest-agent# 3. 启用并启动服务sudosystemctlenable--nowqemu-guest-agent# 4. 安装 SPICE 代理提供剪贴板共享、自适应分辨率等功能sudoaptinstall-yspice-vdagent# 5. 安装 virtio 驱动优化磁盘和网络性能sudoaptinstall-yvirtio-drivers# 6. 验证安装状态sudosystemctl status qemu-guest-agent# 7. 重启系统使所有增强功能生效sudorebootQNAP Virtualization Station 专用配置在 QNAP Virtualization Station 中确保虚拟机设置中启用了虚拟机增强功能配置虚拟机使用 virtio 磁盘和网络驱动在 QVS 管理界面中可以启用剪贴板共享和文件传输功能2.4 开启远程桌面重要方便虚拟机远程管理安装完成后在 Ubuntu 桌面环境中配置远程桌面打开系统设置进入系统 → “设置” → “远程桌面”配置共享启用桌面共享“远程控制”设置访问密码建议与登录密码不同配置远程桌面windows进入系统 →搜索 “远程桌面连接”“计算机” Ubuntu IP地址用户名和密码Ubuntu 远程登录凭据点连接可选配置端口默认 33892.5 开启 SSH 服务# 安装 SSH 服务sudoaptinstallopenssh-server-y# 启动并设置开机自启sudosystemctlenable--nowssh# 放行防火墙sudoufw allowssh# 查看 IP 地址ipa# 测试 SSH 连接从其他设备sshusername虚拟机IP2.6 彻底、永久禁用 Snap保障系统兼容性核心目的彻底清除 Snap 系统确保中文输入法、软件中心等功能的正常兼容性。# 第一步停止所有 Snap 服务sudosystemctl stop snapd.service snapd.socket snapd.seeded.service# 查看当前 Snap 应用列表snap list# 第二步批量删除所有 Snap 应用通用命令forpin$(snap list|awkNR1 {print $1});dosudosnap remove--purge$pdone# 第三步彻底卸载 Snap 服务让系统再也没有 Snapsudoaptpurge--autoremovesnapd-y# 第四步删除所有残留文件干净到像没装过rm-rf~/snapsudorm-rf/snap /var/snap /var/lib/snapd /var/cache/snapd /usr/lib/snapd# 第五步永久禁止 Ubuntu 再装回 Snap最关键sudotee/etc/apt/preferences.d/nosnap.prefEOF Package: snapd Pin: release a* Pin-Priority: -10 EOFsudoapt-mark hold snapdsudoaptupdate# 第六步安装原生软件中心和 Chromesudoaptinstallgnome-software gnome-software-plugin-flatpak-ywgethttps://dl.google.com/linux/direct/google-chrome-stable_current_amd64.debsudodpkg-igoogle-chrome-stable_current_amd64.debsudoapt-finstall-y# 第七步重启系统sudoreboot✅ 做完后你会得到•系统完全无 Snap•软件中心原生中文搜索正常•Chrome 中文输入正常•速度变快、不卡顿、不抽风•以后 apt 装任何软件都不会再冒出 Snap2.7 设置 Fcitx5 中文输入法重要Fcitx5 比 IBus 更稳定、兼容性更好特别适合清理 Snap 后的系统。# 1. 安装中文拼音引擎必须sudoaptinstallfcitx5-chinese-addons fcitx5-pinyin-y# 2. 把系统输入法改成 Fcitx5关键步骤# 打开 设置 → 区域与语言# 点 管理已安装的语言# 把 键盘输入法系统 从 IBus 改成 Fcitx 5# 点 应用到整个系统 → 关闭# 3. 注销/重启必须做gnome-session-quit# 注销# 或sudoreboot# 4. 重启后配置中文输入法# 右上角会出现 键盘图标Fcitx5# 右键 → 配置# 点左下角 # 取消勾选 仅显示当前语言# 搜索 pinyin → 添加 汉语拼音# 5. 使用方法# - 切换输入法Ctrl 空格默认# - 中英文切换Shift# - 右上角图标可直接点选# 6. 万一打不出中文常见问题im-config-nfcitx5# 强制设为默认fcitx5-r# 重启输入法2.8 设置系统代理可选进入设置 → “网络” → “代理”启用网络代理“配置勾选手动”“URL填写代理IP地址只填IP前面不要加HTTP”“HTTPS”端口填写代理端口2.9 安装 curl确保网络工具完整sudoaptinstallcurl-y2.10 设置屏幕节能优化虚拟机性能# 禁用屏幕休眠gsettingssetorg.gnome.desktop.session idle-delay0# 禁用屏幕锁定gsettingssetorg.gnome.desktop.screensaver lock-enabledfalse# 禁用自动挂起gsettingssetorg.gnome.settings-daemon.plugins.power sleep-inactive-ac-typenothing2.11 系统快照1在完成 Ubuntu 基础配置后创建第一个系统快照ESXi 快照登录 ESXi Web 管理界面选择虚拟机 → 操作 → 快照 → 生成快照命名Ubuntu-24.04-基础配置完成描述Ubuntu 24.04 基础安装 虚拟机工具 SSH 中文输入法 Snap清理QNAP Virtualization Station 快照登录 QNAP NAS 管理界面进入 Virtualization Station选择虚拟机 → 快照 → 撷取快照设置快照名称和描述三、OpenClaw 安装与完整配置3.1 安装 OpenClaw官方一键安装# 使用官方安装脚本最简单、最稳定curl-fsSLhttps://openclaw.ai/install.sh|bash# 验证安装openclaw--version3.2 设置 OpenClaw 模型和通道# 运行初始化向导正常情况下会自动运行# 注意仅在官方安装过程意外打断时才需要手动运行以下命令# openclaw onboard --install-daemon正常安装流程运行官方安装脚本后会自动启动初始化向导安全提示→ 输入YesOnboarding mode→ 选择QuickStartGateway 绑定地址→ 默认127.0.0.1:18789AI Model Provider→ 选择你的模型如 Ollama、通义千问、Kimi、OpenAI、ClaudeAPI Key→ 输入对应模型的 API KeySearch provider→Skip for now先不配置联网搜索Channels→Skip for now后面单独配 QQSkills→ 全不选先保证基础可用3.3 测试 TUI终端用户界面# 启动 Gateway 服务openclaw gateway start--daemon# 检查服务状态openclaw gateway status# 测试 TUIopenclaw tui3.4 设置 WebUI 局域网访问编辑配置文件~/.openclaw/openclaw.jsongateway:{mode:local,auth:{mode:token,token:71080334b32ac6ab59d28632209af727d5519d3900xxxxxx# 系统会自动创建或替换为你自己的},port:18789,bind:lan,tailscale:{mode:off,resetOnExit:false},controlUi:{allowInsecureAuth:true,dangerouslyDisableDeviceAuth:true,allowedOrigins:[http://localhost:18789,http://127.0.0.1:18789,http://192.168.1.x:18789# 替换为你的局域网IP]}}重启服务使配置生效openclaw gateway restart3.5 安装 clawskill 工具# 安装 clawskill 工具npminstall-gopenclaw/clawskill# 验证安装clawskill--version3.6 安装 skillhub 工具# 安装 skillhub 工具npminstall-gopenclaw/skillhub# 验证安装skillhub--version# 如果提示命令未找到添加路径到系统echoexport PATH$HOME/.local/bin:$PATH~/.bashrcsource~/.bashrc3.7 设置网络搜索准备好 API KEY# 配置搜索提供商openclaw config# 按向导一步步配置# 或openclaw configsetsearch.providertavilyopenclaw configsetsearch.tavily.apiKey你的Tavily_API_KEY# 或使用其他搜索提供商openclaw configsetsearch.providerbraveopenclaw configsetsearch.brave.apiKey你的Brave_API_KEY3.8 常用 skill 设置、启用# 安装思源笔记相关技能三个技能都需要clawhubinstallsiyuan-notes-skill# 思源笔记核心技能clawhubinstallsiyuan-skill# 思源笔记命令行工具clawhubinstallsiyuan-task-skill# 思源笔记任务管理# 安装其他常用技能clawhubinstallfile-manager# 文件管理clawhubinstallself-improvement# 自我改进# 启用技能如果未自动启用openclaw skillsenablesiyuan-notes-skill openclaw skillsenablesiyuan-skill openclaw skillsenablesiyuan-task-skill openclaw skillsenablefile-manager openclaw skillsenableself-improvement3.9 安装微信 channel 插件# 安装微信 channel 插件npx-ytencent-weixin/openclaw-weixin-clilatestinstall# 按照提示微信扫码绑定# 1. 运行命令后会显示二维码# 2. 使用微信扫描二维码# 3. 确认绑定# 或手动配置微信 channelopenclaw channelsadd--channelweixin3.10 配置 QQ 机器人获取 QQ 机器人 AppID 和 AppSecret访问 QQ 开放平台https://q.qq.com/注册开发者账号创建机器人应用获取 AppID 和 AppSecret配置 OpenClaw QQ 机器人# 按向导设置 QQ 机器人插件openclaw config# 特殊情况# 启用插件openclaw pluginsenableopenclaw-qqbot# 配置 QQ 通道openclaw channelsadd--channelqqbot# 按照提示输入配置信息# - AppID: 从 QQ 开放平台获取# - AppSecret: 从 QQ 开放平台获取3.11 局域网访问配置为了确保局域网内其他设备可以访问 OpenClaw Control UI需要进行以下配置检查防火墙设置# 查看防火墙状态sudoufw status# 如果防火墙启用放行 18789 端口sudoufw allow18789/tcpsudoufw reload验证网络连通性# 在 OpenClaw 主机上查看 IP 地址ipa|grepinet# 从局域网其他设备测试连接telnet192.168.1.x18789# 替换为 OpenClaw 主机 IP配置浏览器访问在局域网其他设备的浏览器中访问http://192.168.1.x:18789输入配置文件中设置的 Token如果提示 Origin 错误确保 IP 地址已添加到allowedOrigins列表中多设备访问优化allowedOrigins:[http://localhost:18789,http://127.0.0.1:18789,http://192.168.1.100:18789,# 设备1IPhttp://192.168.1.101:18789,# 设备2IPhttp://192.168.1.102:18789# 设备3IP]3.12 main 七个配置文件设置示例配置在~/.openclaw/workspace/目录下配置七个核心文件以下是示例配置请根据实际情况调整1. SOUL.md - Agent 灵魂配置# Agent 灵魂配置定义核心能力、定位与行为准则 soul: name: 主助手 role: 统筹调度者 description: OpenClaw 核心主助手负责多 Agent 协同调度、技能管理、平台交互与自我持续优化 capabilities: - 多 Agent 协同调度 - 技能全生命周期管理 - QQ 平台管理 - 自我持续优化 - 思源笔记存档 behavior: 严谨、高效、安全优先保障任务调度的合理性与技能使用的安全性 core_value: 统筹协同、安全高效、持续进化、完整存档2. USER.md - 用户交互配置# 用户交互配置定义与用户的交互规则 user: name: your_name # 替换为你的用户名 what_to_call: 你的称呼 # 替换为希望被称呼的方式 timezone: Asia/Shanghai language: zh-CN response_format: markdown timeout: 30s max_retries: 3 prompt_template: 你好我是OpenClaw主助手已准备就绪请告诉我你的需求。 error_response: 抱歉当前操作失败请检查网络连接或重试。3. AGENTS.md - Agent 协同与技能权限配置# Agent 协同与技能权限配置 agents: - id: avatar enable: true description: 任务执行分身负责后台计算、文件处理、平台交互、代码执行等具体任务 - id: knowledge enable: true description: 知识库代理负责事实核查、知识检索、笔记管理 policy: default_delegate: avatar # 默认委派目标分身avatar knowledge_query_auto: true # 自动查询知识库knowledge only_assistant_can_delegate: true # 仅主助手可委派任务 cross_call_allowed: false # 禁止跨 Agent 擅自调用 # 技能权限与配额 allowed_skills: - agent-orchestrate - skillhub-preference - skill-creator - skill-vetter - qqbot-channel - nas-agent-sync - self-improvement - file-manager forbidden_skills: - * # 兜底禁止所有未授权技能4. HEARTBEAT.md - 心跳检测配置# 心跳检测配置确保 Agent 正常存活与通信 heartbeat: interval: 10s # 心跳发送间隔10 秒 timeout: 5s # 心跳响应超时时间5 秒 retry_count: 3 # 心跳失败重试次数3 次 reconnection: true # 心跳失败后自动重连 log_level: info # 心跳日志级别info仅记录关键信息 alert_threshold: 5 # 连续 5 次心跳失败触发告警 alert_target: assistant-admin # 告警接收对象 heartbeat_message: assistant is running normally # 正常心跳消息 failure_message: assistant heartbeat failed, reconnecting... # 心跳失败消息5. IDENTITY.md - Agent 身份标识配置# Agent 身份标识配置唯一标识 Agent 信息 identity: agent_id: assistant-001 # 唯一 Agent ID agent_name: 主助手 # Agent 名称 alias: [main] # 别名 version: 2026.4.12 # 版本 creator: OpenClaw # 创建者 create_time: 2026-04-12 # 创建时间 update_time: 2026-04-12 # 最后更新时间 type: main # Agent 类型主助手main status: ready # Agent 状态就绪ready unique_key: openclaw-assistant-core # 唯一标识密钥 description: OpenClaw 核心主助手统筹调度分身与知识库负责技能管理、平台交互与自我进化6. BOOTSTRAP.md - 启动加载配置# 启动加载配置定义 Agent 启动时加载的内容 bootstrap: enable: true # 启用启动加载 bootstrap_skills: [agent-orchestrate, skillhub-preference, self-improvement] # 启动自动加载的核心技能 bootstrap_tools: [chat, file_read, skill_manage] # 启动自动加载的核心工具 init_script: echo assistant bootstrap completed # 启动初始化脚本 load_timeout: 15s # 启动加载超时时间15 秒 retry_load: true # 加载失败自动重试 fallback_skills: [] # 加载失败备用技能无 post_bootstrap_action: notify: assistant is ready to use # 启动完成后动作通知用户7. TOOLS.md - 工具权限配置# 工具权限配置工具列表与能力限制 tools: - chat # 聊天交互工具基础交互 - agent_orchestrate # 多Agent调度工具 - skill_manage # 技能管理工具 - qqbot_channel_api # QQ频道管理工具 - nas_sync # NAS同步工具 - self_improve # 自我进化工具 - file_read # 文件读取工具 # 能力限制锁死权限不允许高危操作 allow_write: false # 禁止写入文件避免误操作 allow_exec: false # 禁止执行代码/脚本代码执行由分身负责 allow_network: false # 禁止主动联网联网由分身负责 allow_system: false # 禁止修改系统配置保障安全 allow_cross_agent: true # 允许调度指定Agentavatar/knowledge allow_delete: false # 禁止删除文件/数据避免误删 allow_skill_install: true # 允许安装/管理技能主助手核心权限配置文件说明SOUL.md定义 Agent 的核心定位和行为准则USER.md定义与用户的交互规则和个性化设置AGENTS.md配置多 Agent 协同机制和技能权限HEARTBEAT.md确保 Agent 正常运行的监控机制IDENTITY.mdAgent 的唯一身份标识BOOTSTRAP.mdAgent 启动时的初始化配置TOOLS.md工具使用权限和安全限制重要提示以上为示例配置请根据实际需求调整各参数。3.13 多 Agent 设置# 添加 Agentopenclaw agentaddxxx# 按向导一步步设置# 检查 Agent 状态openclaw agents list# 配置 Agent 通信openclaw configsetagents.avatar.enabledtrueopenclaw configsetagents.knowledge.enabledtrueopenclaw configsetagents.coordination.enabledtrue3.14 系统快照2在完成 OpenClaw 完整配置后创建第二个系统快照ESXi 快照登录 ESXi Web 管理界面选择虚拟机 → 操作 → 快照 → 生成快照命名OpenClaw-完整配置完成描述OpenClaw 完整安装 模型配置 QQ机器人 技能管理 多Agent设置QNAP Virtualization Station 快照登录 QNAP NAS 管理界面进入 Virtualization Station选择虚拟机 → 快照 → 撷取快照设置快照名称和描述四、系统优化与维护4.1 定期维护命令# 更新系统sudoaptupdatesudoaptupgrade-y# 更新 OpenClawopenclaw update# 或curl-fsSLhttps://openclaw.ai/install.sh|bash# 更新插件openclaw plugins update--all# 更新技能clawhub update--all# 清理缓存sudoaptautoremove-ysudoaptautoclean4.2 监控与日志# 查看 Gateway 日志openclaw gateway logs# 查看系统资源使用htop# 查看网络连接ss-tulpn# 查看磁盘使用df-h4.3 故障排除问题1OpenClaw 安装失败# 清理 npm 缓存npmcache clean--force# 重新安装curl-fsSLhttps://openclaw.ai/install.sh|bash问题2Gateway 服务无法启动# 检查端口占用sudolsof-i:18789# 停止占用进程sudokill-9PID# 重新启动openclaw gateway start问题3局域网无法访问# 检查防火墙sudoufw status# 放行端口sudoufw allow18789/tcp# 检查绑定地址openclaw config get gateway.bind五、安全建议5.1 安全配置修改默认 Token在配置文件中使用强密码限制访问 IP仅允许局域网内特定 IP 访问启用 HTTPS配置 SSL 证书定期更新保持系统和软件最新5.2 备份策略# 备份 OpenClaw 配置tar-czfopenclaw-backup-$(date%Y%m%d).tar.gz ~/.openclaw/config/# 备份重要数据sudotar-czfsystem-backup-$(date%Y%m%d).tar.gz /etc/openclaw/ /var/lib/openclaw/六、性能优化虚拟机资源调整CPU: 根据负载调整核心数内存: 监控使用情况适当增加磁盘: 使用 SSD 提升 I/O 性能网络: 配置虚拟交换机优化网络七、结语通过本文的详细步骤您可以在 ESXi 虚拟机或 QNAP NAS Virtualization Station 上成功部署 Ubuntu 24.04 并完整安装配置 OpenClaw。确保了系统稳定性彻底清理 Snap保障中文输入法等系统功能正常虚拟机兼容性正确区分 ESXi 和 QNAP Virtualization Station 的虚拟机工具功能完整性包含 Ubuntu 基础配置、OpenClaw 完整安装、QQ机器人配置、微信机器人配置、技能管理等所有步骤配置规范性七个核心配置文件完整设置多 Agent 架构正确配置