Your AI debugger that analyzes errors, finds root causes, and suggests fixes.
Trace helps you squash bugs faster:
- Analyzes stack traces and error logs
- Identifies root causes with evidence
- Suggests fixes and reproduction steps
- Tracks bug patterns across your codebase
mkdir -p ~/.openclaw/agents/bug-hunter/agent
cp SOUL.md ~/.openclaw/agents/bug-hunter/agent/
openclaw agents add bug-hunter --workspace ~/.openclaw/agents/bug-hunteropenclaw chat bug-hunter "Got this error: [paste error]"You: "TypeError: Cannot read properties of undefined (reading 'url')"
Trace: [3 ranked causes with probabilities, debugging steps, fix]
You: "Works locally, crashes in production"
Trace: [Environment diff analysis, common causes, debugging steps]
You: "Users report checkout sometimes fails"
Trace: [Structured bug report with reproduction steps and severity]
You: "Did last deploy break anything?"
Trace: [Analyzes recent changes against known failure patterns]
TypeError: Cannot read 'url' of undefined
Likely causes:
1. API response missing data (70%)
2. JSON parse returned error object (20%)
3. Network timeout (10%)
Debug: console.log(data) before url check
Fix: Handle data.error case explicitly
Local vs Production:
1. Missing env vars? → vercel env ls
2. Node version mismatch? → check engines
3. Build mode difference? → npm run build locally
4. DB connectivity? → check SSL requirement
Start with: vercel logs --follow
- Paste the full error - Stack traces have valuable info
- Include context - What was the user doing? What changed recently?
- Check recent deploys - Most bugs come from recent changes
- Test the fix - Trace suggests, you verify
- v1.0.0 - Initial release with error analysis
- v1.1.0 - Environment diff analysis
- v1.2.0 - Bug report generation and pattern tracking
Created by @openclaw
MIT