Skip to main content

​
Troubleshooting

​
Agent Not Picking Up Tickets

Make sure the ticket is tagged with intern:<name> (not agent:<name>). The label must match exactly.Verify the label exists:
/home/agent/tools/linear-check
The agent only handles one ticket at a time. Check if it’s already busy:
/home/agent/tools/work-can-take
If busy, wait for current PRs to merge or manually free it in Supabase.
su - agent -c "export XDG_RUNTIME_DIR=/run/user/\$(id -u); openclaw cron list"
You should see linear-poll running every 5m. If missing, crons weren’t set up during boot.
The cron only picks up issues with state type unstarted or backlog. If the ticket is already In Progress, the agent skips it. Move it back to Open in Linear.

​
PR Review Comments Not Detected

The agent detects:
  • ✅ Inline review comments (on specific lines)
  • ✅ Top-level PR comments
  • ✅ Review body text (with change requests)
It ignores:
  • ❌ Bot comments (Linear, Claude, GitHub Actions)
  • ❌ Approvals (APPROVED state)
  • ❌ Empty review bodies
If last_comment_seen_at in Supabase is ahead of the comment timestamp, the comment is skipped. Reset it:
UPDATE pull_requests SET last_comment_seen_at = NULL
WHERE repo = 'l5ui' AND pr_number = 123;

/home/agent/tools/gh-pr-comments l5ui 123
Should return new_comments array with your comment.

​
Claude CLI Not Authenticated

The snapshot includes Claude auth, but if it expires:
  1. Check status: 
    su - agent -c "claude auth status"
  2. If loggedIn: false, the agent posts SSH instructions to Slack. Or SSH in directly: 
    ssh -i ~/.ssh/id_rsa root@<server_ip>
su - agent
cd /home/agent/.openclaw/workspace
claude
    Go through the login flow in the interactive TUI.

​
Frontend Not Updating After Code Changes

The agent should rebuild automatically, but if it doesn’t: 
ssh -i ~/.ssh/id_rsa root@<server_ip>
/home/agent/tools/rebuild-if-changed l5ui
This applies Angular budget + environment fixes and triggers a Docker build.

​
Dashboard Shows “502 Bad Gateway”

su - agent -c "export XDG_RUNTIME_DIR=/run/user/\$(id -u); systemctl --user status openclaw-gateway.service"
If inactive, restart:
su - agent -c "export XDG_RUNTIME_DIR=/run/user/\$(id -u); openclaw gateway install --force; systemctl --user restart openclaw-gateway.service"

systemctl status cloudflared
If stale, restart:
systemctl restart cloudflared
Check OpenClaw config:
su - agent -c "openclaw doctor"
Common issue: Telegram config with dmPolicy: allowlist but no allowFrom. Fix: remove Telegram from the config.

​
Server Ran Out of Memory

The CX33 has 8GB RAM + 4GB swap. Heavy operations (Angular build + Claude CLI simultaneously) can exhaust memory. Check: 
free -h
docker stats --no-stream
Solutions:
  • Wait for the Angular build to finish before triggering Claude
  • Upgrade to a larger server type
  • The frontend-builder container exits after building, freeing memory

​
SSH Access

All servers use the same SSH key: 
ssh -i ~/.ssh/id_rsa root@<server_ip>
Switch to agent user: 
su - agent
Server IPs are shown in the dashboard agent detail view and in the Supabase agents table.