Found something that doesn't look right? The bug report form makes it easy to let us know. You can open it from the sidebar of your dashboard, so you can report issues the moment you encounter them.
The Bug Report Button
In your dashboard, click Report a Bug in the sidebar. On the OpenClaw page of our website there is also an orange circle in the bottom-left corner that opens the same form (it is hidden on phones).
- Always at hand: The sidebar item is there on every dashboard page.
- One click to start: The bug report form opens as a window on top of your current page.
Tip
Report bugs as soon as you notice them, while you still remember the page and the steps that led to the problem.
What to Include
A good bug report helps us fix the issue faster. The form asks for three things:
Select the affected page
Describe the bug
Attach a screenshot (optional)
Note
All the fields are in the same form. Choose the page, describe the problem in at least 10 characters and click Submit Bug Report.
Screenshot Guidelines
To ensure your screenshot uploads successfully, follow these guidelines:
| Requirement | Details |
|---|---|
| Accepted formats | PNG, JPEG, GIF, WebP |
| Maximum file size | PNG, JPEG and WebP up to 25 MB (made smaller for you before upload). GIF up to 5 MB |
| Recommended | Full-page screenshot showing the issue in context |
| Not accepted | PDF, SVG, BMP, or video files |
- Crop to the relevant area: If the bug is in a specific section, crop the screenshot to show that section plus enough surrounding context.
- Include error messages: If you see an error toast, modal, or console message, make sure it is visible in the screenshot.
- Hide sensitive data: If your screenshot contains API keys or personal information you don't want to share, blur or redact those areas before uploading.
What Happens Next
After you submit a bug report, here is what happens behind the scenes:
- Immediate confirmation: You will see a success message confirming your report was received.
- Team review: Our development team reviews all bug reports regularly. Critical bugs (crashes, data loss, security issues) are prioritized and addressed within hours.
- Status updates: If the bug affects your account specifically, we may follow up via a support ticket or notification. General bugs are tracked internally and fixed in upcoming releases.
- Release notes: Notable changes are listed on the Latest Updates page.
Tip
For urgent issues that are blocking your work (server down, agent not responding, billing errors), open a support ticket. Bug reports are for non-urgent issues and improvement suggestions.