---
read_when:
    - Вам нужно удаленно отслеживать журналы Gateway (без SSH)
    - Вам нужны строки журнала в формате JSON для инструментов
summary: Справочник CLI для `openclaw logs` (просмотр последних журналов Gateway через RPC)
title: Журналы
x-i18n:
    generated_at: "2026-06-28T22:43:50Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 3835880c0919d4c0c67bd3b371f9f8b0f396b80a9456c545ea0caa064a6361c0
    source_path: cli/logs.md
    workflow: 16
---

# `openclaw logs`

Отслеживание файловых журналов Gateway через RPC (работает в удаленном режиме).

Связанные разделы:

- Обзор журналирования: [Журналирование](/ru/logging)
- CLI Gateway: [gateway](/ru/cli/gateway)

## Параметры

- `--limit <n>`: максимальное количество возвращаемых строк журнала (по умолчанию `200`)
- `--max-bytes <n>`: максимальное количество байтов для чтения из файла журнала (по умолчанию `250000`)
- `--follow`: следить за потоком журнала
- `--interval <ms>`: интервал опроса при слежении (по умолчанию `1000`)
- `--json`: выводить события JSON с разделением по строкам
- `--plain`: вывод обычного текста без стилизованного форматирования
- `--no-color`: отключить цвета ANSI
- `--local-time`: отображать метки времени в вашем локальном часовом поясе (по умолчанию)
- `--utc`: отображать метки времени в UTC

## Общие параметры RPC Gateway

`openclaw logs` также принимает стандартные флаги клиента Gateway:

- `--url <url>`: URL WebSocket Gateway
- `--token <token>`: токен Gateway
- `--timeout <ms>`: тайм-аут в мс (по умолчанию `30000`)
- `--expect-final`: ждать финального ответа, когда вызов Gateway выполняется через агента

Когда вы передаете `--url`, CLI не применяет учетные данные из конфигурации или окружения автоматически. Явно укажите `--token`, если целевой Gateway требует аутентификации.

## Примеры

```bash
openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --limit 500
openclaw logs --local-time
openclaw logs --utc
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
```

## Примечания

- По умолчанию метки времени отображаются в вашем локальном часовом поясе. Используйте `--utc` для вывода в UTC.
- Если неявный Gateway local loopback запрашивает сопряжение, закрывается во время подключения или истекает по тайм-ауту до ответа `logs.tail`, `openclaw logs` автоматически переключается на настроенный файловый журнал Gateway. Явные цели `--url` не используют этот резервный вариант.
- `openclaw logs --follow` не продолжает следить за резервными настроенными файлами после сбоев неявного локального RPC Gateway. В Linux он использует активный пользовательский журнал Gateway в systemd по PID, когда он доступен, и выводит выбранный источник журнала; в противном случае он продолжает повторять попытки обращения к текущему Gateway вместо отслеживания потенциально устаревшего соседнего файла.
- При использовании `--follow` временные отключения gateway (закрытие WebSocket, тайм-аут, разрыв соединения) запускают автоматическое переподключение с экспоненциальной задержкой (до 8 повторных попыток, с ограничением 30 с между попытками). При каждой повторной попытке в stderr выводится предупреждение, а после успешного опроса выводится уведомление `[logs] gateway reconnected`. В режиме `--json` и предупреждение о повторной попытке, и переход к повторному подключению выводятся как записи `{"type":"notice"}` в stderr. Неустранимые ошибки (сбой аутентификации, неверная конфигурация) по-прежнему немедленно завершают выполнение.

## Связанные разделы

- [Справочник CLI](/ru/cli)
- [Журналирование Gateway](/ru/gateway/logging)