这篇解决什么：定位报错，不是替你修某一类故障
搜「OpeClaw 日志」「OpeClaw 报错定位」的人，通常已经看到红字、弹窗或任务失败，但不知道日志在哪、该截哪几行、求助前要备齐什么。
本文只讲：如何按当前版本入口取日志、如何对齐时间读关键行、自查清单，以及分享前如何脱敏。完全打不开 → 打不开排查；能起来但启动很慢/卡加载 → 启动慢文；401/429 与额度 → API Key 文；公司代理/TLS → 代理文。
不编造具体日志文件名、日志等级开关或「提交即有人回复」的官方支持承诺。菜单文案与目录名以当前版本为准。安装包入口 → 下载页；场景边界 → FAQ。
先分流：别把所有红字都塞进「看日志」
日志是证据，不是万能药。若客户端从未起来、闪退、杀毒/Gatekeeper 秒杀，优先走打不开排查，日志可能根本写不全。
若进程在、最终能进界面，只是加载很久，先对照启动慢文（自启、Skills、本地模型冷启动），再决定是否需要日志佐证。
界面或响应里已经清楚写着 401、invalid key、429、quota exceeded，先走 API Key 与额度文；反复刷同一 Key 只会让日志更吵。代理把 HTTPS 截断、证书不受信任 → 代理与模型连接文。
- 无进程 / 秒退 → 打不开排查。
- 有进程、卡加载但能进 → 启动慢文。
- 明确 401/429 → API Key 文。
- 代理/TLS 异常 → 代理文；其余才用本文取证。
日志在哪：优先客户端入口，其次用户数据目录
优先在设置、帮助或关于页找「打开日志目录」「导出诊断信息」「Reveal logs」一类入口——这是最不容易走错版本差异的方式。
若没有入口，再到用户数据目录附近找：Windows 常见示例 `%AppData%/OpeClaw`（资源管理器地址栏可粘贴）；macOS 常见示例 `~/Library/Application Support/OpeClaw`。子文件夹叫 logs、diagnostics 还是别的名字，以你机器上当前版本实际结构为准，不要假设固定文件名。
公司机若禁止访问 AppData / Application Support，按 IT 策略操作；不要关安全软件硬拷。版本号记在关于页，方便和下载页对照。
怎么看：对齐时间，抓住错误码与堆栈头几行
先完整复现一次问题，记下大概时间点，再打开最新日志，只看该时间前后的片段。整份文件从上翻到下效率最低。
优先搜索 ERROR、Exception、Failed、timeout、ECONNREFUSED、permission denied，以及 HTTP 状态码（401、403、429、5xx）。真正有用的往往是「第一条错误」加紧随其后的几行原因说明，而不是后面一长串连锁报警。
若同一时间段里同时出现模型调用失败与本地路径拒绝，先分清是云端响应错误还是本机权限问题，再决定下一步走 API Key、代理还是工作区相关文——本文不代替那些专题排查。
提交问题前：自查清单与脱敏
自查至少过一遍：版本号与平台是否与下载页一致；是否其实是打不开/启动慢/401/代理（见上文分流）；是否刚改过 Key、代理或 Skills；最短复现步骤是否写得清（点了什么 → 期望 → 实际）。
分享日志前先脱敏：替换 API Key、Bearer token、Cookie；模糊本机用户名与绝对路径；去掉无关对话全文。只保留与错误时间对齐的片段即可。
准备好的材料方便你自己存档，也方便任何你选择的求助渠道理解问题。本站不承诺官方工单、响应时效或「提交必有回复」。
报错定位对照表（不新增结论）
下表只归纳上文；不改变「取证走本文、具体故障类走对应专题文」的边界。
| 现象 | 优先动作 | 常见误操作 |
|---|---|---|
| 不知道日志在哪 | 先找设置/帮助里的日志或诊断入口 | 照搬过时路径脚本 |
| 有红字但类别不清 | 复现后只截时间对齐的 ERROR 段 | 整份日志无脱敏外发 |
| 双击无反应 | 打不开排查 | 在本文空翻不存在的日志 |
| 卡加载但能进 | 启动慢文 | 把慢启动当「神秘报错」 |
| 401 / 429 | API Key 文 | 对着日志反复重试同一 Key |
| 代理/证书错误 | 代理文 | 只改 Key 不管 TLS |
目录名与菜单文案以当前客户端为准；本文不编造未公开的日志等级开关。
日志与报错定位常见问题
OpeClaw 日志一般在哪？
常见可从客户端设置里的「打开日志/诊断目录」类入口进入；找不到时再到用户数据目录附近找（Windows 多为 %AppData%/OpeClaw，macOS 多为 ~/Library/Application Support/OpeClaw）。具体子目录与文件名因版本而异，以当前版本入口为准，不要照搬第三方写死的路径。
看日志要盯哪几行？
优先找与复现时间对齐的 ERROR / Exception / Failed / timeout，以及紧挨着的 HTTP 状态码或「permission denied」类提示。不要整份日志盲翻；先复现一次，再只截前后各几十行。
报错前要准备什么再求助？
准备：关于页版本号与平台、复现步骤（点了什么、期望/实际）、关键日志片段（已脱敏 API Key 与本机路径）、以及你已试过的分流结论（例如不是 401、不是完全打不开）。本文不承诺任何官方支持渠道。
和启动慢、打不开、401 怎么区分？
双击无反应或秒退 → 打不开排查；能起来但卡在加载 → 启动慢文；弹窗/日志明确 401/429 → API Key 文；代理/TLS 证书异常 → 代理文。本文只管「怎么取日志、读关键行、自查后再求助」。