diff --git a/docs/zh-CN/cli/logs.md b/docs/zh-CN/cli/logs.md index 8244eaa12..623779fcd 100644 --- a/docs/zh-CN/cli/logs.md +++ b/docs/zh-CN/cli/logs.md @@ -1,14 +1,14 @@ --- read_when: - 你需要远程实时查看 Gateway 网关日志(无需 SSH) - - 你需要用于工具处理的 JSON 日志行 -summary: '`openclaw logs` 的 CLI 参考(通过 RPC 实时查看 Gateway 网关日志)' + - 你需要用于工具的 JSON 日志行 +summary: CLI 参考,用于 `openclaw logs`(通过 RPC 实时查看 Gateway 网关日志) title: 日志 x-i18n: - generated_at: "2026-04-29T07:14:13Z" + generated_at: "2026-05-03T09:23:00Z" model: gpt-5.5 provider: openai - source_hash: 0f9268fefa4d0e54297fd12c5cef30a1465bd735ae6a36292c279a438285f2b8 + source_hash: a0d3d8cf986d169d484ab80e064383f037688d8d7e9a0def0daeebddf09e95af source_path: cli/logs.md workflow: 16 --- @@ -17,32 +17,32 @@ x-i18n: 通过 RPC 跟踪 Gateway 网关文件日志(适用于远程模式)。 -相关内容: +相关: -- 日志记录概览:[日志记录](/zh-CN/logging) +- 日志概览:[日志](/zh-CN/logging) - Gateway 网关 CLI:[gateway](/zh-CN/cli/gateway) ## 选项 -- `--limit `:返回的最大日志行数(默认 `200`) +- `--limit `:要返回的最大日志行数(默认 `200`) - `--max-bytes `:从日志文件读取的最大字节数(默认 `250000`) -- `--follow`:跟随日志流 -- `--interval `:跟随时的轮询间隔(默认 `1000`) -- `--json`:输出以行为分隔的 JSON 事件 -- `--plain`:不带样式格式的纯文本输出 +- `--follow`:跟踪日志流 +- `--interval `:跟踪时的轮询间隔(默认 `1000`) +- `--json`:输出按行分隔的 JSON 事件 +- `--plain`:无样式格式的纯文本输出 - `--no-color`:禁用 ANSI 颜色 -- `--local-time`:使用你的本地时区渲染时间戳 +- `--local-time`:用你的本地时区渲染时间戳 ## 共享 Gateway 网关 RPC 选项 -`openclaw logs` 也接受标准 Gateway 网关客户端标志: +`openclaw logs` 也接受标准的 Gateway 网关客户端标志: - `--url `:Gateway 网关 WebSocket URL - `--token `:Gateway 网关令牌 -- `--timeout `:超时时间,单位为 ms(默认 `30000`) +- `--timeout `:超时时间,单位为毫秒(默认 `30000`) - `--expect-final`:当 Gateway 网关调用由智能体支持时,等待最终响应 -传入 `--url` 时,CLI 不会自动应用配置或环境凭证。如果目标 Gateway 网关需要身份验证,请显式包含 `--token`。 +当你传入 `--url` 时,CLI 不会自动应用配置或环境凭证。如果目标 Gateway 网关需要认证,请显式包含 `--token`。 ## 示例 @@ -63,9 +63,10 @@ openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN" ## 备注 - 使用 `--local-time` 以你的本地时区渲染时间戳。 -- 如果隐式 local loopback Gateway 网关请求配对、在连接期间关闭,或在 `logs.tail` 应答前超时,`openclaw logs` 会自动回退到已配置的 Gateway 网关文件日志。显式 `--url` 目标不会使用此回退。 +- 如果隐式 local loopback Gateway 网关请求配对、在连接期间关闭,或在 `logs.tail` 响应前超时,`openclaw logs` 会自动回退到已配置的 Gateway 网关文件日志。显式 `--url` 目标不会使用此回退。 +- 使用 `--follow` 时,临时的 gateway 断连(WebSocket 关闭、超时、连接中断)会触发带指数退避的自动重连(最多重试 8 次,每次尝试之间的间隔上限为 30 秒)。每次重试都会向 stderr 打印一条警告。不可恢复的错误(认证失败、配置错误)仍会立即退出。 -## 相关内容 +## 相关 - [CLI 参考](/zh-CN/cli) -- [Gateway 网关日志记录](/zh-CN/gateway/logging) +- [Gateway 网关日志](/zh-CN/gateway/logging)