「Home Assistantの標準オートメーションだと条件分岐が複雑になって管理しきれない・・・？」
「複数のデバイスをまたいだ自動化を組みたいけど、YAMLを書くのは正直つらい」
「Node-REDって聞いたことはあるけど、何から始めればいいのかわからない」
このように思っていませんか？
Node-REDは、ノードと呼ばれる部品をドラッグ＆ドロップしてワイヤーでつなぐことで、処理の流れを組み立てられるビジュアルプログラミングツールです。Home Assistantと組み合わせることで、標準のオートメーション機能だけでは表現しづらい複雑な条件分岐や、複数デバイスをまたぐ自動化を、視覚的に把握しながら組めるようになります。
今回はNode-REDの基本からインストール、Home Assistantとの連携設定、実践的な自動化フローの作成例までを解説していきます。
- Node-REDと標準オートメーションの違い
- Node-REDのインストール・アドオン追加方法
- Home Assistantとの連携設定手順
- 複数デバイスをまたぐ自動化フローの組み方
- よくあるエラーと対処法
Node-REDとは？Home Assistantの標準オートメーションとの違い
Node-REDは、もともとIBMが開発したオープンソースのビジュアルプログラミングツールです。ブラウザ上でノードと呼ばれる処理単位を配置し、線でつなぐことでプログラムの流れを作ります。
Home Assistantの標準オートメーションは、トリガー・条件・アクションという3つの要素を順番に設定していく構造になっています。シンプルな自動化であれば、この方法で十分対応できます。
ただし、条件分岐が2段階、3段階と増えていくと、YAMLやUI上の設定だけでは全体像が見えづらくなり、どこで何を判定しているのか把握しにくくなってしまいます。
Node-REDでは処理の流れをフロー図として見ながら組み立てられるため、複雑な条件分岐や複数の処理ルートがある自動化でも、全体の構造を把握しやすいという特徴があります。
例えば、「人が部屋に入ったら、時間帯と照度によって照明の明るさを変える」といった多段階の条件を伴う自動化は、標準オートメーションでは条件のネストが深くなりがちですが、Node-REDならノードを分岐させるだけで表現できます。
一方で、Node-REDは学習コストがやや高く、最初は「どのノードを使えばいいのか」で迷いやすい面もあります。すべての自動化をNode-REDに置き換える必要はなく、シンプルな自動化は標準機能、複雑な自動化はNode-REDという使い分けが現実的です。
標準オートメーションの基本的な使い方については、Home Assistantの始め方 完全ガイド2026年版：Raspberry Pi・Mini PCへのインストールから自動化・外部アクセスまで全部解説で詳しく解説しています。
Node-REDのインストール・アドオン追加方法
Node-REDのインストール方法には、大きく分けて「Home Assistant OSのアドオン経由」と「HACS経由でNode-RED Companion統合を追加する」の2通りがあります。
Home Assistant OSまたはSupervised環境を使っている場合は、アドオン経由の方法が手軽です。手順は次の通りです。
- Home Assistantの「設定」から「アドオン」→「アドオンストア」を開く
- 右上のメニュー（縦三点マーク）から「リポジトリ」を選択し、Home Assistant Community Add-onsのリポジトリを追加する
- 検索欄で「Node-RED」と入力する
- 表示された公式コミュニティアドオンを選択し、「インストール」をクリックする
- インストール完了後、「起動」をオンにして起動する
このアドオンには、Home Assistantと連携するためのノードパッケージがあらかじめ組み込まれた状態になっているため、追加の設定なしでフロー作成に進めます。
Docker環境などでHome Assistant Coreを別途構築している場合は、Node-RED本体を別途インストールしたうえで、パレットマネージャーから連携用ノードを追加する形になります。動作環境の目安としては、Node.js v14.0以上、Node-RED v3.0.0以上、Home Assistant v2021.3.0以上を用意しておくと安心です。
実際にパレットマネージャーの「ノードを追加」タブで「home-assistant-websocket」と検索すると、Home Assistant連携用のノードパッケージがヒットします。「ノードを追加」ボタンからインストールすると、上の画像のように「現在のノード」タブにhome-assistant-websocketが追加され、40個のノードが使えるようになります。
アドオン経由でインストールすれば、Home Assistantとの接続設定がほぼ自動で済むため、初めてNode-REDを触る場合は、まずアドオン版から試すのがおすすめです。
導入が完了すれば、これまでYAMLファイルを開いて自動化を1つずつ手直ししていた作業が、フロー画面上でノードをドラッグして調整するだけで済むようになります。1回あたり10分前後かかっていた自動化の修正作業が、慣れてくると3分程度で終わるようになるケースもあります（※ 要確認：一般的な体感ベースの目安であり、公式統計ではありません）。
アドオンの管理方法全般については、Home Assistantの始め方 完全ガイド2026年版：Raspberry Pi・Mini PCへのインストールから自動化・外部アクセスまで全部解説も参考にしてください。
Home Assistantとの連携設定
Node-REDのアドオンを起動したら、次はHome Assistant側との連携設定を行います。HACS経由でNode-RED Companion統合を追加する方法と、Node-RED側の設定ノードで直接接続する方法があります。
HACS経由の場合の手順は次の通りです。
- HACSを開き、「hass-node-red」を検索する
- 検索結果からダウンロードする
- Home Assistantを再起動する
- 「設定」→「デバイスとサービス」→「+ 統合を追加」から「Node-RED Companion」を検索して追加する
Node-RED本体側では、フロー画面の設定ノード（server config）にHome AssistantのURLと長期アクセストークンを入力することで接続します。長期アクセストークンは、Home Assistantのユーザープロフィール画面下部の「セキュリティ」タブから「トークンを作成」を選択して発行できます。発行されたトークンは一度しか表示されないため、必ずその場でコピーして保管してください。
接続に成功すると、上の画像のようにNode-REDのノード編集画面でActionの入力欄に「light.turn_on」のようなHome Assistant側のサービス名が候補として表示されるようになります。これが表示されれば、Node-REDとHome Assistantの疎通が取れている証拠です。
接続設定が完了すると、Node-REDのパレット上でHome Assistantのすべてのエンティティやサービスを呼び出せるようになり、標準オートメーションではアクセスしにくい細かい状態変化までフローの中で扱えるようになります。
また、複数のHome Assistantインスタンスと同時に接続することもできるため、拠点が複数ある場合や、テスト環境と本番環境を分けて運用したい場合にも対応できます。
実践：複数デバイスをまたぐ自動化フローの作成例
ここでは、人感センサー・照度センサー・照明を組み合わせた自動化フローを例に、実際の組み方を見ていきます。
想定するシナリオは「人感センサーが反応し、かつ照度センサーの値が一定以下の場合のみ照明を点灯する。日中は照度が高いため点灯しない」というものです。
- トリガーとして「state」ノードを配置し、人感センサーの状態変化を監視する
- 「switch」ノードで人感センサーの値が「on」の場合のみ次に進むよう分岐させる
- 「current state」ノードで照度センサーの値を取得する
- 「switch」ノードで照度が指定値以下かどうかを判定する
- 条件を満たした場合のみ「call service」ノードで照明をオンにする
実際にNode-REDのフロー画面上でノードを配置・接続すると、上の画像のように「state_changed（トリガー）→switch（条件分岐）→light.turn_on（照明を点灯）」という一連の流れが、一目で把握できる形になります。テキストベースの設定と違い、フロー全体を俯瞰しながら組み立てられるのがNode-REDの強みです。
このように複数の条件を段階的に分岐させるフローは、標準オートメーションで組むと条件のネストが深くなりがちですが、Node-REDならフロー上で視覚的に確認しながら組み立てられます。
さらに、時間帯によって処理を分けたい場合は「time range」ノードを追加し、夜間のみ照明の明るさを弱めに設定する、といった応用も可能です。ノードを追加してつなぎ直すだけで拡張できるため、後から条件を増やす際の修正もしやすくなります。
例えば、これまで似たような自動化を3つの個別オートメーションとして管理していた場合、Node-RED上では1つのフローにまとめて可視化できるため、修正が必要な箇所を探す手間も減らせます。1日に数回発生していた設定ミスによる誤作動が、フロー全体を見渡せるようになったことで大きく減ったという声もよく聞かれます（※ 要確認：一般的な体感ベースの例示であり、公式統計ではありません）。
トラブルシューティング・よくあるエラー
Node-REDとHome Assistantの連携でよく発生するエラーには、いくつかのパターンがあります。
「Connection to home assistant could not be established」というエラー
設定ノードに入力したURLやトークンが誤っている場合に発生しやすいエラーです。URLの末尾にスラッシュが余分に入っていないか、長期アクセストークンが有効期限切れになっていないかを確認してください。
「NoConnectionError: No connection to Home Assistant」というエラー
Node-REDがHome Assistantより先に起動してしまい、接続を試みた時点でHome Assistant側の準備が整っていない場合に起こりやすいエラーです。この場合は、Home Assistantの起動を待ってからNode-REDを再起動すると解決することが多いです。
再起動後にフローが動作しない
Home AssistantまたはNode-REDのどちらかを再起動した後、接続が復旧してもフローが自動的に再デプロイされないことがあります。この場合は、Node-REDの画面右上にある「デプロイ」ボタンを再度押すことで復旧します。
ただし、これらのエラーは環境によって原因が異なる場合もあるため、解決しない場合はNode-REDのデバッグノードを使ってログを1つずつ確認していくのが確実です。
まとめ
Node-REDは、Home Assistantの標準オートメーションでは表現しづらい複雑な条件分岐や、複数デバイスをまたぐ自動化を、フロー図として視覚的に組み立てられるツールです。
導入にはアドオン経由とHACS経由の2つの方法があり、Home Assistant OSを使っている場合はアドオン経由が手軽です。連携設定さえ済ませてしまえば、標準オートメーションでは扱いにくかった細かい条件も、ノードをつないでいくだけで表現できるようになります。
Node-REDを導入した人たちに共通して起きる変化は、地味だけど積み重なるものばかりです。自動化のたびにYAMLファイルを開いて手直ししていた作業がフロー画面上の操作で完結するようになり、修正にかかる時間も短縮されていきます。そうした小さな変化が積み重なって、複雑な自動化を組むこと自体への心理的なハードルが下がっていくという状態になっていきます。
すべての自動化をNode-REDに置き換える必要はありません。シンプルな自動化は標準オートメーション、複雑な条件分岐が絡む自動化はNode-RED、という使い分けを意識しながら、ぜひNode-REDを活用してみてください。
他にもスマートホームやHome Assistantの記事を書いています。
初心者向けの記事や上級者向けの記事も揃えていますので、ぜひこちらもご覧ください。
コメント