CLI コマンド

node

このマシン上で system.run / system.which を公開し、ゲートウェイ WebSocket に接続する ヘッドレスノードホスト を実行します。

ノードホストを使用する理由

他のマシンに完全な macOS コンパニオンアプリをインストールせずに、エージェントがネットワーク内の 他のマシンでコマンドを実行 できるようにしたい場合にノードホストを使用します。一般的なユースケース:

実行は依然としてノードホスト上の 実行承認 とエージェントごとの許可リストによって保護されるため、コマンドアクセスを範囲限定かつ明示的に保つことができます。

ノードホストは、ノードで browser.enabled が無効化されていない場合、自動的にブラウザプロキシをアドバタイズします。これにより、エージェントは追加設定なしでそのノード上でブラウザ自動化を使用できます。必要に応じてノードで無効化してください:

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

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

オプション:

ヘッドレスノードホストをユーザーサービスとしてインストールします。

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

オプション:

サービスの管理:

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

フォアグラウンドのノードホスト (サービスなし) には openclaw node run を使用してください。サービスコマンドは機械可読な出力のために --json を受け付けます。

最初の接続時に、ゲートウェイ上で保留中のデバイスペアリングリクエスト (role: node) が作成されます。以下のコマンドで承認してください:

openclaw devices list
openclaw devices approve <requestId>

ノードホストは、そのノード ID、トークン、表示名、およびゲートウェイ接続情報を ~/.openclaw/node.json に保存します。

system.run はローカルの実行承認によって制御されます: