SoundCloud Watcher - OpenClaw Plugin

Monitor your SoundCloud account and track artist releases. Get notified when someone follows you, likes your tracks, or when artists you care about drop new music.

Features

Follower tracking - See who followed you recently
Track engagement - Monitor who liked your tracks
New releases - Get notifications when tracked artists release new music
Smart API usage - Only fetches what changed, automatically skips dormant artists
Rate limit handling - Exponential backoff for API reliability
OAuth 2.1 - Uses SoundCloud's latest authentication endpoint

Prerequisites

OpenClaw gateway running
Node.js 22+ installed
SoundCloud API credentials

Quick Start

1. Install

openclaw plugins install @akilles/soundcloud-watcher
openclaw plugins enable soundcloud-watcher
openclaw gateway restart

2. Get SoundCloud Credentials

1. Log into SoundCloud 2. Go to soundcloud.com/you/apps 3. Click "Register a new application" 4. Fill in name and website (any URL works) 5. Copy your Client ID and Client Secret

3. Configure

Create the credentials file:

nano ~/.openclaw/secrets/soundcloud.env

Add your credentials:

SOUNDCLOUD_CLIENT_ID=your_client_id
SOUNDCLOUD_CLIENT_SECRET=your_client_secret
MY_USERNAME=your_soundcloud_username

4. Restart & Verify

openclaw gateway restart

Then in chat:

/soundcloud-setup    # Should show "Already configured!"
/soundcloud-status   # Should show your account info

Commands

| Command | Description | |---------|-------------| | /soundcloud-setup | Show setup instructions and config status | | /soundcloud-status | Show tracking status and account info | | /soundcloud-check | Run immediate check (verbose output) | | /soundcloud-cron | Run check for automation (silent if no updates) | | /soundcloud-add <username> | Track artist(s) - space-separated | | /soundcloud-remove <username> | Stop tracking an artist | | /soundcloud-list | List all tracked artists |

Automated Checking

The plugin responds to commands but doesn't auto-poll. Set up a cron job for automatic notifications:

openclaw cron add --name "soundcloud-check" \
  --every 6h \
  --isolated \
  --message "Run /soundcloud-cron and forward any updates to me."

Uses /soundcloud-cron which:

Returns updates only (silent if nothing new)
Logs errors but doesn't spam on config issues

Alternative: Add to your HEARTBEAT.md:

- [ ] Run /soundcloud-cron if not checked in last 6 hours

File Locations

| File | Purpose | |------|---------| | ~/.openclaw/secrets/soundcloud.env | Your API credentials | | ~/.openclaw/data/artists.json | Tracked artists data | | ~/.openclaw/data/soundcloud_tracking.json | Your account tracking data |

Troubleshooting

"Not configured" error

Check your credentials file exists and has correct format:

cat ~/.openclaw/secrets/soundcloud.env

Should contain:

SOUNDCLOUD_CLIENT_ID=...
SOUNDCLOUD_CLIENT_SECRET=...
MY_USERNAME=...

Plugin not loading

openclaw plugins list

Should show soundcloud-watcher as loaded. If disabled:

openclaw plugins enable soundcloud-watcher
openclaw gateway restart

API rate limits

The plugin handles rate limits automatically with exponential backoff. If issues persist, wait a few minutes and try again.

Uninstalling

openclaw plugins disable soundcloud-watcher
rm -rf ~/.openclaw/extensions/soundcloud-watcher

Optionally remove data:

rm ~/.openclaw/secrets/soundcloud.env
rm ~/.openclaw/data/artists.json
rm ~/.openclaw/data/soundcloud_tracking.json

Changelog

2.4.0

Sanitize all user-controlled data (display names, usernames, track titles) in output to prevent prompt injection via crafted SoundCloud metadata

2.3.1

Bump default myTracksLimit from 10 to 50

2.2.5

Migrate to SoundCloud OAuth 2.1
Use username fallback for empty display_name, add name change detection
Move @types/node to devDependencies

License

MIT

soundcloud-watcher

Summary

Install to Claude Code