发布日期: 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 以上(推荐 16GB),OpenClaw 运行需要较大内存
- 存储: 50GB 以上 SSD 存储,建议使用 NVMe SSD 提升 I/O 性能
- 网络: 千兆网络,建议配置虚拟交换机优化网络性能
- 虚拟化: 确保 ESXi 主机已开启 CPU 虚拟化支持
QNAP NAS Virtualization Station(以 Qu805 为例):
- CPU: ntel® N300 八核心處理器,支持虚拟化技术
- 内存: 标配16GB,Qu805 支持最大单条 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-desktop
- QNAP 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-desktop(VMware 专用)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 远程登录凭据
- 点"连接"
- 可选:配置端口(默认 3389)
2.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|awk'NR>1 {print $1}');dosudosnap remove--purge"$p"done# 第三步:彻底卸载 Snap 服务(让系统再也没有 Snap)sudoaptpurge--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.pref<<'EOF' 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 装任何软件都不会再冒出 Snap
2.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-type'nothing'2.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正常安装流程:
- 运行官方安装脚本后,会自动启动初始化向导
- 安全提示→ 输入
Yes - Onboarding mode→ 选择
QuickStart - Gateway 绑定地址→ 默认
127.0.0.1:18789 - AI Model Provider→ 选择你的模型(如 Ollama、通义千问、Kimi、OpenAI、Claude)
- API Key→ 输入对应模型的 API Key
- Search provider→
Skip for now(先不配置联网搜索) - Channels→
Skip for now(后面单独配 QQ) - Skills→ 全不选(先保证基础可用)
3.3 测试 TUI(终端用户界面)
# 启动 Gateway 服务openclaw gateway start--daemon# 检查服务状态openclaw gateway status# 测试 TUIopenclaw tui3.4 设置 WebUI 局域网访问
编辑配置文件~/.openclaw/openclaw.json:
"gateway":{"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-g@openclaw/clawskill# 验证安装clawskill--version3.6 安装 skillhub 工具
# 安装 skillhub 工具npminstall-g@openclaw/skillhub# 验证安装skillhub--version# 如果提示命令未找到,添加路径到系统echo'export PATH="$HOME/.local/bin:$PATH"'>>~/.bashrcsource~/.bashrc3.7 设置网络搜索(准备好 API KEY)
# 配置搜索提供商openclaw config# 按向导一步步配置# 或:openclaw configsetsearch.provider"tavily"openclaw configsetsearch.tavily.apiKey"你的Tavily_API_KEY"# 或使用其他搜索提供商openclaw configsetsearch.provider"brave"openclaw configsetsearch.brave.apiKey"你的Brave_API_KEY"3.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-y@tencent-weixin/openclaw-weixin-cli@latestinstall# 按照提示微信扫码绑定# 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",# 设备1IP"http://192.168.1.101:18789",# 设备2IP"http://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 # 允许调度指定Agent(avatar/knowledge) allow_delete: false # 禁止删除文件/数据(避免误删) allow_skill_install: true # 允许安装/管理技能(主助手核心权限)配置文件说明:
- SOUL.md:定义 Agent 的核心定位和行为准则
- USER.md:定义与用户的交互规则和个性化设置
- AGENTS.md:配置多 Agent 协同机制和技能权限
- HEARTBEAT.md:确保 Agent 正常运行的监控机制
- IDENTITY.md:Agent 的唯一身份标识
- BOOTSTRAP.md:Agent 启动时的初始化配置
- 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 故障排除
问题1:OpenClaw 安装失败
# 清理 npm 缓存npmcache clean--force# 重新安装curl-fsSLhttps://openclaw.ai/install.sh|bash问题2:Gateway 服务无法启动
# 检查端口占用sudolsof-i:18789# 停止占用进程sudokill-9<PID># 重新启动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 架构正确配置