Home Assistant 安装并使用 OpenClaw：2026 年最实用教程

前言
OpenClaw（前身 Clawdbot / Moltbot）是一个强大的本地 AI 代理工具，主要基于 Claude 模型，支持通过 Telegram/WhatsApp 等聊天方式控制电脑、调用工具。更重要的是，它能与 Home Assistant 深度集成，实现自然语言控制智能家居、设备巡检、自动生成仪表盘等高级玩法。
本文整理了 2026 年最新、最稳定的两种安装方式，强烈推荐方式一（Add-on 方式）。

一、OpenClaw 简介与优势

• 核心功能：本地运行的 Claude AI 代理，支持工具调用、文件操作、shell 执行
• 与 HA 集成：可直接调用 HA 服务、自然语言控制设备、巡检异常、生成 YAML 仪表盘
• 支持渠道：Telegram、WhatsApp、企业微信等
• 推荐模型：Claude 3.5 / 3.7 / Max 系列（效果最佳）

适用人群：想让 Home Assistant “开口说话”、真正智能化的玩家

二、安装方式对比

方式	难度	推荐指数	适用场景	资源占用
方式一：HA Add-on 安装	★☆☆☆☆	★★★★★	HA OS / Supervised 用户	中等
方式二：独立部署 + ha-mcp 桥接	★★★☆☆	★★★★☆	Docker / NAS / 独立服务器	较低

三、方式一：直接作为 Home Assistant Add-on 安装（最推荐）

3.1 前置条件

• Home Assistant OS 或 Supervised 安装
• 主机内存建议 ≥ 4GB
• 已准备好 Anthropic API Key（Claude）

3.2 安装步骤

1. 进入 设置 → 插件 → 插件商店
   点击右上角 ⋮ → 仓库

2. 添加以下社区仓库（推荐先加稳定版）：

   https://github.com/techartdev/OpenClawHomeAssistant
   

   （想尝鲜可加开发版：https://github.com/techartdev/OpenClawHomeAssistant-dev）

3. 等待列表刷新，搜索 OpenClaw Assistant 或 OpenClaw，点击 安装

4. 安装完成后，进入插件页面 → 启动

5. 首次运行建议通过 插件 Web 终端（或 Ingress）执行初始化：

   openclaw onboard
   

   或带守护进程版：

   openclaw onboard --install-daemon
   

6. 初始化向导配置要点：

   • AI Provider → Anthropic Claude（输入 API Key）
   • Gateway Mode → local
   • Auth Mode → token（会生成 token，记下来）
   • 集成选项 → 勾选 Home Assistant MCP

7. 配置完成后，即可在 Telegram 等渠道与 OpenClaw 对话，直接控制 HA。

优点：开箱即用、随 HA 一起升级、界面友好
缺点：占用 HA 主机资源稍多

四、方式二：独立部署 OpenClaw + ha-mcp 桥接

4.1 前置条件

• Node.js 22+（推荐 nvm 安装）
• Anthropic API Key
• HA 已创建 Long-Lived Access Token（个人资料 → Long-Lived Access Tokens）

4.2 安装 OpenClaw

一键安装（官方推荐）：

curl -fsSL https://openclaw.ai/install.sh | bash

或手动全局安装：

npm install -g openclaw@latest

初始化配置：

openclaw onboard

按向导完成 Claude Key、聊天渠道、内存路径等设置。

4.3 安装并配置 ha-mcp（Home Assistant MCP Server）

项目地址：https://github.com/homeassistant-ai/ha-mcp

常用安装方式：

• pip 安装
• Docker 部署

启动后默认监听 http://localhost:8124（或自定义端口），记录地址。

4.4 在 OpenClaw 中接入 Home Assistant

• 打开 OpenClaw Web UI（默认 http://localhost:18789）
• 或编辑配置文件
• 添加 Integration → Home Assistant
  • base_url：如 http://192.168.1.100:8123
  • token：刚才创建的 Long-Lived Token
  • 或直接使用 MCP 地址（支持更复杂动作）

4.5 快速测试指令（Telegram / WhatsApp 发送）

• “把客厅灯调成暖白 30%”
• “检查所有设备今天是否在线”
• “生成一个新的能源使用仪表盘”

五、进阶玩法推荐

1. 定时巡检：让 OpenClaw 每小时检查设备状态，异常自动推送
2. 仪表盘生成：自然语言描述 → 自动生成 Lovelace YAML 并部署
3. 语音输出：结合 ElevenLabs + HA TTS，让它“开口说话”
4. 个性人设：设置成“浣熊管家”“毒舌AI小弟”等，聊天更有趣

六、安全与注意事项（必看！）

OpenClaw 拥有 shell 执行、文件读写能力，安全性至关重要！

• 不要给 root 权限，建议使用 Docker / LXC 沙盒运行
• API Key、HA token 等敏感信息切勿提交到 git
• 强烈建议开启 gateway token 认证
• 定期检查日志，避免意外执行危险命令

七、常见问题排查

如果遇到报错，直接把错误信息贴出来，可以帮你分析～

祝大家玩得开心，让 Home Assistant 真正“活”过来！🦞✨