diff --git a/docs/zh-CN/cli/logs.md b/docs/zh-CN/cli/logs.md index 623779fcd..86889f6a6 100644 --- a/docs/zh-CN/cli/logs.md +++ b/docs/zh-CN/cli/logs.md @@ -1,48 +1,48 @@ --- read_when: - 你需要远程实时查看 Gateway 网关日志(无需 SSH) - - 你需要用于工具的 JSON 日志行 -summary: CLI 参考,用于 `openclaw logs`(通过 RPC 实时查看 Gateway 网关日志) + - 你需要供工具使用的 JSON 日志行 +summary: '`openclaw logs` 的 CLI 参考(通过 RPC 实时跟踪 Gateway 网关日志)' title: 日志 x-i18n: - generated_at: "2026-05-03T09:23:00Z" + generated_at: "2026-05-03T10:00:10Z" model: gpt-5.5 provider: openai - source_hash: a0d3d8cf986d169d484ab80e064383f037688d8d7e9a0def0daeebddf09e95af + source_hash: 89753a18e31cd643e19db80b6cef4ecac1aae0733e68d6c678e6419e28bd270e source_path: cli/logs.md workflow: 16 --- # `openclaw logs` -通过 RPC 跟踪 Gateway 网关文件日志(适用于远程模式)。 +通过 RPC 追踪 Gateway 网关文件日志(适用于远程模式)。 相关: - 日志概览:[日志](/zh-CN/logging) -- Gateway 网关 CLI:[gateway](/zh-CN/cli/gateway) +- Gateway 网关 CLI:[Gateway 网关](/zh-CN/cli/gateway) ## 选项 - `--limit `:要返回的最大日志行数(默认 `200`) - `--max-bytes `:从日志文件读取的最大字节数(默认 `250000`) -- `--follow`:跟踪日志流 -- `--interval `:跟踪时的轮询间隔(默认 `1000`) +- `--follow`:跟随日志流 +- `--interval `:跟随时的轮询间隔(默认 `1000`) - `--json`:输出按行分隔的 JSON 事件 -- `--plain`:无样式格式的纯文本输出 +- `--plain`:不带样式格式的纯文本输出 - `--no-color`:禁用 ANSI 颜色 -- `--local-time`:用你的本地时区渲染时间戳 +- `--local-time`:按你的本地时区渲染时间戳 ## 共享 Gateway 网关 RPC 选项 -`openclaw logs` 也接受标准的 Gateway 网关客户端标志: +`openclaw logs` 也接受标准 Gateway 网关客户端标志: - `--url `:Gateway 网关 WebSocket URL - `--token `:Gateway 网关令牌 -- `--timeout `:超时时间,单位为毫秒(默认 `30000`) +- `--timeout `:超时时间,单位为 ms(默认 `30000`) - `--expect-final`:当 Gateway 网关调用由智能体支持时,等待最终响应 -当你传入 `--url` 时,CLI 不会自动应用配置或环境凭证。如果目标 Gateway 网关需要认证,请显式包含 `--token`。 +传入 `--url` 时,CLI 不会自动应用配置或环境凭证。如果目标 Gateway 网关需要认证,请显式包含 `--token`。 ## 示例 @@ -62,9 +62,9 @@ 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 秒)。每次重试都会向 stderr 打印一条警告。不可恢复的错误(认证失败、配置错误)仍会立即退出。 +- 使用 `--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。不可恢复的错误(认证失败、配置错误)仍会立即退出。 ## 相关