文档
CLI 命令参考
`moltbot node`

`moltbot node`

适用范围

使用本页面当：

  • 运行无头节点主机
  • 为 system.run 配对非 macOS 节点

运行一个无头节点主机，连接到网关 WebSocket 并在此机器上暴露 system.run / system.which。

为什么使用节点主机？

当您希望 agent 在网络中的其他机器上运行命令而不在那里安装完整的 macOS 伴侣应用时，请使用节点主机。

常见用例：

  • 在远程 Linux/Windows 机器上运行命令（构建服务器、实验室机器、NAS）。
  • 在网关上保持 exec 沙盒化，但将批准的运行委托给其他主机。
  • 为自动化或 CI 节点提供轻量级、无头的执行目标。

执行仍然受到节点主机上的 exec 批准和每个 agent 的允许列表的保护，因此您可以将命令访问范围保持明确。

浏览器代理（零配置）

如果在节点上未禁用 browser.enabled，节点主机会自动通告浏览器代理。这允许 agent 在该节点上使用浏览器自动化而无需额外配置。

如需要在节点上禁用它：

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

运行（前台） 

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

选项：

  • --host <host>: 网关 WebSocket 主机（默认：127.0.0.1）
  • --port <port>: 网关 WebSocket 端口（默认：18789）
  • --tls: 对网关连接使用 TLS
  • --tls-fingerprint <sha256>: 预期的 TLS 证书指纹（sha256）
  • --node-id <id>: 覆盖节点 id（清除配对 token）
  • --display-name <name>: 覆盖节点显示名称

服务（后台）

将无头节点主机安装为用户服务。

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

选项：

  • --host <host>: 网关 WebSocket 主机（默认：127.0.0.1）
  • --port <port>: 网关 WebSocket 端口（默认：18789）
  • --tls: 对网关连接使用 TLS
  • --tls-fingerprint <sha256>: 预期的 TLS 证书指纹（sha256）
  • --node-id <id>: 覆盖节点 id（清除配对 token）
  • --display-name <name>: 覆盖节点显示名称
  • --runtime <runtime>: 服务运行时（node 或 bun）
  • --force: 如果已安装，重新安装/覆盖

管理服务：

moltbot node status
moltbot node stop
moltbot node restart
moltbot node uninstall

对前台节点主机使用 moltbot node run（无服务）。

服务命令接受 --json 用于机器可读输出。

配对

第一次连接在网关上创建待处理的节点配对请求。 通过以下方式批准：

moltbot nodes pending
moltbot nodes approve <requestId>

节点主机将其节点 id、token、显示名称和网关连接信息存储在 ~/.moltbot/node.json 中。

Exec 批准

system.run 由本地 exec 批准保护：

  • ~/.moltbot/exec-approvals.json
  • Exec 批准
  • moltbot approvals --node <id|name|ip>（从网关编辑）
`moltbot models``moltbot nodes`