Skip to Content
👋 欢迎来到 HowToUseMoltbot 快速入门
CLI 参考Gateway 网关

Gateway CLI

作用： 管理并探测网关。启动、停止和调试本地网关。网关是 Moltbot 的 WebSocket 服务（频道、节点、会话、钩子）。所有子命令均在 moltbot gateway … 下。

相关：Bonjour、服务发现、配置。

运行网关

运行本地网关进程：

moltbot gateway

前台别名：

moltbot gateway run

说明：

  • 默认情况下，除非在 ~/.clawdbot/moltbot.json 中设置 gateway.mode=local，网关会拒绝启动。临时/开发运行可使用 --allow-unconfigured。
  • 在无认证情况下绑定到回环以外会被阻止（安全护栏）。
  • 授权时 SIGUSR1 会触发进程内重启（需启用 commands.restart 或使用网关工具/config apply/update）。
  • SIGINT/SIGTERM 会停止网关进程，但不会恢复自定义终端状态。若用 TUI 或 raw-mode 包装 CLI，退出前需自行恢复终端。

选项

  • --port <port>: WebSocket 端口（默认来自配置/环境，通常为 18789）。
  • --bind <loopback|lan|tailnet|auto|custom>: 监听绑定模式。
  • --auth <token|password>: 认证模式覆盖。
  • --token <token>: 令牌覆盖（同时为该进程设置 CLAWDBOT_GATEWAY_TOKEN）。
  • --password <password>: 密码覆盖（同时为该进程设置 CLAWDBOT_GATEWAY_PASSWORD）。
  • --tailscale <off|serve|funnel>: 通过 Tailscale 暴露网关。
  • --tailscale-reset-on-exit: 退出时重置 Tailscale serve/funnel 配置。
  • --allow-unconfigured: 允许在配置中未设置 gateway.mode=local 时启动网关。
  • --dev: 缺失时创建开发配置和工作区（跳过 BOOTSTRAP.md）。
  • --reset: 重置开发配置、凭证、会话和工作区（需配合 --dev）。
  • --force: 启动前终止所选端口上的现有监听。
  • --verbose: 详细日志。
  • --claude-cli-logs: 仅在控制台显示 claude-cli 日志（并启用其 stdout/stderr）。
  • --ws-log <auto|full|compact>: WebSocket 日志样式（默认 auto）。
  • --compact: --ws-log compact 的别名。
  • --raw-stream: 将原始模型流事件记录到 jsonl。
  • --raw-stream-path <path>: 原始流 jsonl 路径。

查询运行中的网关

所有查询命令均通过 WebSocket RPC。输出模式：

  • 默认：人类可读（TTY 下彩色）。
  • --json: 机器可读 JSON（无样式/无 spinner）。
  • --no-color（或 NO_COLOR=1）：禁用 ANSI，保留人类布局。

通用选项（在支持的子命令中）：

  • --url <url>: 网关 WebSocket URL。
  • --token <token>: 网关令牌。
  • --password <password>: 网关密码。
  • --timeout <ms>: 超时/预算（因命令而异）。
  • --expect-final: 等待「最终」响应（代理调用）。

gateway health

moltbot gateway health --url ws://127.0.0.1:18789

gateway status

gateway status 显示网关服务（launchd/systemd/schtasks）及可选的 RPC 探测。

moltbot gateway status
moltbot gateway status --json

选项：

  • --url <url>: 覆盖探测 URL。
  • --token <token>: 探测的令牌认证。
  • --password <password>: 探测的密码认证。
  • --timeout <ms>: 探测超时（默认 10000）。
  • --no-probe: 跳过 RPC 探测（仅服务视图）。
  • --deep: 同时扫描系统级服务。

gateway probe

gateway probe 是「全面调试」命令。始终会探测：

  • 你配置的远程网关（若已设置），以及
  • 本机（回环），即使已配置远程。

若多个网关可达，会全部打印。使用独立 profile/端口（如救援机器人）时可支持多网关，多数安装仍为单网关。

moltbot gateway probe
moltbot gateway probe --json

通过 SSH 远程（与 Mac 应用一致）

macOS 应用的「通过 SSH 远程」模式使用本地端口转发，使远程网关（可能仅绑定回环）在 ws://127.0.0.1:<port> 可达。CLI 等价方式：

moltbot gateway probe --ssh user@gateway-host

选项：

  • --ssh <target>: user@host 或 user@host:port（端口默认 22）。
  • --ssh-identity <path>: 身份文件。
  • --ssh-auto: 选择第一个发现的网关主机作为 SSH 目标（仅 LAN/WAB）。

配置（可选，用作默认）：

  • gateway.remote.sshTarget
  • gateway.remote.sshIdentity

gateway call <method>

底层 RPC 辅助。

moltbot gateway call status
moltbot gateway call logs.tail --params '{"sinceMs": 60000}'

管理网关服务

moltbot gateway install
moltbot gateway start
moltbot gateway stop
moltbot gateway restart
moltbot gateway uninstall

说明：

  • gateway install 支持 --port、--runtime、--token、--force、--json。
  • 生命周期命令支持 --json 便于脚本化。

发现网关（Bonjour）

gateway discover 扫描网关信标（_moltbot-gw._tcp）。

  • 组播 DNS-SD：local.
  • 单播 DNS-SD（广域 Bonjour）：moltbot.internal.（需 split DNS + DNS 服务器；见 Bonjour）

仅启用 Bonjour 发现的网关（默认）会广播该信标。广域发现记录包含（TXT）：

  • role（网关角色提示）
  • transport（传输提示，如 gateway）
  • gatewayPort（WebSocket 端口，通常 18789）
  • sshPort（SSH 端口；未提供时默认 22）
  • tailnetDns（MagicDNS 主机名，如有）
  • gatewayTls / gatewayTlsSha256（启用 TLS + 证书指纹）
  • cliPath（远程安装的可选提示）

gateway discover

moltbot gateway discover

选项：

  • --timeout <ms>: 每命令超时（浏览/解析）；默认 2000。
  • --json: 机器可读输出（同时禁用样式/spinner）。

示例：

moltbot gateway discover --timeout 4000
moltbot gateway discover --json | jq '.beacons[].wsUrl'
最后更新于:
Doctor 诊断Health 健康状态