mcpField
O
openclaw-homeassistant

openclaw-homeassistant

github.com/homeofe其他41 次安装
代码仓库

关于 openclaw-homeassistant

openclaw-homeassistant 是用于通过聊天控制 Home Assistant 设备并查看智能家居状态的 OpenClaw 插件。它提供分类设备控制及通用服务和事件操作，并支持只读模式和域限制。

主要功能

  1. 01查看实体、状态和历史记录
  2. 02控制灯、开关和暖通设备
  3. 03管理媒体播放器和窗帘
  4. 04运行场景、脚本和自动化
  5. 05限制写入操作及允许的域

适用场景

  1. 01查看传感器读数和设备状态
  2. 02通过聊天调节灯光或恒温器
  3. 03触发场景或自动化
  4. 04将插件访问范围限制为指定域

MCP 相关

README 描述了 OpenClaw 插件提供的 Home Assistant 工具，但未说明该插件使用 MCP。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/homeofe/openclaw-homeassistant --skill openclaw-homeassistant

安装后在 Claude Code 中输入/openclaw-homeassistant确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CODE_OF_CONDUCT.md
LICENSE
.gitignore
README.md
CONTRIBUTING.md
SECURITY.md
openclaw.plugin.json
package.json
package-lock.json
.ai/handoff/
DASHBOARD.md
LOG.md
NEXT_ACTIONS.md
MANIFEST.json
STATUS.md
.ai/handoff/research/
T-002-home-assistant-js-websocket.md
T-004-architecture-decision.md
T-003-existing-ha-ai-integrations.md
.ai/research/
T-001-ha-api-research.md
.github/
PULL_REQUEST_TEMPLATE.md
dependabot.yml
.github/ISSUE_TEMPLATE/
bug_report.md
feature_request.md
.github/workflows/
auto-publish.yml
codeql.yml
dashboard/
akido-dashboard.yaml
src/
config.ts
client.ts
guards.ts
src/__tests__/
client.test.ts
config.test.ts

详细介绍

openclaw-homeassistant

用于集成 Home Assistant 的 OpenClaw 插件。通过聊天控制整个智能家居。

工具（34 个）

核心
  • ha_status - HA 配置、版本、位置
  • ha_list_entities - 列出实体（按域／状态筛选）
  • ha_get_state - 获取单个实体的状态和属性
  • ha_search_entities - 按名称模式搜索实体
  • ha_list_services - 按域列出可用服务
灯光
  • ha_light_on - 开灯（亮度、色温、RGB、渐变时长）
  • ha_light_off / ha_light_toggle
  • ha_light_list - 列出所有灯光及当前状态
开关
  • ha_switch_on / ha_switch_off / ha_switch_toggle
温控
  • ha_climate_set_temp - 设置温度和 HVAC 模式
  • ha_climate_set_mode - 加热／制冷／自动／关闭
  • ha_climate_set_preset - 在家／外出／节能／增强
  • ha_climate_list - 列出所有温控实体及温度
媒体播放器
  • ha_media_play / ha_media_pause / ha_media_stop
  • ha_media_volume - 设置音量（0.0-1.0）
  • ha_media_play_media - 播放指定媒体
窗帘
  • ha_cover_open / ha_cover_close
  • ha_cover_position - 设置位置（0-100）
场景和自动化
  • ha_scene_activate / ha_script_run / ha_automation_trigger
传感器和历史记录
  • ha_sensor_list - 列出所有传感器及其数值
  • ha_history - 查看实体随时间变化的历史记录
  • ha_logbook - 查看近期日志条目
通用
  • ha_call_service - 调用任意服务
  • ha_fire_event - 触发自定义事件
  • ha_render_template - 渲染 Jinja2 模板
通知
  • ha_notify - 发送通知

配置

{
  "url": "http://your-ha-instance:8123",
  "token": "YOUR_LONG_LIVED_ACCESS_TOKEN",
  "allowedDomains": ["light", "switch", "climate"],
  "readOnly": false
}

安全

  • readOnly：阻止所有写入操作
  • allowedDomains：限制为指定设备域
  • 所有调用都会验证实体 ID

评论

支持 Markdown