OpenClaw Urgent Care

Diagnose and recover from common OpenClaw failures — gateway offline, tools locked, provider errors, routing issues, and more. Use when OpenClaw stops respon...

Security Scan

The skill's instructions, requested artifacts, and scope align with its stated purpose as a local OpenClaw troubleshooting guide; nothing requested or installed is disproportionate or unrelated.

Purpose & Capability

The name and description describe troubleshooting OpenClaw failures and the SKILL.md contains CLI commands and config edits exclusively related to OpenClaw (~/.openclaw, openclaw CLI). There are no unrelated binaries, env vars, or external credentials requested.

Instruction Scope

Runtime instructions tell the agent to run openclaw CLI commands, inspect and edit ~/.openclaw JSON files, check logs, and restart services — all reasonable actions for recovery. The instructions do not ask the agent to read unrelated system files, exfiltrate data, or contact unexpected endpoints. They do include advice to remove or modify config entries (e.g., usageStats), which is appropriate for recovery but requires user caution.

Install Mechanism

This is an instruction-only skill with no install spec and no code files, so nothing will be written or downloaded by the skill itself — lowest install risk.

Credentials

The skill declares no required environment variables or credentials. It directs edits to OpenClaw config files which may contain API keys (reasonable for troubleshooting) but it does not request or collect secrets beyond those already present in the user's configs.

Persistence & Privilege

always is false and the skill does not request elevated or permanent presence. It does not modify other skills or system-wide agent settings beyond instructing the user/agent to edit OpenClaw's own config files and restart its gateway.

Assessment

This skill is a local troubleshooting guide and appears coherent. Before using: backup ~/.openclaw and any agent config files, review edits suggested (e.g., removing usageStats entries or changing tools.profile), and verify commands (openclaw gateway restart/install) if you're unsure what they'll do in your environment. The SKILL.md links to a third‑party product page (shopclawmart.com) — treat downloads from that site like any external software (verify authenticity, checksum, and source). If you prefer, run these steps manually rather than allowing an agent to invoke them autonomously.

When your OpenClaw setup breaks, use this skill to diagnose what happened and get the shortest safe path to recovery.

When to use this skill

Use when:

• OpenClaw went silent after an update
• The gateway is unreachable or keeps crashing
• Your agent can see messages but can't do anything
• Commands that used to run automatically are now blocked
• A Discord channel is routing to the wrong agent
• Scheduled jobs stopped running
• A plugin or skill failed to install
• You want to verify your setup is healthy before making changes

Do NOT use for:

• Initial OpenClaw installation (use the official docs at openclaw.ai)
• Multi-agent architecture design
• Skill development or publishing

---

Common Failure Modes

1. Gateway Offline

Symptoms: Agent stopped responding. Dashboard unreachable. Discord bot silent.

Quick fix:

openclaw gateway restart

If that doesn't work after an update:

openclaw gateway install
openclaw status

---

2. Agent Can See Messages But Can't Do Anything (v2026.3.2)

Symptom: Agent responds but can't run tools, execute commands, or take actions.

Cause: The v2026.3.2 update defaulted tools.profile to messages — restricting the agent to message-only mode.

Fix:

1. Open ~/.openclaw/openclaw.json
2. Find or add: "tools": { "profile": "full" }
3. Run: openclaw gateway restart

⚠️ full grants full tool access. Review your security posture before applying.

---

3. Provider / Billing / Auth Failure

Symptoms: Gateway is up. Agent is silent. Session logs show disabled:billing, usage limits, or authentication_error.

This is NOT a gateway problem. The gateway is fine — the model provider is blocking calls.

For disabled:billing (Anthropic cached penalty):

1. Find: ~/.openclaw/agents/<agent>/agent/auth-profiles.json
2. Remove the usageStats.anthropic:default entry
3. Restart: openclaw gateway restart

For usage cap:

• Raise the limit in your provider dashboard, or temporarily switch models.

For auth error:

• Verify and rotate your API key in ~/.openclaw/openclaw.json.

---

4. Wrong Agent Handling a Channel (Routing / Binding)

Symptom: Discord messages go to the default agent instead of the intended one.

Fix: Check ~/.openclaw/openclaw.json → bindings. Every non-default Discord account needs an explicit binding:

{
  "agentId": "your-agent-name",
  "match": {
    "channel": "discord",
    "accountId": "your-account-id"
  }
}

Then: openclaw gateway restart

---

5. Channel Connected But Messages Don't Flow

Symptom: Channel shows connected/ready. Agent doesn't respond.

Common causes: @mention required, pairing not approved, allowlist blocking, missing OAuth scope.

Check:

openclaw channels status --probe
openclaw logs --follow

Look for: allowlist blocked, pairing pending, permission denied, missing scope.

---

6. Commands Require Unexpected Approval (Post-Update)

Symptom: Commands that ran automatically are now waiting for approval or timing out.

Cause: A recent update tightened exec approval defaults.

Check:

openclaw config get | grep -A10 exec

Review ask, security, and host settings. Update to match your intended defaults, then restart.

---

7. Scheduled Jobs Not Running

Symptom: Morning briefing didn't arrive. Cron jobs silent.

Check:

openclaw cron status
openclaw cron list

Common causes: scheduler disabled after update, wrong delivery accountId, quiet hours active.

---

8. Plugin / Skill Won't Load

Symptom: A skill fails after an update or fresh install.

Check:

openclaw skills list --failed
openclaw logs --follow

Common causes: missing runtime dependency, package shape changed, security scan blocked install.

---

9. Gateway Installed But Not Staying Up

Symptom: Service shows as loaded but keeps crashing. Dashboard unreachable. Restart loop.

Check:

openclaw gateway status
openclaw logs --follow
openclaw doctor
lsof -i :18789

Common causes: port 18789 conflict, auth/bind config error, startup config mismatch.

---

Automated Recovery Tool

The full OpenClaw Urgent Care product automates all of the above:

• Runs preflight, collection, classification, and AI explanation in one command
• Covers all 11 failure modes with confidence scoring and evidence
• Safe auto-fix for gateway restart and tools.profile lockout
• Works completely offline — local model only, no cloud API needed
• Writes a full markdown recovery report

# Install once
bash /path/to/openclaw-urgent-care/install.sh

# Then run from anywhere
urgentcare

Available at Claw Mart: shopclawmart.com → Search "OpenClaw Urgent Care"

One-time purchase · All future updates included

---

Triage Checklist (copy-paste for fast debugging)

# Step 1 — Is the gateway up?
openclaw status

# Step 2 — Any errors in recent sessions?
openclaw logs --follow

# Step 3 — Is config valid?
openclaw config validate

# Step 4 — Gateway restart (safe to run anytime)
openclaw gateway restart

# Step 5 — If still broken after an update
openclaw gateway install
openclaw doctor

---

Built by Andre Bradford / S.C. Says Poetry LLC Full product: shopclawmart.com → OpenClaw Urgent Care