openclaw logs
通过 RPC 拉取 Gateway 文件日志，支持远程模式（无需 SSH）。
用法
openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"选项
| 参数 | 默认值 | 说明 |
|---|---|---|
--limit <n> | 200 | 最大返回行数 |
--max-bytes <n> | 250000 | 最大读取字节数 |
--follow | false | 持续跟踪日志流 |
--interval <ms> | 1000 | --follow 轮询间隔 |
--json | false | 输出行分隔 JSON 事件 |
--plain | false | 纯文本，无样式 |
--no-color | false | 禁用 ANSI 颜色 |
--local-time | false | 时间戳转换为本地时区 |
Gateway RPC 共享选项
--url <url>：Gateway WebSocket URL--token <token>：Gateway token--timeout <ms>：超时（默认 30000）--expect-final：等待 agent 类调用的最终响应
传入 --url 时不自动应用配置或环境变量凭证，需显式传 --token。
关键行为
- 本地回退：隐式本地 loopback Gateway 要求配对、连接关闭或超时时，自动回退到配置的 Gateway 文件日志；显式
--url不触发此回退 - 自动重连：
--follow模式下，WebSocket 断开后指数退避重连（最多 8 次，间隔上限 30s），重连成功后打印[logs] gateway reconnected；--json模式下重试和重连事件以{"type":"notice"}形式输出到 stderr - 认证失败、配置错误等不可恢复错误仍立即退出