ノード

Run a headless node host that connects to gateway WebSocket and exposes

''system.run'' / ''system.which'' on the local machine.

エージェントにネットワーク内の他のコンピュータで

コマンドを実行させたい場合、そこに完全な macOS コンパニオンアプリをインストールせずに

ノードホストを使用します。

一般的な使用例：

- Keep execution sandboxed on the gateway but delegate approved runs to other hosts.

- Provide a lightweight, headless execution target for automation or CI nodes.

Execution remains protected by execution approvals and per-agent allowlists on the

node host, so you can keep command access scoped and explicit.

''browser.enabled'' が false の場合、ノードホストは自動的に

ノード上でブラウザプロキシが無効であることを通知します。これにより、エージェントは

追加の設定なしでそのノード上でブラウザ自動化を使用できます。

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

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

オプション：

- ''--host <host>'': Gateway WebSocket host (default: ''127.0.0.1'')

- ''--port <port>'': Gateway WebSocket port (default: ''18789'')

- ''--tls''：ゲートウェイ接続に TLS を使用する

- ''--tls-fingerprint <sha256>'': Expected TLS certificate fingerprint (sha256)

- ''--node-id <id>'': Override node ID (clears pairing token)

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

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

オプション：

- ''--host <host>'': Gateway WebSocket host (default: ''127.0.0.1'')

- ''--port <port>'': Gateway WebSocket port (default: ''18789'')

- ''--tls''：ゲートウェイ接続に TLS を使用する

- ''--tls-fingerprint <sha256>'': Expected TLS certificate fingerprint (sha256)

- ''--node-id <id>'': Override node ID (clears pairing token)

- ''--display-name <name>'': Override node display name

- ''--runtime <runtime>'': Service runtime (''node'' or ''bun'')

- ''--force''：再インストール/上書き（既にインストールされている場合）

サービスの管理：

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

''openclaw node run'' をフォアグラウンドノードホストとして使用します（サービスなし）。

サービスコマンドは、機械可読な出力のために ''--json'' を受け入れます。

最初の接続は、ゲートウェイで保留中のノードペアリングリクエストを作成します。

以下で承認します：

openclaw nodes pending
openclaw nodes approve <requestId>

ノードホストは、そのノード ID、トークン、表示名、およびゲートウェイ接続情報を

''~/.openclaw/node.json'' に保存します。

''system.run'' はローカル実行承認者によって承認されます：

- ''~/.openclaw/exec-approvals.json''

- ''Execution approvals''

- ''openclaw approvals --node <id|name|ip>'' (edit from gateway)