Troubleshooting

Agent Not Picking Up Tickets

Check the Linear label

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

Check agent capacity

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.

Check cron is running

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.

Check the ticket status

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

Check comment type

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

Timestamp mismatch

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;

Check the tool directly

/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:

Check status:
su - agent -c "claude auth status"
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”

OpenClaw not running

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"

Cloudflared not connected

systemctl status cloudflared

If stale, restart:

systemctl restart cloudflared

Config validation error

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.

Getting Started

Onboarding

Platform

Configuration

AI Agents

Agent Surface

Creative Analytics

Development

Lunar Interns

Performance Reports

Attribution & Reporting

Notes / PMT

Troubleshooting

Troubleshooting

Agent Not Picking Up Tickets

PR Review Comments Not Detected

Claude CLI Not Authenticated

Frontend Not Updating After Code Changes

Dashboard Shows “502 Bad Gateway”

Server Ran Out of Memory

SSH Access

​Troubleshooting

​Agent Not Picking Up Tickets

​PR Review Comments Not Detected

​Claude CLI Not Authenticated

​Frontend Not Updating After Code Changes

​Dashboard Shows “502 Bad Gateway”

​Server Ran Out of Memory

​SSH Access

Troubleshooting

Agent Not Picking Up Tickets

PR Review Comments Not Detected

Claude CLI Not Authenticated

Frontend Not Updating After Code Changes

Dashboard Shows “502 Bad Gateway”

Server Ran Out of Memory

SSH Access