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 - heat/cool/auto/off
  • ha_climate_set_preset - home/away/eco/boost
  • 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 対応