RPC 拉日志
你不用自己登录远端机器。OpenClaw 会帮你把那头的日志接过来。
Cli 导读
远程拉日志，一条命令搞定
`openclaw logs` 通过 RPC 实时 tail 远程 Gateway 的日志文件，支持 `--follow` 持续追踪和 `--json` 结构化输出。最易踩的坑是：一旦手动传了 `--url`，CLI 就不会自动读取本地配置或环境变量，必须同时显式提供 `--token`。
先讲这一页到底在解决什么
远程拉日志，一条命令搞定
`openclaw logs` 通过 RPC 实时 tail 远程 Gateway 的日志文件，支持 `--follow` 持续追踪和 `--json` 结构化输出。最易踩的坑是：一旦手动传了 `--url`，CLI 就不会自动读取本地配置或环境变量，必须同时显式提供 `--token`。
第一站
🧺 先想画面：你不是去翻仓库，而是在柜台前等快递
官方一句话就点明了重点：`openclaw logs` 是把 Gateway 的文件日志“尾巴”拽出来看。不是全盘扫地，而是盯最近那一截。
看最后一截
它像从绳子的尾巴开始摸，先看最近发生了什么。
远程也行
这不是只能看本机小纸条的命令，远程模式一样能用。
一句话先记住
这是一根“从 Gateway 那头把日志尾巴拽回来”的绳子。
第二站
👀 那几条命令，像四种看法
它们都在看日志，但看法不一样。一个是安静看，一个是追着看，一个是让机器看，一个是换时区看。
openclaw logs像先把日志小本子翻到最后几页，看看最近在忙什么。
openclaw logs --follow像把耳朵贴在门上，后面又来了什么声音，就立刻听见。
openclaw logs --json像不要花哨排版，只要一盒彩色积木都摆成机器能读懂的方块。
openclaw logs --limit 500像说“我只要最近 500 行，别把整辆车都搬来”。
第三站
🕰 `--local-time` 是在说：把钟表换成你自己墙上的那一只
日志本来就有时间。只是远端机器的时间，常常不是你脑子里那条时间线。这个参数就是帮你把它换成本地时区。
--local-time
像把日志时间改成你这边墙上的钟，让你一眼就知道“这是我这里几点发生的”。
对齐脑子里的时间
排障时最怕时区错位。这个参数就是来减少“明明是昨晚，其实是中午”的误会。
适合转发给别人
你把本地时间打开以后，发给同事看，大家更容易对齐同一段现场。
一句话
这个参数只是换钟，不是换内容。
第四站
🧯 真正用它的时候，通常有三种小剧情
官方虽然只给了几个例子，但每一个都很像实际排障里会发生的现场。
openclaw logs像你先随手翻一眼，看看最近有没有明显红灯。
openclaw logs --follow像你守在一条小水管前，新的水流一来就立刻看见。
openclaw logs --follow --local-time像你一边盯着水流，一边把时间牌换成自己看得懂的版本。
📌 排障心法
当 Gateway 出怪事时，先看最近几行，再决定要不要继续追流。
最后总结
🎈 把 `openclaw logs` 压成一句话
`openclaw logs` 就是一根把 Gateway 文件日志尾巴拽回来的绳子：你可以只看一眼，也可以追着看，还能把时间换成你自己的时区。
如果你下一页只想继续看一页，我建议看 /cli/status。因为很多时候，先看状态，再追日志，会更快找到门到底卡在哪。