查看 OpenClaw 技能插件的執(zhí)行日志是定位問題、驗(yàn)證執(zhí)行結(jié)果的核心操作，OpenClaw 提供了”CLI 命令、桌面端可視化、日志文件直接查看”三種方式，覆蓋「實(shí)時(shí)查看」「歷史回溯」「按技能/時(shí)間篩選」等場景，以下是分步指南，附常用篩選命令和日志解讀技巧。

一、核心方式：CLI 命令查看（推薦，全場景適配）

通過 `claw logs` 命令可快速訪問日志，支持實(shí)時(shí)監(jiān)控、篩選技能、按時(shí)間范圍查詢，是排查問題的首選。

1. 基礎(chǔ)用法（查看所有日志）

bash

查看最新的 100 行日志（默認(rèn)）

claw logs

實(shí)時(shí)跟蹤日志（類似 tail -f，技能執(zhí)行時(shí)實(shí)時(shí)輸出）

claw logs --follow  簡寫：claw logs -f

查看指定行數(shù)的日志（如最新 500 行）

claw logs --lines 500  簡寫：claw logs -n 500

2. 精準(zhǔn)篩選：按技能/時(shí)間/級別過濾

這是排查單個(gè)技能問題的關(guān)鍵，比如只看 `agent-browser` 技能的執(zhí)行日志：

bash

僅查看指定技能的日志（核心篩選）

claw logs --skill agent-browser  簡寫：claw logs -s agent-browser

按日志級別篩選（ERROR/WARN/INFO/DEBUG）

claw logs --level ERROR  只看錯(cuò)誤日志，快速定位問題

claw logs --level DEBUG  看詳細(xì)調(diào)試日志，適合開發(fā)排障

按時(shí)間范圍篩選（近1小時(shí)/指定時(shí)間段）

claw logs --since 1h  近1小時(shí)的日志

claw logs --since "2026-03-06 08:00" --until "2026-03-06 12:00"  指定時(shí)間段

組合篩選（例：查看 agent-browser 近1小時(shí)的錯(cuò)誤日志）

claw logs -s agent-browser -l ERROR --since 1h

3. 導(dǎo)出日志（便于分享/分析）

bash

將篩選后的日志導(dǎo)出為文件

claw logs -s github -l ERROR --since 24h > github_error_logs_20260306.txt

二、可視化方式：桌面端查看（新手友好）

OpenClaw 桌面應(yīng)用內(nèi)置日志面板，無需命令行，操作直觀：

1. 打開 OpenClaw 桌面端，點(diǎn)擊左側(cè)菜單欄的「Logs」（日志）；

2. 頂部可選擇篩選條件：

   - ”Skill”：下拉選擇目標(biāo)技能（如 `todozi`）；

   - ”Level”：勾選 `ERROR`/`WARN`/`INFO`；

   - ”Time”：選擇「近1小時(shí)」「今日」「自定義」；

3. 日志列表會(huì)實(shí)時(shí)刷新，點(diǎn)擊單條日志可展開查看完整詳情（含執(zhí)行參數(shù)、報(bào)錯(cuò)堆棧）；

4. 支持「導(dǎo)出日志」「清空日志」操作（右上角按鈕）。

三、手動(dòng)方式：直接查看日志文件（進(jìn)階）

OpenClaw 的日志文件默認(rèn)存儲(chǔ)在本地，可直接用文本編輯器打開，適合 CLI 無法使用的場景：

1. 日志文件路徑（跨平臺(tái)）

2. 操作示例（Mac/Linux）

bash

用文本編輯器打開日志文件

open ~/.openclaw/logs/openclaw.log  Mac

vim ~/.openclaw/logs/openclaw.log   Linux

按技能關(guān)鍵詞搜索日志（例：搜索 agent-browser 相關(guān)日志）

grep "agent-browser" ~/.openclaw/logs/openclaw.log

查看錯(cuò)誤日志并高亮顯示

grep -i "error" ~/.openclaw/logs/openclaw.log | less

四、日志解讀技巧（快速定位問題）

日志內(nèi)容包含關(guān)鍵信息，重點(diǎn)關(guān)注以下字段：

典型錯(cuò)誤日志示例（快速排查）

[2026-03-06 10:25:30] [SKILL: agent-browser] [LEVEL: ERROR] 

Message: Failed to fetch webpage: https://example.com

Error: NetworkError: Connection refused

Stack: at fetchPage (/~/.openclaw/skills/agent-browser/index.js:45:12)

解讀：`agent-browser` 技能訪問 `example.com` 時(shí)網(wǎng)絡(luò)連接失敗，需檢查網(wǎng)絡(luò)或目標(biāo)網(wǎng)址是否可用。

五、常見問題與解決

1. ”日志為空”：

   - 確認(rèn) OpenClaw 服務(wù)正在運(yùn)行：`claw status`；

   - 檢查日志級別是否設(shè)置過高（如只看 ERROR 但無錯(cuò)誤，切換到 INFO）。

2. ”日志文件過大”：

   - 自動(dòng)清理：`claw logs --rotate`（按大小/時(shí)間分割日志）；

   - 手動(dòng)清理：`rm ~/.openclaw/logs/openclaw.log`（清理前建議備份）。

3. ”中文亂碼”：

   - Mac/Linux：`claw logs | iconv -f utf-8 -t gbk`；

   - Windows：用 Notepad++ 打開日志文件，選擇「UTF-8 編碼」。

總結(jié)

1. 查看 OpenClaw 技能日志優(yōu)先用 `claw logs` 命令，通過 `-s`（技能）、`-l`（級別）、`--since`（時(shí)間）精準(zhǔn)篩選；

2. 新手可選桌面端可視化查看，進(jìn)階用戶可直接訪問本地日志文件；

3. 解讀日志重點(diǎn)關(guān)注「技能標(biāo)識(shí)」「錯(cuò)誤級別」「報(bào)錯(cuò)堆棧」，快速定位執(zhí)行失敗原因。

本文鏈接：http://51huadong.com/cloundnews/11016889.html