Ubuntu安装OpenClaw对接小爱：新手完整指南与避坑要点

在仅有4G内存的旧设备上部署Ubuntu系统，常会因显卡驱动兼容性问题导致安装失败。一个有效的解决方案是：在安装引导界面按“e”键，找到包含“quiet splash”的启动参数行，在其末尾添加“nomodeset”以禁用内核级显示模式。安装完成后首次重启，同样需要进入GRUB菜单（通常按Esc或Shift键），在对应启动项中再次临时加入此参数。若需永久生效，可编辑GRUB配置文件：sudo nano /etc/default/grub，在相关行加入“nomodeset”，保存后执行GRUB更新命令。

系统安装后，首要步骤是赋予日常账户sudo权限以执行管理任务：sudo usermod -aG sudo 你的用户名。完成此基础配置后，即可开始搭建OpenClaw运行所需的核心软件栈。

首先确保curl工具就位。为避免snap版本可能存在的路径与权限问题，建议直接使用APT包管理器安装系统原生版本：

sudo snap remove curl
sudo apt install -y curl

接下来安装Node.js运行环境。为便于后续版本管理与切换，推荐通过nvm（Node Version Manager）进行安装。执行以下命令链完成nvm及Node.js的部署：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 安装脚本执行后，请新开终端会话或重载Shell配置以使nvm生效
nvm install 24

若安装过程中因权限问题中断，可尝试重置nvm目录所有权并清除缓存：sudo chown -R $USER:$USER ~/.nvm && rm -rf ~/.nvm/.cache。

部署OpenClaw与智能家居中枢

基础环境就绪后，开始部署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进行自然语言交互。

为实现对物理设备的控制，需要部署智能家居集成平台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执行 -> 智能设备响应”的完整自动化链路。