OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI 命令

日志

openclaw logs

通过 RPC 持续读取 Gateway 网关文件日志。支持远程模式。

选项

  • --limit <n>：返回的最大日志行数（默认 200）
  • --max-bytes <n>：从日志文件读取的最大字节数（默认 250000）
  • --follow：持续跟踪日志流
  • --interval <ms>：持续跟踪时的轮询间隔（默认 1000）
  • --json：输出每行一个的 JSON 事件
  • --plain：输出不含样式格式的纯文本
  • --no-color：禁用 ANSI 颜色
  • --local-time：以你的本地时区呈现时间戳（默认）
  • --utc：以 UTC 呈现时间戳

共享的 Gateway 网关 RPC 选项

  • --url <url>：Gateway 网关 WebSocket URL
  • --token <token>：Gateway 网关令牌
  • --timeout <ms>：超时时间（毫秒，默认 30000）
  • --expect-final：当 Gateway 网关调用由智能体支持时，等待最终响应

传入 --url 会跳过自动应用的配置凭据；如果目标 Gateway 网关要求身份验证，请显式包含 --token。

示例

bash
openclaw logsopenclaw logs --followopenclaw --dev logs --followopenclaw --profile work logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

所选的根配置文件与 Gateway 网关的滚动日志文件相匹配：默认 配置文件使用 openclaw-YYYY-MM-DD.log，而命名配置文件使用 openclaw-<profile>-YYYY-MM-DD.log（例如 openclaw-dev-YYYY-MM-DD.log）。

回退和恢复行为

  • 如果隐式 local loopback Gateway 网关请求配对、在连接期间关闭，或在 logs.tail 响应前超时，openclaw logs 会自动回退到已配置的 Gateway 网关文件日志。显式的 --url 目标绝不会使用此回退。
  • 隐式本地 Gateway 网关 RPC 失败后，--follow 不会回退到该已配置文件，因为并存的过期文件可能会误导实时日志跟踪。在 Linux 上，如果可用，它会改为按 PID 使用当前用户 systemd 的 Gateway 网关日志（并输出所选来源）；否则会继续重试实时 Gateway 网关。
  • 在 --follow 期间，暂时性断开连接（WebSocket 关闭、超时、连接中断）会触发采用指数退避的自动重连：最多重试 8 次，每次尝试之间最长间隔 30s。每次重试都会向 stderr 输出警告，并在轮询成功后输出一次 [logs] gateway reconnected 通知。在 --json 模式下，两者都会以 {"type":"notice"} 记录的形式输出到 stderr。不可恢复的错误（身份验证失败、配置错误）仍会立即退出。
  • 在 --follow --json 模式下，日志来源转换会以 {"type":"meta"} 记录的形式输出。应按 sourceKind 分别跟踪游标：流可以从 Gateway 网关文件输出（sourceKind: "file"）切换到本地日志回退（sourceKind: "journal"、localFallback: true，以及 service.pid/service.unit），并在恢复后切回 Gateway 网关文件输出。不要假定整个会话始终使用同一个来源或游标，并应容忍恢复过程中重新应用 Gateway 网关文件游标而产生的重复日志行。

相关内容

Was this useful?
On this page

On this page