openclaw node でリモートマシンをエージェントの実行環境にする

開発を進めていると、特定のコマンドをリモートの Linux サーバーやラボのマシンで実行したい場面が出てきます。しかし、すべてのマシンにデスクトップアプリをインストールするのは現実的ではありません。ヘッドレスで動作し、必要なコマンドだけを安全に実行できる環境が求められます。

openclaw node を使えば、Gateway に接続するヘッドレスな Node Host を起動できます。これにより、エージェントがネットワーク内の他のマシンで system.run や system.which を実行できるようになります。

必要なもの

5分で Node Host をセットアップして接続する方法を紹介します。

まずはフォアグラウンドで実行して、接続を確認します。

openclaw node run --host <gateway-host> --port 18789

利用可能なオプション：

初回接続時、Gateway 側でペアリングリクエストが保留状態になります。Gateway 側で以下のコマンドを実行して承認してください。

openclaw nodes pending
openclaw nodes approve <requestId>

承認されると、Node Host の情報は ~/.openclaw/node.json に保存されます。

動作確認ができたら、バックグラウンドで動作するサービスとしてインストールするのがおすすめです。

openclaw node install --host <gateway-host> --port 18789

サービス管理コマンド：

Node Host は、browser.enabled が無効化されていない限り、自動的に Browser Proxy をアドバタイズします。これにより、エージェントは追加設定なしでその Node 上でブラウザ自動化を利用できます。

もし Node 上で無効にしたい場合は、設定ファイルで以下のように記述します。

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

system.run の実行は、ローカルの Exec approvals によって保護されています。アクセス権限は明示的にスコープを絞って管理できます。

Gateway 側で openclaw nodes pending を実行し、リクエストが届いているか確認してください。リクエストが存在する場合は、openclaw nodes approve <requestId> で承認が必要です。

実行しようとしているコマンドが ~/.openclaw/exec-approvals.json で許可されているか確認してください。エージェントごとの Allowlist 設定が正しく行われている必要があります。

質問がある場合や、さらに詳しい設定方法を知りたい場合は AI Setup Assistant を活用してください。

OpenClaw Expert

このページで解決しない場合は、OpenClaw Expertに直接質問してください。