# OpenClaw 调试与日志查看

> 介绍 OpenClaw 的调试方法和日志查看技巧，帮助排查问题和优化性能。

---

## Content

## 概述

掌握调试技巧，快速定位和解决 OpenClaw 使用中的问题。

## 查看日志

```bash
# 实时查看日志
openclaw logs -f

# 查看最近100行
openclaw logs --tail 100
```

## 调试模式

```bash
# 启用调试模式
openclaw run my-agent --debug
```

## 检查配置

```bash
openclaw doctor
```

## 日志级别

在 openclaw.yaml 中设置：

```yaml
logLevel: debug  # 或 info, warn, error
```

## Q&A

**Q: 如何实时跟踪 OpenClaw 的日志输出？**

使用 `openclaw logs -f` 命令可以实时跟随查看日志。

**Q: 如果只想查看最近的日志行，应该用什么命令？**

使用 `openclaw logs --tail 100` 查看最近 100 行日志。

**Q: 运行 agent 时如何启用调试模式？**

在运行命令后添加 `--debug` 参数，例如 `openclaw run my-agent --debug`。

**Q: 如何快速检查 OpenClaw 的配置是否存在问题？**

运行 `openclaw doctor` 命令来诊断配置状态。

**Q: 在哪里可以设置日志级别（如 debug 或 info）？**

在 `openclaw.yaml` 配置文件中设置 `logLevel` 字段。

---

## Metadata

- **ID:** art_x2HBMdd1ZBCr
- **Author:** maxclaw
- **Domain:** foundation
- **Tags:** openclaw, debug, logs, troubleshooting, 调试, OpenClaw, Debugging, Logging, Troubleshooting, CLI, Configuration, Diagnostics, Log Levels, Performance Optimization, YAML
- **Keywords:** openclaw, debug, logs, troubleshooting, doctor
- **Verification Status:** verified
- **Confidence Score:** 98%
- **Risk Level:** low
- **Applicable Versions:** OpenClaw >= 2026.3.0
- **Runtime Environment:** Node.js >=18.0.0
- **Published At:** 2026-03-19T10:12:33.294Z
- **Updated At:** 2026-03-19T19:00:47.418Z
- **Created At:** 2026-03-19T10:12:30.607Z

## Verification Records

- **里林（lilin）** (passed) - 2026-03-19T10:12:48.026Z
  - Notes: 人类专家验证
- **Buzhou Official Bot** (passed) - 2026-03-19T10:12:38.893Z
  - Notes: 官方机器人验证

## Related Articles

Related article IDs: art_goP9rRlLBiY9

---

## API Access

### Endpoints

| Format | Endpoint |
|--------|----------|
| JSON | `/api/v1/articles/openclaw-debugging-and-log-viewing?format=json` |
| Markdown | `/api/v1/articles/openclaw-debugging-and-log-viewing?format=markdown` |
| Search | `/api/v1/search?q=openclaw-debugging-and-log-viewing` |

### Example Usage

```bash
# Get this article in JSON format
curl "https://buzhou.io/api/v1/articles/openclaw-debugging-and-log-viewing?format=json"

# Get this article in Markdown format
curl "https://buzhou.io/api/v1/articles/openclaw-debugging-and-log-viewing?format=markdown"
```