跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw logs

通过 RPC 追踪 Gateway 网关文件日志（适用于远程模式）。 相关：

​
选项

  • --limit <n>：要返回的最大日志行数（默认 200）
  • --max-bytes <n>：从日志文件读取的最大字节数（默认 250000）
  • --follow：跟随日志流
  • --interval <ms>：跟随时的轮询间隔（默认 1000）
  • --json：输出按行分隔的 JSON 事件
  • --plain：不带样式格式的纯文本输出
  • --no-color：禁用 ANSI 颜色
  • --local-time：按你的本地时区渲染时间戳

​
共享 Gateway 网关 RPC 选项

openclaw logs 也接受标准 Gateway 网关客户端标志：
  • --url <url>：Gateway 网关 WebSocket URL
  • --token <token>：Gateway 网关令牌
  • --timeout <ms>：超时时间，单位为 ms（默认 30000）
  • --expect-final：当 Gateway 网关调用由智能体支持时，等待最终响应
传入 --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 --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

​
备注

  • 使用 --local-time 按你的本地时区渲染时间戳。
  • 如果隐式 local loopback Gateway 网关要求配对、在连接期间关闭，或在 logs.tail 应答之前超时，openclaw logs 会自动回退到已配置的 Gateway 网关文件日志。显式 --url 目标不会使用此回退。
  • 使用 --follow 时，临时性 gateway 断开（WebSocket 关闭、超时、连接中断）会触发带指数退避的自动重连（最多 8 次重试，尝试间隔上限为 30 s）。每次重试都会向 stderr 打印警告，轮询成功后会打印一次 [logs] gateway reconnected 通知。在 --json 模式下，重试警告和重连转换都会作为 {"type":"notice"} 记录输出到 stderr。不可恢复的错误（认证失败、配置错误）仍会立即退出。

​
相关