Skip to main content

​
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 选项

openclaw logs 还接受标准的 Gateway 客户端标志：
  • --url <url>：Gateway WebSocket URL
  • --token <token>：Gateway 令牌
  • --timeout <ms>：超时时间，单位为 ms（默认 30000）
  • --expect-final：当 Gateway 调用由 agent 提供支持时，等待最终响应
当你传入 --url 时，CLI 不会自动应用配置或环境凭据。如果目标 Gateway 需要认证，请显式包含 --token。

​
示例

openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --limit 500
openclaw logs --local-time
openclaw logs --utc
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

​
注意

  • 时间戳默认以你的本地时区显示。使用 --utc 可输出 UTC。
  • 如果隐式的本地回环 Gateway 要求配对、在连接期间关闭，或者在 logs.tail 返回之前超时，openclaw logs 会自动回退到已配置的 Gateway 文件日志。显式 --url 目标不会使用此回退。
  • openclaw logs --follow 在隐式本地 Gateway RPC 失败后，不会继续跟随已配置文件的回退日志。在 Linux 上，它会在可用时按 PID 使用当前用户 systemd 的 Gateway journal，并打印所选日志源；否则它会继续重试实时 Gateway，而不是跟随一个可能过时的并列文件。
  • 使用 --follow 时，临时性的 gateway 断开（WebSocket 关闭、超时、连接丢失）会触发带指数退避的自动重连（最多 8 次重试，两次尝试之间最多间隔 30 秒）。每次重试都会向 stderr 输出一条警告，并且当某次轮询成功时，会输出一次 [logs] gateway reconnected 提示。在 --json 模式下，重试警告和重连状态转换都会作为 {"type":"notice"} 记录输出到 stderr。不可恢复的错误（认证失败、配置错误）仍会立即退出。

​
相关