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


splashify doctor

Check	If it fails
config	Run `splashify connect` to save your backend URL and token.
access token	The token is invalid, revoked, or expired — create a new one.
openclaw	Install OpenClaw: `npm install -g openclaw@latest`.
splashify skill	Run `splashify link openclaw` to install the skill bundle.

Common problems

`openclaw` not found

Install it, then re-run the skill install:


npm install -g openclaw@latest
splashify link openclaw

`splashify link openclaw` can’t find the OpenClaw workspace

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:


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

Confirm the skill is installed: the bundle should exist at ~/.openclaw/workspace/skills/splashify/ (run splashify doctor).
Restart the OpenClaw Gateway after splashify link openclaw — skills are loaded at startup.
Re-run splashify doctor — all checks should be ✓.
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:


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.

Troubleshooting

splashify doctor checklist