10 分钟让 AI Agent 连上你的智能家居

你会得到什么

做完这篇教程，你的 AI Agent（Claude Code、Codex 等）就能连上你家的 Home Assistant：查看灯和传感器的状态，在你同意的范围内帮你开关设备。大约 10 分钟，不用写代码。

还没有 Home Assistant？先读 Home Assistant 手册，里面有 Docker 部署教程。

开始之前

• Home Assistant 已经在运行，你能在浏览器里打开它，例如 http://192.168.1.20:8123。
• 你的 Agent 和 Home Assistant 在同一个家庭网络里（比如都在家里这台电脑上）。云端的 Agent 连不到 192.168.x.x 这样的局域网地址。

第 1 步：创建一个长期访问令牌

令牌就像一把专门给 Agent 用的钥匙，不用你的登录密码。

1. 打开 Home Assistant，点左下角的头像。
2. 点安全。
3. 拉到最下面，找到长期访问令牌，点创建令牌。
4. 起个名字，比如 ai-agent，点确定。
5. 立刻复制弹出来的那一长串字符。关掉窗口就再也看不到了。

第 2 步：把任务交给 Agent

把下面这段话复制给你的 Agent，把两处换成你自己的：

Agent 会自己完成这些事：测试连接、把网址和令牌存到你电脑上的一个文件里、告诉你它看到了多少个设备。

第 3 步：试一试

连上之后，用平常说话的方式问它：

• "客厅的灯现在开着吗？"
• "家里有哪些温度传感器？现在各是多少度？"
• "把客厅的灯关了。"

灯和普通开关它会直接做。门锁、警报、车库门这类有安全影响的设备，它会先问你。

常见问题

• 提示 401：令牌复制错了，或者被删除了。回到第 1 步重新创建一个。
• 连接被拒绝或超时：Agent 所在的电脑连不到那个网址。确认它和 Home Assistant 在同一个网络，网址里带上了 :8123。
• 设备名对不上：让它先"列出所有灯"，再告诉你名字，你按它说的名字下指令。

安全提醒

• 令牌能控制你家里的设备，不要发到公开的地方。
• 把令牌单独起个名字，不用的时候回到安全页面删掉它。
• 不要为了让 Agent 连上，就把 8123 端口直接开放到互联网。需要在外面使用，请用 Home Assistant Cloud 或 VPN。

下一步

• 想看这个 Skill 的完整内容或下载：接入 Home Assistant（Skill）
• 想学更多：Home Assistant 手册