Skip to content
Splashify Pro
Docs
Log in (opens in a new tab)Start free trialStart free (opens in a new tab)

Troubleshooting

Common issues when installing or using the Splashify skill in OpenClaw, and how to fix them. Start with splashify doctor — it checks most of these automatically.

Issues with the splashify CLI itself (connecting, tokens, sending messages) are covered in splashify CLI → Troubleshooting. This page covers the OpenClaw skill layer.

splashify doctor checklist

bash
splashify doctor

Common problems

openclaw not found

Install it, then re-run the skill install:

bash
npm install -g openclaw@latest
splashify link openclaw

The command resolves OpenClaw's workspace skills directory automatically. If it cannot, OpenClaw is likely not installed or not onboarded — run openclaw onboard first, or pass the directory explicitly:

bash
splashify link openclaw --path /path/to/openclaw/workspace/skills

Use splashify link openclaw --print to see the target path without writing.

The assistant doesn't see the Splashify skill

  1. Confirm the skill is installed: the bundle should exist at ~/.openclaw/workspace/skills/splashify/ (run splashify doctor).
  2. Restart the OpenClaw Gateway after splashify link openclaw — skills are loaded at startup.
  3. Re-run splashify doctor — all checks should be ✓.
  4. Ask explicitly: "Use the Splashify skill to list my contacts."

The assistant sees the skill but actions fail

The skill runs the splashify CLI under the hood, so a failing action is usually a CLI problem:

  • Run the same command yourself, e.g. splashify contacts, to see the real error.
  • Check splashify doctor.
  • See splashify CLI → Troubleshooting for token, send, and rate-limit errors.

I previously set up the old MCP integration

The MCP-based integration (splashify-mcp, openclaw mcp add splashify) has been replaced by the skill. Remove the old MCP server so it does not conflict:

bash
openclaw mcp remove splashify

Then install the skill with splashify link openclaw.

Still stuck?

  • Re-run splashify doctor and read each line.
  • Reproduce the failing action directly with the splashify CLI.
  • Contact Splashify Pro support with the output of splashify doctor.