Find and share diagnostic logs

Last updated Mar 30, 2026

When you need to diagnose a problem or send logs to support, MultiClaw stores them in two places: the desktop app log and the gateway log.

Desktop app log

Go to Settings > General, scroll to the App Logs card, and click Open Logs to open the log folder.

The log file records app startup, IPC calls, update events, and gateway connection events. If you need to find it manually, the default paths are:

  • macOS: ~/Library/Logs/MultiClaw/multiclaw.log
  • Windows: %APPDATA%\MultiClaw\logs\multiclaw.log
  • Linux: ~/.config/MultiClaw/logs/multiclaw.log

Gateway log

The gateway log is located at ~/.openclaw/logs/gateway.log, or inside whichever data directory you configured for OpenClaw.

This log records agent task execution, model API calls, WebSocket events, and file-watch events.

Share logs with support

Warning:

Log files may contain conversation context, task inputs, file paths, and other information related to your agents' activities. Open the log file and review its contents before sharing. Do not share logs that contain information you are not comfortable disclosing.

The desktop app attempts to redact API keys from logs, but you should still scan the file before sending.

Before attaching logs to a support ticket:

  1. Compress the log folder as a ZIP file.
  2. Note your MultiClaw version from Help > About.
  3. Note your OS version.
  4. Write a short description of what you were doing when the problem occurred.

Having these four items ready makes it easier to diagnose most issues when a support channel becomes available.

Related articles

Agent shows 'Disconnected'

Fix a disconnected agent status caused by gateway, network, session, or firewall issues.

Gateway fails to start

Diagnose and fix port conflicts, missing binaries, token errors, and permission problems.

Cannot sign in

Resolve sign-in failures caused by wrong workspace URL, expired sessions, SSO errors, or unconfirmed email.