StepAce Experimental

Other

Generate AI music on your Android phone via the StepAce Experimental app. Use this skill whenever the user asks to generate, create, make, compose, or queue a song, track, beat, melody, or any piece of music — even if phrased casually like "make me a vibe", "create something chill", or "schedule a song for tonight". Handles both immediate generation and scheduled (future) generation, with optional BPM, key, duration, lyrics, and time signature control. Requires a StepAce Experimental pairing token (setup guide included).

Install

openclaw skills install stepace-experimental

StepAce Experimental — AI Music Generation

Queue or schedule AI-generated songs directly to your Android phone through the StepAce Experimental app.

🚀 Setup (first time only)

Before using this skill, you need to connect it to your StepAce Experimental app:

Open the StepAce Experimental app on your Android phone
Go to Settings (bottom tab)
Tap OpenClaw Bridge
Tap Connect — the app generates a unique pairing token
Copy the pairing token shown on screen
Tell your agent:

"Set my StepAce token to <paste token here>"

Your agent saves it as STEPACE_TOKEN. You only need to do this once — unless you regenerate your token in the app.

Token management

"Set my StepAce token to XYZ" → save as STEPACE_TOKEN
"Reset my token" → remind user: StepAce Experimental app → Settings → OpenClaw Bridge → Connect → paste new token
"What's my token?" → confirm it's set, show only first 4 + last 4 chars (e.g. T2L_****IP0)
If STEPACE_TOKEN is not set when the user asks to generate music → walk them through setup before proceeding

Generation types

Immediate — `enqueue_generation`

Queues a song to generate right now on the phone. Use this by default.

Scheduled — `schedule_generation`

Queues a song to generate at a specific future time. Use this when the user gives a time or date ("tonight at 2am", "schedule for tomorrow morning", etc.). Requires scheduledAt as a Unix timestamp in milliseconds.

Parameters exposed to the user

Only caption is required. All others are optional — omit them entirely from the payload if not specified (do not send null or empty values).

Parameter	Type	Notes
`caption`	string	Required. Describe style, mood, genre, instruments. Be descriptive.
`lyrics`	string	Song lyrics. Ignored if `instrumental: true`.
`instrumental`	boolean	`true` = no vocals. If `true`, do NOT send `lyrics`. If user provides lyrics, set `false`.
`bpm`	integer	Tempo, 20–300. Infer from genre if confident (e.g. techno → 132, lo-fi → 85).
`duration`	integer	Length in seconds, 5–300. Defaults to ~30s if omitted.
`keyscale`	string	Key and scale, e.g. `"C minor"`, `"F# major"`, `"A dorian"`.
`timesignature`	string	`"4/4"` or `"3/4"` only.
`vocal_language`	string	BCP-47 tag for vocals. e.g. `"en"`, `"es"`, `"pt"`, `"fr"`, `"ja"`, `"ko"`. Only relevant when `instrumental: false`. Defaults to `"en"`.

Instrumental logic

User provides lyrics → instrumental: false, include lyrics
User says "no vocals" / "instrumental" / "beat" → instrumental: true, omit lyrics
User provides neither → omit both instrumental and lyrics (let the app decide)

API call

Endpoint: POST https://openclaw-bridge.torrico-villanueva-cesar-kadir.workers.dev/openclaw/queue Header: Content-Type: application/json

Preferred transport

Use curl from the shell as the default/preferred way to call the bridge. Do not prefer Python urllib/generic HTTP clients when curl is available, because the bridge/CDN may treat those clients differently and reject them even when the same payload works via curl.

Immediate generation

Preferred example using curl:

source /home/deploy/.stepace-env

curl -X POST \
  'https://openclaw-bridge.torrico-villanueva-cesar-kadir.workers.dev/openclaw/queue' \
  -H 'Content-Type: application/json' \
  --data '{
    "pairingToken": "'"$STEPACE_TOKEN"'",
    "type": "enqueue_generation",
    "payload": {
      "requestJson": {
        "caption": "cinematic synthwave with huge drums",
        "instrumental": true,
        "bpm": 120,
        "duration": 30
      }
    }
  }'

Equivalent JSON payload:

{
  "pairingToken": "{STEPACE_TOKEN}",
  "type": "enqueue_generation",
  "payload": {
    "requestJson": {
      "caption": "cinematic synthwave with huge drums",
      "instrumental": true,
      "bpm": 120,
      "duration": 30
    }
  }
}

Scheduled generation