Ubuntu安装OpenClaw对接小爱音箱详细教程

在仅有4G内存的轻量级服务器上部署智能家居系统，有时会遇到硬件兼容性挑战。例如，当遇到显卡驱动不兼容时，安装Ubuntu系统需要一个小技巧：在启动引导界面按“e”键编辑启动参数，在“quiet splash”后手动添加“nomodeset”选项。安装完成后首次重启，同样需要按Esc或Shift键进入GRUB菜单，再次为启动项临时添加“nomodeset”参数才能顺利进入桌面。若想一劳永逸地解决此问题，只需执行一条命令：sudo nano /etc/default/grub，找到对应配置行进行永久修改，最后更新GRUB引导即可。

系统准备就绪后，首先为日常使用的账户授予管理员权限，以便后续顺畅操作：sudo usermod -aG sudo 你的用户名。接下来，便是搭建OpenClaw智能语音助手所需的核心运行环境。

首先配置curl工具。虽然通过snap安装便捷，但偶尔会遇到路径权限问题，为求稳定，我们改用系统原生包管理方式安装：

sudo snap remove curl
sudo apt install -y curl

接着安装Node.js运行环境。这里强烈推荐使用nvm（Node版本管理器）进行安装与管理，它能让你在不同Node.js版本间灵活切换。安装nvm及Node.js的步骤可连贯执行：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 安装完成后，请新开一个终端会话或重新加载bash配置文件
nvm install 24

如果之前安装过程因权限问题中断，可以尝试修复nvm目录所有权并清理缓存：sudo chown -R $USER:$USER ~/.nvm && rm -rf ~/.nvm/.cache。

部署OpenClaw与智能家居中枢Home Assistant

基础环境配置完成后，主角OpenClaw便可正式部署。请根据你的网络状况选择合适的安装命令：

# 国际网络环境
curl -fsSL https://openclaw.ai/install.sh | bash
# 或使用国内镜像加速安装
npm install -g openclaw-cn@latest

安装成功后，运行初始化配置向导：openclaw-cn onboard --install-daemon。随后，依照官方指引，前往QQ机器人开放平台（https://q.qq.com/qqbot/openclaw/index.html）完成账号绑定与接入，即可实现通过QQ与OpenClaw进行对话交互。

要让OpenClaw具备控制实体家电的能力，还需要部署一个智能家居集成中枢——Home Assistant。使用Docker容器化部署是最高效的方案：

sudo apt update
sudo apt install docker.io -y
sudo systemctl enable --now docker

sudo docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Asia/Shanghai \
  -v /home/你的用户名/homeassistant_config:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

容器启动后，在浏览器中访问 http://你的服务器IP:8123 即可进入Home Assistant的初始化设置界面。

实现联动的关键步骤： 为使OpenClaw能与Home Assistant通信，建议将OpenClaw也部署在Docker容器中，并确保两者处于同一Docker网络内。这样，服务间才能自动发现并建立连接，最终达成通过QQ向OpenClaw发送语音或文字指令，即可控制所有接入Home Assistant的智能灯光、插座、空调等设备，轻松构建低成本、高自由度的个人智能家居系统。