Ola Troubleshooting

The following issues may appear for any installation.

Reason
The plugin's key and the MCP bearer token don't match.

Remedy
Re-run the installer. It writes both.

Reason
The status stays "Waiting" as it uses the wrong key or gateway URL.

Remedy
Confirm that the OLA_API_KEY value matches the key Ola issued and the Agent can reach https://olachat.com.

Reason
Either the key was rotated or the key belongs to a disconnected agent.

Remedy
Rotate the key under the agent's Settings and re-run the installer with the updated key.

Reason
Hermes isn't in gateway mode

Remedy
Start Hermes with hermes gateway run.

Reason
Hermes Python environment lacks aiohttp

Remedy
Install aiohttp, which the webhook listener needs to bind.

Reason
On Claude Code, the channel isn't loaded.

Remedy
Start the session with the following command:

claude --dangerously-load-development-channels plugin:ola@ola

Without the flag Ola's tools work but tool calls aren't gated.

Reason
Claude Code auto-approved them before Ola saw them.

1. Add
   Copy code block

   1
   "permissions": {
   2
     "ask": ["Bash", "Read", "Glob", "Grep", "WebFetch", "WebSearch"]
   3
   }

   to ~/.claude/settings.json so every action reaches the gate.
2. Restart any running session.

claude plugin list | grep ola

openclaw plugins list | grep -i ola

hermes plugins list | grep -i ola

If the command doesn't return a response, the plugin hasn't been installed.