Guide

Nylas プラグイン用 OpenClaw CLI のインストール

npm から OpenClaw をインストールし、メール、カレンダー、連絡先用の Nylas プラグインを使用する方法。PATH の修正、Windows セットアップ、プラグインのインストール、OpenClaw と Nylas が主要メールプロバイダをサポートする仕組みを解説。

Written by Nick Barraclough Product Manager

Updated May 15, 2026

Verified — CLI 3.1.1 · Gmail, Outlook · last tested April 11, 2026

このガイドの内容

OpenClaw は、 AI 搭載メッセージングアシスタントを構築するためのオープンソース CLI フレームワークです。メール、WhatsApp、iMessage など、さまざまなチャネルにプラグインシステムを通じて接続し、現在 npm で 40 以上のコミュニティメンテナンスパッケージが公開されています。CLI を npm からグローバルインストールし、必要な連携用プラグインを追加して、JSON 設定ファイルで各プラグインを設定します。このガイドの目的は、OpenClaw をインストールし、メール、カレンダー、連絡先用の Nylas プラグインを実行できる状態にすることです。

Nylas ユーザー向けクイックパス

OpenClaw 内で Nylas を最速で動かす方法は、Node.js がインストール済みの新しいマシンで 3 分以内に完了する 7 ステップのシーケンスです。CLI のインストール、Nylas プラグインの追加、エージェントセッションへの信頼設定、メールアカウントに対するテストクエリによる接続検証をカバーしています。

以下の各ステップは単一のコマンドを実行します。config set の呼び出しは OpenClaw の JSON 設定ファイル（~/.openclaw/config.json）に書き込み、ゲートウェイの再起動でアクティブなセッションを失うことなく変更が反映されます。

Nylas API キーをまだお持ちでない場合は、ステップ 5 の前に Nylas アカウントを作成し、API キーを OpenClaw プラグイン設定にコピーしてください。

# 1. OpenClaw をインストール
npm install -g openclaw

# 2. バイナリが PATH にあることを確認
openclaw --version

# 3. Nylas プラグインをインストール
openclaw plugins install @nylas/openclaw-nylas-plugin

# 4. プラグインを信頼し、エージェントセッションにツールを公開
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# 5. Nylas API キーを設定
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# 6. プラグイン設定を再読み込みするためゲートウェイを再起動
openclaw gateway restart

# 7. 連携を確認
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

以降のセクションでは、各インストール手順の詳細、一般的な環境での PATH 修正、 macOS/Linux と Windows の両方のトラブルシューティングについて説明します。

OpenClaw の npm パッケージ名は？

OpenClaw CLI は、スコープなしのパッケージ名 openclaw で npm に公開されています。コア CLI バイナリには @openclaw/ スコーププレフィックスはありません。プラグインは @nylas/openclaw-nylas-plugin のようなスコープ付き名前を使用しますが、CLI 本体はトップレベルの openclaw パッケージからインストールします。このパッケージは 2025 年初頭から npm に公開されており、2026 年 5 月時点で毎週 12,000 回以上ダウンロードされています。

npm install -g openclaw を実行すると、openclaw バイナリが npm のグローバル bin ディレクトリ（通常は $(npm config get prefix)/bin/）に配置されます。

# npm パッケージ名は "openclaw"
npm install -g openclaw

OpenClaw CLI のインストール

OpenClaw CLI のインストールには、Node.js 22.12.0 以降と npm install -g コマンドが必要です。グローバルインストールによりopenclaw バイナリがシステム PATH に配置され、すべてのターミナルセッションで利用可能になります。一般的なブロードバンド接続では、約 45 MB の依存関係をダウンロードし、60 秒以内にインストールが完了します。

まず Node.js のバージョンを確認してください。OpenClaw はネイティブ ES モジュールと Node.js 組み込みテストランナーを使用しており、どちらも最低 Node.js 22.12.0 が必要です。古いバージョンでは構文エラーが発生して起動に失敗します。

# Node.js のバージョンを確認（22.12.0 以上が必要）
node --version

# OpenClaw CLI をグローバルインストール
npm install -g openclaw

# インストールの確認
openclaw --version

バージョン番号が表示されればインストール成功です。"command not found" エラーが出る場合は、npm グローバル bin ディレクトリが PATH に含まれていません。 PATH 修正のトラブルシューティングセクションで直接対処方法を説明しています。

nvm で Node.js を管理しているシステムでは、インストールを実行する前にアクティブな Node バージョンが 22.12.0 以上であることを確認してください：

# nvm で Node.js 22 に切り替え
nvm install 22
nvm use 22

# その後 openclaw をインストール
npm install -g openclaw

システム要件は？

OpenClaw は macOS（Intel および Apple Silicon）、Linux（x64 および arm64）、 Windows 10 以降で動作します。唯一のハード依存は Node.js 22.12.0+ で、約 80 MB のディスク容量が必要です。OpenClaw 自体の依存関係でさらに約 45 MB が追加されます。 CLI は純粋な JavaScript でネイティブアドオンがないため、ネイティブコンパイラツールチェーンは不要です。

プラットフォーム	Node.js インストール	備考
macOS	`brew install node@22`	Apple Silicon と Intel の両方で動作
Ubuntu / Debian	NodeSource または `nvm`	システムの apt パッケージはバージョンが古すぎます
Windows	nodejs.org インストーラー	cmd.exe ではなく PowerShell を使用
WSL	`nvm`	Linux と同じ手順

OpenClaw プラグインのインストール

OpenClaw プラグインは、CLI に新しいツール、連携、コマンドを登録する npm パッケージです。組み込みのプラグインマネージャーがダウンロード、バージョン解決、ツール登録を処理します。 2026 年 5 月時点で、OpenClaw エコシステムにはメール、メッセージング、CRM、開発者ツールをカバーする 40 以上のプラグインが公開されています。各プラグインは数秒でインストールされ、ゲートウェイの再起動後にアクティブになります。

openclaw plugins サブコマンドはプラグインのライフサイクル全体を管理します：インストール、一覧表示、更新、アンインストール。プラグインのインストールや設定変更後は、 openclaw gateway restart を実行してゲートウェイプロセスに新しいプラグイン状態を読み込ませてください。

# プラグインをインストール
openclaw plugins install <package-name>

# 例：メール、カレンダー、連絡先用の Nylas プラグインをインストール
openclaw plugins install @nylas/openclaw-nylas-plugin

# インストールされたことを確認
openclaw plugins list

# 新しいプラグインが読み込まれるようゲートウェイを再起動
openclaw gateway restart

プラグイン管理コマンドリファレンス

コマンド	説明
`openclaw plugins install <pkg>`	npm からプラグインをインストール
`openclaw plugins uninstall <pkg>`	インストール済みプラグインを削除
`openclaw plugins list`	インストール済みプラグインをすべて一覧表示
`openclaw plugins list --json`	プラグインを JSON 形式で一覧表示
`openclaw plugins update <pkg>`	プラグインを最新バージョンに更新
`openclaw plugins update --all`	インストール済みプラグインをすべて更新

インストール済みプラグインの一覧表示

openclaw plugins list コマンドは、インストール済みのすべてのプラグインをバージョン番号とアクティブ/非アクティブステータスとともに表示します。出力は NAME、VERSION、 STATUS の 3 列テーブルです。--json フラグを追加すると、jq にパイプしたりスクリプトで解析できる機械可読 JSON が出力されます。エージェントデプロイ前に必要なプラグインセットを検証する CI チェックに便利です。

プラグインのステータスが "active" の場合、そのツールはエージェントセッションで読み込み済みかつ利用可能です。"inactive" ステータスは、プラグインはインストールされているものの、設定で無効化されているか、前回のゲートウェイ起動時に初期化に失敗したことを意味します。

# インストール済みプラグインをすべて一覧表示
openclaw plugins list

# 出力例：
# NAME                              VERSION  STATUS
# @nylas/openclaw-nylas-plugin      1.2.0    active
# openclaw-whatsapp-bridge          0.9.1    active
# openclaw-imsg                     0.8.3    active

# スクリプティング用の JSON 出力
openclaw plugins list --json

プラグインのアンインストール

openclaw plugins uninstall コマンドは、プラグインの削除と CLI からの全ツール登録解除を一度に行います。インストールとは異なり、アンインストールはゲートウェイの再起動なしで即座に反映されます。プラグインの npm パッケージはローカルの ~/.openclaw/plugins/ ディレクトリから削除され、使用していたディスク容量（依存関係によりプラグインあたり通常 5-15 MB）が解放されます。

インストール時に指定した完全な npm パッケージ名をそのまま渡してください。その後 openclaw plugins list を実行して、プラグインが表示されなくなったことを確認します。

# プラグインをアンインストール
openclaw plugins uninstall @nylas/openclaw-nylas-plugin

# 削除されたことを確認
openclaw plugins list

Windows での OpenClaw

OpenClaw は PowerShell 5.1+ を通じて Windows 10 以降でネイティブに動作します。 Windows でのインストール手順は macOS や Linux と同じです：Node.js 22.12.0 以降をインストールし、npm install -g openclaw を実行します。Node.js Foundation によると、nodejs.org の Windows .msi インストーラーは Node.js と npm をシステム PATH に自動追加するため、ほとんどの場合、手動での PATH 編集なしで OpenClaw のバイナリが利用可能になります。

# Windows PowerShell セットアップ
# 1. https://nodejs.org から Node.js 22+ をインストール（LTS インストーラーを使用）

# 2. PowerShell を開いて Node.js を確認
node --version

# 3. OpenClaw をグローバルインストール
npm install -g openclaw

# 4. 確認
openclaw --version

# 5. EACCES やパーミッションエラーが出る場合は、管理者として PowerShell を実行：
# PowerShell を右クリック → 「管理者として実行」
# その後再度実行: npm install -g openclaw

Windows では、OpenClaw の設定ディレクトリは %USERPROFILE%\.openclaw\ です。プラグインと設定ファイルはこのディレクトリに保存されます。PATH に npm のグローバル bin ディレクトリが含まれていることを確認してください。通常は Node.js インストーラーが自動的に設定します。

オプション：iMessage CLI パスの設定

openclaw-imsg プラグインは、macOS 上で OpenClaw と iMessage を接続します。 macOS のアプリサンドボックスによりバイナリの配置場所が制限されるため、プラグインは iMessage CLI バイナリを自動検出できません。 openclaw config set imsg.cliPath でパスを明示的に設定する必要があります。この追加手順は約 30 秒で完了し、マシンごとに 1 回だけ必要です。

iMessage CLI バイナリ（imsg-cli）は別のオープンソースツールです。 Homebrew でインストールした場合、バイナリは $(brew --prefix)/bin/ 配下にあります。手動インストールの場合、通常は /usr/local/bin/imsg-cli に配置されます。

# iMessage プラグインをインストール
openclaw plugins install openclaw-imsg

# iMessage CLI バイナリのパスを設定
openclaw config set imsg.cliPath "/usr/local/bin/imsg-cli"

# Homebrew で imsg-cli をインストールした場合：
openclaw config set imsg.cliPath "$(brew --prefix)/bin/imsg-cli"

# パスが設定されていることを確認
openclaw config get imsg.cliPath

# iMessage 接続をテスト
openclaw imsg status

imsg.cliPath 設定値は実際のバイナリを指している必要があります。プラグインから "command not found" エラーが出る場合、パスが間違っているか、その場所にバイナリが存在しません。which imsg-cli でシステム上の正しいパスを確認してください。

オプション：WhatsApp 連携

openclaw-whatsapp-bridge プラグインは、OpenClaw を WhatsApp Business API に接続します。Meta の 2025 年決算報告によると、WhatsApp は月間 20 億人以上のアクティブユーザーを抱えています。プラグインは Meta の Cloud API を通じてメッセージの送受信と webhook 登録を処理します。WhatsApp Business アカウントと Meta 開発者ダッシュボードからのアクセストークンが必要です。認証情報が揃っていれば、セットアップは約 5 分で完了します。

3 つの設定値が必要です：アクセストークン、電話番号 ID、ビジネスアカウント ID。 3 つとも Meta Developer Portal の WhatsApp アプリ設定から取得できます。

# WhatsApp ブリッジプラグインをインストール
openclaw plugins install openclaw-whatsapp-bridge

# WhatsApp Business 認証情報を設定
openclaw config set whatsapp.accessToken "YOUR_ACCESS_TOKEN"
openclaw config set whatsapp.phoneNumberId "YOUR_PHONE_NUMBER_ID"
openclaw config set whatsapp.businessAccountId "YOUR_BUSINESS_ACCOUNT_ID"

# 設定を確認
openclaw whatsapp status

# テストメッセージを送信
openclaw whatsapp send --to "+1234567890" --message "Hello from OpenClaw"

電話番号 ID は、エージェントの代わりにメッセージを送信する WhatsApp 番号を識別します。 Meta Developer Portal で生成されたアクセストークンは、Business Settings の System Users ページで永続トークンを作成しない限り 24 時間で期限切れになります。本番デプロイでは、認証エラーを避けるために永続トークンを使用してください。

オプション：exec-approvals.json の設定

OpenClaw の exec 承認システムは、プラグインがマシン上で実行できるシェルコマンドを制御します。exec-approvals.json ファイルは、パターンベースのルールを 3 つのアクション（allow、deny、ask（実行前に確認））で定義します。このファイルがない場合、OpenClaw はすべてのシェルコマンドに対してプロンプトを表示するため、明示的に承認しない限りプラグインは何もサイレントに実行できません。

設定ファイルは macOS と Linux では ~/.openclaw/exec-approvals.json、 Windows では %USERPROFILE%\.openclaw\exec-approvals.json に配置されます。ルールは上から順に評価され、最初にマッチしたパターンが適用されます。以下の例は、 Nylas CLI、curl、ファイル削除をカバーする 3 つのルールを持つ一般的なセットアップです。

// exec-approvals.json の例
{
  "version": 1,
  "rules": [
    {
      "pattern": "nylas *",
      "action": "allow",
      "comment": "Allow all Nylas CLI commands"
    },
    {
      "pattern": "curl *",
      "action": "ask",
      "comment": "Prompt before running curl"
    },
    {
      "pattern": "rm *",
      "action": "deny",
      "comment": "Never allow file deletion"
    }
  ],
  "default": "ask"
}

default フィールドは、ルールにマッチしない場合の動作を制御します。不明なコマンドに対して確認プロンプトを表示する場合は "ask"、明示的に許可されていないものをすべてブロックする場合は "deny"、すべてのプラグインを完全に信頼する場合は "allow" に設定します。ほとんどのユーザーにとって "ask" が最も安全なデフォルトです。

現在の設定は cat で確認するか、OpenClaw のデフォルトにリセットできます。リセットコマンドは、デフォルトアクション ask でカスタムルールなしの出荷時 exec-approvals.json を復元します。

# 現在の exec 承認設定を表示
cat ~/.openclaw/exec-approvals.json

# デフォルトにリセット
openclaw config reset exec-approvals

Nylas プラグインの追加

@nylas/openclaw-nylas-plugin は、OpenClaw にネイティブのメール、カレンダー、連絡先ツールを追加します。Nylas プラグインは、Gmail、Outlook、Exchange、Yahoo、iCloud、 IMAP の 6 つのメールプロバイダを単一の API でサポートします。メッセージの CRUD、カレンダーイベント管理、連絡先検索、添付ファイル処理をカバーする 20 以上のツールを OpenClaw に登録します。

インストールには npm パッケージ名、Nylas API キー（dashboard.nylas.comから取得）、ゲートウェイの再起動が必要です。API キーは OpenClaw のローカル設定ファイルに保存され、マシン外に送信されることはありません。

# Nylas プラグインをインストール
openclaw plugins install @nylas/openclaw-nylas-plugin

# Nylas API キーを設定
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# プラグイン設定を再読み込みするためゲートウェイを再起動
openclaw gateway restart

# プラグインが接続済みアカウントを確認できるか検証
openclaw run "List my connected email accounts" --plugin nylas

マルチアカウントセットアップ、完全なツールリファレンステーブル、プロバイダ固有のトラブルシューティングについては、 OpenClaw Nylas プラグインのインストールガイドを参照してください。

トラブルシューティング：npm install -g 後の "command not found"

npm install -g openclaw の後に "command not found" エラーが出る場合、 npm グローバル bin ディレクトリがシェルの PATH に含まれていないことを意味します。これはインストール後に最も多い問題で、nvm や手動の tarball で Node.js をインストールした Linux と macOS ユーザーの約 5 人に 1 人に影響します。修正方法は、 npm prefix ディレクトリを見つけて、その bin/ サブディレクトリをシェルプロファイルに追加することです。

npm config get prefix を実行してディレクトリを確認します。デフォルトの nvm インストールでは、通常 ~/.nvm/versions/node/v22.x.x がプレフィックスです。openclaw バイナリは <prefix>/bin/openclaw にあります。

# npm がグローバルバイナリをインストールする場所を確認
npm config get prefix

# バイナリは <prefix>/bin/openclaw にあります
# bin ディレクトリを PATH に追加

# bash の場合（~/.bashrc）：
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zsh の場合（~/.zshrc）：
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 動作確認
openclaw --version

nvm を使用している場合、Node バージョンを切り替えるとグローバルプレフィックスが変わります。普段使用する Node バージョンで OpenClaw をインストールしてください。 nvm use 22 && npm install -g openclaw を実行すれば、Node 22 がアクティブなときにバイナリが利用可能になります。

トラブルシューティング：プラグインのインストール失敗

openclaw plugins install でのプラグインインストール失敗は、3 つのカテゴリに分類されます：npm バージョンの不一致、ネットワーク/プロキシエラー、ファイルパーミッションエラー。最も一般的な原因は npm 9 以前の使用です。OpenClaw プラグインが依存する依存関係解決機能が不足しています。npm 10+ はデフォルトで Node.js 22 に同梱されています。以下の手順は、発生頻度順に各障害モードに対処します。

まず Node.js と npm のバージョンを確認してください。両方が最新であれば、npm キャッシュをクリアして再試行します。企業プロキシとファイル所有権の問題はあまり一般的ではありませんが、 OpenClaw GitHub issues トラッカーで報告されるインストール失敗の約 15% を占めています。

# 1. Node.js と npm のバージョンを確認
node --version   # 22.12.0 以上が必要
npm --version    # 10 以上が必要

# 2. npm キャッシュをクリア
npm cache clean --force

# 3. 再度インストールを試行
openclaw plugins install @nylas/openclaw-nylas-plugin

# 4. 企業プロキシの背後にいる場合、npm を設定
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# 5. macOS/Linux でパーミッションエラーが出る場合、npm prefix の所有権を修正
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

トラブルシューティング：プラグインがインストール済みなのに読み込まれない

openclaw plugins list でプラグインが "active" と表示されているのに、エージェントセッション中にそのツールやコマンドが利用できない場合、起動時にプラグインの初期化に失敗した可能性があります。プラグインの必須設定値が不足している場合や、依存関係の競合によりプラグインのエントリポイントが読み込めない場合に発生します。--debug フラグを使用すると、失敗したプラグインの正確なエラーメッセージを含む詳細な初期化ログが stderr に出力されます。

プラグインを再インストールすると、新規ダウンロードが行われ、プラグインのツールが OpenClaw に再登録されます。アンインストール + インストールのサイクルは、ほとんどの接続で 10 秒以内に完了します。

# プラグインエラーのデバッグログを確認
openclaw --debug 2>&1 | grep -i plugin

# 問題のあるプラグインを再インストール
openclaw plugins uninstall <package-name>
openclaw plugins install <package-name>

# 正しく読み込まれることを確認
openclaw plugins list

次のステップ

OpenClaw のインストールと Nylas プラグインの登録が完了し、CLI はメール、カレンダー、連絡先の自動化に使える状態になりました。以下のガイドでは、プラグイン設定の詳細、エージェント構築パターン、よくある OpenClaw の問題のエラー解決について説明しています。

OpenClaw Nylas プラグインのインストール — 型付きスキーマと自動検出でメール、カレンダー、連絡先ツールを追加
Nylas CLI と OpenClaw でパーソナルアシスタントを構築 — シェルコマンドを直接使用する exec ベースのアプローチ
OpenClaw のメールアクセスをセキュアにする — プラグイン許可リスト、認証情報、ポリシー、送信承認のロックダウン
メールとカレンダー用 AI エージェント CLI — カスタムエージェント用のサブプロセスベースのメール・カレンダーツールを構築
OpenClaw CLI エラーの修正 — PATH、npm パーミッション、Node.js バージョン、Windows セットアップの問題を解決
Nylas CLI コマンドリファレンス — すべてのコマンド、フラグ、オプションの完全なリファレンス