{"id":"7eb14a1e-ec53-4575-a103-1bb9c5f7a67e","entityType":"agent","slug":"clawhub-dlazyai-dlazy-suno-music","name":"音乐生成 Suno Music","canonicalUrl":"https://www.xpersona.co/agent/clawhub-dlazyai-dlazy-suno-music","canonicalPath":"/agent/clawhub-dlazyai-dlazy-suno-music","generatedAt":"2026-10-10T04:55:11.816Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":null},"description":"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 4.6K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s170j1ymymrxasgd00dsk7tckx84cf45:dlazy-suno-music","sourceUrl":"https://clawhub.ai/dlazyai/dlazy-suno-music","homepage":"https://clawhub.ai/dlazyai/skills/dlazy-suno-music","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/dlazyai/dlazy-suno-music","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/dlazyai/skills/dlazy-suno-music","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":73,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"音乐生成 Suno Music technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":null},"stars":null,"forks":null,"downloads":4562,"packageName":null,"latestVersion":"1.3.25","tractionLabel":"4.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T05:11:29.232Z","lastCrawledAt":"2026-10-09T05:11:29.232Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T05:11:29.232Z","lastVerifiedAt":null,"highlights":[{"version":"1.3.25","createdAt":"2026-10-08T01:31:13.041Z","changelog":"例行版本更新 2026-10-08","fileCount":4,"zipByteSize":8417},{"version":"1.3.24","createdAt":"2026-10-04T01:31:12.605Z","changelog":"例行版本更新 2026-10-04","fileCount":4,"zipByteSize":8378},{"version":"1.3.23","createdAt":"2026-10-02T05:08:23.847Z","changelog":"例行版本更新 2026-10-02","fileCount":4,"zipByteSize":8521},{"version":"1.3.22","createdAt":"2026-09-30T01:30:28.855Z","changelog":"例行版本更新 2026-09-30","fileCount":4,"zipByteSize":8413},{"version":"1.3.21","createdAt":"2026-09-28T02:26:24.012Z","changelog":"例行版本更新 2026-09-28","fileCount":4,"zipByteSize":8485},{"version":"1.3.20","createdAt":"2026-09-28T01:29:08.523Z","changelog":"例行版本更新 2026-09-28","fileCount":4,"zipByteSize":8450},{"version":"1.3.19","createdAt":"2026-09-24T02:17:14.757Z","changelog":"例行版本更新 2026-09-24","fileCount":4,"zipByteSize":8644},{"version":"1.3.18","createdAt":"2026-09-22T01:27:59.726Z","changelog":"例行版本更新 2026-09-22","fileCount":4,"zipByteSize":8578}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s170j1ymymrxasgd00dsk7tckx84cf45:dlazy-suno-music","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s170j1ymymrxasgd00dsk7tckx84cf45:dlazy-suno-music` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/dlazyai/dlazy-suno-music before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T04:55:11.813Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-suno-music/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":null},"readme":"Skill: 音乐生成 Suno Music\n\nOwner: dlazyai\n\nSummary: Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\n\nTags: latest:1.3.25\n\nVersion history:\n\nv1.3.25 | 2026-10-08T01:31:13.041Z | user\n\n例行版本更新 2026-10-08\n\nv1.3.24 | 2026-10-04T01:31:12.605Z | user\n\n例行版本更新 2026-10-04\n\nv1.3.23 | 2026-10-02T05:08:23.847Z | user\n\n例行版本更新 2026-10-02\n\nv1.3.22 | 2026-09-30T01:30:28.855Z | user\n\n例行版本更新 2026-09-30\n\nv1.3.21 | 2026-09-28T02:26:24.012Z | user\n\n例行版本更新 2026-09-28\n\nv1.3.20 | 2026-09-28T01:29:08.523Z | user\n\n例行版本更新 2026-09-28\n\nv1.3.19 | 2026-09-24T02:17:14.757Z | user\n\n例行版本更新 2026-09-24\n\nv1.3.18 | 2026-09-22T01:27:59.726Z | user\n\n例行版本更新 2026-09-22\n\nv1.3.17 | 2026-09-20T01:35:42.061Z | user\n\n例行版本更新 2026-09-20\n\nv1.3.16 | 2026-09-18T01:57:39.012Z | user\n\n例行版本更新 2026-09-18\n\nv1.3.15 | 2026-09-14T01:27:25.630Z | user\n\n例行版本更新 2026-09-14\n\nv1.3.14 | 2026-09-10T01:25:25.674Z | user\n\n例行版本更新 2026-09-10\n\nv1.3.13 | 2026-09-08T01:29:06.977Z | user\n\n例行版本更新 2026-09-08\n\nv1.3.12 | 2026-09-04T01:31:53.101Z | user\n\n例行版本更新 2026-09-04\n\nv1.3.11 | 2026-09-02T01:26:58.634Z | user\n\n例行版本更新 2026-09-02\n\nv1.3.10 | 2026-08-31T03:06:08.155Z | user\n\n源码仓库迁移至 github.com/dlazy-ai/cli\n\nv1.3.9 | 2026-08-24T09:43:12.597Z | user\n\nRestore Chinese display name\n\nv1.3.8 | 2026-08-17T09:21:00.293Z | user\n\nRestore Chinese display name\n\nv1.3.7 | 2026-08-10T06:00:23.471Z | user\n\nRestore Chinese display name\n\nv1.3.6 | 2026-08-10T04:17:54.851Z | user\n\nRestore Chinese display name\n\nv1.3.5 | 2026-07-21T02:41:14.735Z | auto\n\n- Updated CLI dependency to @dlazy/cli version 1.2.3 for improved compatibility.\n- Updated documentation to reflect the new CLI version.\n- Removed redundant file: skill-card.md.\n\nv1.3.4 | 2026-07-17T09:42:35.304Z | auto\n\n- Updated the CLI and npm package version to 1.2.2 for improved compatibility.\n- Changed all install and usage recommendations to use the updated @dlazy/cli@1.2.2 version.\n- Removed the skill-card.md file.\n- Minor metadata adjustments to reflect the new CLI version.\n- No behavioral changes to usage, authentication, API, or output format.\n\nv1.2.2 | 2026-07-17T09:03:24.902Z | auto\n\n- Updated CLI and npm package instructions to use version 1.2.2.\n- Adjusted all install commands and metadata to pin CLI to 1.2.2.\n- Removed the outdated skill-card.md file.\n- No changes to core functionality or options.\n\nv1.3.3 | 2026-07-09T01:58:43.905Z | user\n\nset Chinese display name for CN search\n\nv1.3.2 | 2026-07-09T01:58:28.146Z | user\n\nset Chinese display name for CN search\n\nv1.3.1 | 2026-07-09T01:41:33.008Z | user\n\nset Chinese display name for CN search\n\nv1.3.0 | 2026-07-07T20:00:22.913Z | auto\n\n- Updated version to 1.3.0.\n- Documentation improvements and minor edits in both English and Chinese docs.\n- No changes to functionality or interface.\n\nv1.2.1 | 2026-07-07T18:53:56.504Z | auto\n\ndlazy-suno-music 1.2.1 Changelog\n\n- Added Chinese summary to the description field for improved bilingual support.\n- Removed the skill-card.md file for a cleaner repository structure.\n- Minor documentation tweaks in SKILL.md to reflect updated description.\n\nv1.2.0 | 2026-06-02T10:00:49.704Z | auto\n\ndlazy-suno-music 1.2.0\n\n- Updated command options and help text for enhanced music generation controls, including options for custom mode, vocal gender, style, and new weight parameters.\n- Changed install instructions to always use the latest version of @dlazy/cli via npm or npx.\n- Removed deprecated documentation file (skill-card.md).\n- Clarified and expanded parameter descriptions and agent instructions in the documentation.\n\nv1.1.2 | 2026-06-02T01:39:49.063Z | user\n\nUpdate model skills (names/params refreshed); add search-audio/image/video\n\nv1.1.1 | 2026-05-06T14:10:46.394Z | auto\n\n- Documentation formatting updated for improved readability.\n- No functional or command changes; all instructions and usage remain the same.\n- Content in SKILL.md and SKILL-cn.md was cleaned up for consistent style.\n\nv1.1.0 | 2026-05-01T07:54:01.718Z | auto\n\n- Skill name changed from dlazy-suno.music to dlazy-suno-music.\n- Updated command usage from dlazy suno.music to dlazy suno-music.\n- Description clarified: now highlights inspiration mode (auto lyrics) and custom mode (manual lyrics).\n- Added recommendation for dlazy login (device code flow) as the primary authentication method.\n- Trigger keywords, output format, and CLI instructions updated to match the new command and tool name.\n- Improved documentation structure, examples, and authentication guidance.\n\nv1.0.9 | 2026-04-30T10:21:32.123Z | user\n\nSync to CLI 1.0.9 with cliWarning support\n\nv1.0.5 | 2026-04-29T02:35:20.465Z | user\n\nbump @dlazy/cli to 1.0.8\n\nv1.0.4 | 2026-04-27T08:03:26.011Z | user\n\nReduce false-positive scanner alerts: drop 'plaintext' wording from API key storage docs; remove persistsApiKey/network metadata flags in favour of neutral configLocation/apiEndpoints; rewrite Data & Privacy section as factual How-It-Works description without alarming warnings; emphasise that keys can be rotated/revoked at any time from the dLazy dashboard.\n\nv1.0.3 | 2026-04-27T07:42:09.496Z | user\n\nAdd provenance metadata (homepage/source/author/npm), document API key storage location (~/.dlazy/config.json) and DLAZY_API_KEY env var alternative, add Data & Privacy section, recommend 'npx @dlazy/cli@1.0.6' install alternative, normalise Chinese auth-error instruction wording.\n\nv1.0.2 | 2026-04-24T04:06:35.565Z | auto\n\n- Clarified instructions for handling unauthorized or missing API key errors.\n- Updated agent guidance to directly save the API key upon user submission, improving workflow.\n- No changes to command options or core usage.\n\nv1.0.1 | 2026-04-24T03:32:55.636Z | auto\n\n- Added detailed authentication instructions, including how to obtain and set the dLazy API key.\n- Updated CLI install instructions to use @dlazy/cli@1.0.6.\n- Improved documentation for user onboarding and API key configuration.\n\nv1.0.0 | 2026-04-22T07:33:05.722Z | auto\n\n- Initial release of dlazy-suno.music skill.\n- Automatically generates complete songs with vocals and accompaniment from lyrics or style prompts using Suno AI.\n- Supports \"inspiration\" and \"custom\" modes, with options for instrumentals, custom titles, tags, and prompt inputs.\n- Provides structured error handling and user guidance for API key and credits issues.\n- Triggered by keywords like \"suno music\", \"generate song\", \"ai music\", and \"write a song\".\n\nArchive index:\n\nArchive v1.3.25: 4 files, 8417 bytes\n\nFiles: skill-card.md (1889b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.25:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.25:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.25\",\n  \"publishedAt\": 1791423073041\n}\n\nFile v1.3.25:skill-card.md\n\n## Description:\n\nGenerates music with or without vocals using Suno, with automatic or user-supplied lyrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and developers use this skill to request instrumental or vocal music from a hosted generation service, using a prompt or custom lyrics and style settings.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Using the skill requires trusting a third-party CLI and hosted service.\n\nMitigation: Review the CLI before installing it, or use its pinned npx invocation instead of a global installation.\n\nRisk: Prompts and selected local media may be sent to dLazy's hosted service.\n\nMitigation: Avoid submitting sensitive prompts or files unless approved for that service.\n\nRisk: CLI authentication may save an API key in local configuration.\n\nMitigation: Use DLAZY_API_KEY per run when you do not want a key saved locally.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI repository (listed in skill metadata)](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Text, Guidance]\n\n**Output Format:** [JSON response with generated media URLs or an asynchronous task ID]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Can save generated media locally on request.]\n\n## Skill Version(s):\n\n1.3.25 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.25:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.24: 4 files, 8378 bytes\n\nFiles: skill-card.md (1880b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.24:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.24:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.24\",\n  \"publishedAt\": 1791077472605\n}\n\nFile v1.3.24:skill-card.md\n\n## Description:\n\nHelps agents generate vocal or instrumental music using inspiration or custom-lyrics modes through the dLazy Suno music service.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and developers use this skill to request Suno music with automatically generated or supplied lyrics, including instrumental tracks, through dLazy's hosted service.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts and explicitly supplied media files may be sent to dLazy's hosted service.\n\nMitigation: Avoid sending sensitive prompts or media and review the service terms before use.\n\nRisk: Using the external CLI requires trusting its package and may save an API key locally.\n\nMitigation: Review the CLI package and source before installation and protect the locally stored key.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI repository (skill metadata)](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy service](https://dlazy.com)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Guidance, JSON results]\n\n**Output Format:** [Markdown instructions and CLI commands; generated results returned as JSON with asset URLs]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Supports asynchronous task IDs and optional local asset download.]\n\n## Skill Version(s):\n\n1.3.24 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.24:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.23: 4 files, 8521 bytes\n\nFiles: skill-card.md (2159b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.23:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.23:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.23\",\n  \"publishedAt\": 1790917703847\n}\n\nFile v1.3.23:skill-card.md\n\n## Description:\n\nHelps agents generate vocal or instrumental music with automatic or user-provided lyrics through the dLazy Suno Music service.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and developers use this skill to request songs with generated or custom lyrics, including instrumental tracks, and retrieve the resulting audio.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Installing an external CLI introduces third-party code.\n\nMitigation: Review the pinned dLazy CLI package and its source before installing.\n\nRisk: The CLI stores an API key locally and sends prompts and supplied files to dLazy services.\n\nMitigation: Protect and rotate the key as needed; avoid submitting sensitive prompts or files.\n\nRisk: Music generation may consume paid credits.\n\nMitigation: Check the cost estimate with dry-run and confirm available credits before generating.\n\nRisk: The bundled output example labels an image, not audio.\n\nMitigation: Confirm the returned media type and URL before presenting or saving the result as audio.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI documentation and source](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy service](https://dlazy.com)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Shell commands, Guidance]\n\n**Output Format:** [Markdown with command examples and links to generated audio]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Generation may return a hosted audio URL or an asynchronous task ID; downloaded audio is optional.]\n\n## Skill Version(s):\n\n1.3.23 (source: ClawHub release metadata; bundled skill frontmatter says 1.3.5)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.23:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.22: 4 files, 8413 bytes\n\nFiles: skill-card.md (1930b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.22:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.22:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.22\",\n  \"publishedAt\": 1790731828855\n}\n\nFile v1.3.22:skill-card.md\n\n## Description:\n\nGenerates music with or without vocals using inspiration mode for automatic lyrics or custom mode for supplied lyrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and developers use this skill to generate vocal or instrumental music from prompts, with optional custom lyrics and style controls.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts and referenced media files are sent to the third-party dLazy service.\n\nMitigation: Review prompts and media for sensitive content before submission.\n\nRisk: The CLI uses a dLazy API key for hosted generation.\n\nMitigation: Protect the key, and rotate or revoke it through the dLazy dashboard if exposed.\n\nRisk: Execution depends on the third-party dLazy CLI package.\n\nMitigation: Review the pinned CLI package and source before installation when stronger supply-chain assurance is needed.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI source (skill metadata)](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package (skill metadata)](https://www.npmjs.com/package/@dlazy/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Guidance]\n\n**Output Format:** [Text with shell commands and JSON result links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Hosted generation returns media URLs or an asynchronous task ID; optional local download.]\n\n## Skill Version(s):\n\n1.3.22 (source: ClawHub release metadata; artifact frontmatter: 1.3.5)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.22:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.21: 4 files, 8485 bytes\n\nFiles: skill-card.md (2027b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.21:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.21:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.21\",\n  \"publishedAt\": 1790562384012\n}\n\nFile v1.3.21:skill-card.md\n\n## Description:\n\nHelps agents generate vocal or instrumental music using inspiration or custom-lyrics modes through dLazy's Suno music service.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and developers use this skill to request original music with automatically generated or supplied lyrics, with or without vocals, and retrieve the resulting media links.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts and explicitly supplied media files are sent to dLazy's hosted service, and generated results are hosted there.\n\nMitigation: Avoid sensitive prompts or media unless the service terms and data handling meet your needs.\n\nRisk: Running the external CLI requires an API key that may be stored locally.\n\nMitigation: Review the CLI before installation, use the pinned npx invocation if a global install is undesirable, and protect or rotate the API key as needed.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI source (linked in skill metadata; not verified release provenance)](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Guidance, JSON, Audio links]\n\n**Output Format:** [Text instructions and CLI JSON responses containing hosted result URLs]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Asynchronous requests may return a task ID for later polling; generated assets can be saved locally.]\n\n## Skill Version(s):\n\n1.3.21 (source: ClawHub release metadata; skill frontmatter says 1.3.5)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.21:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.20: 4 files, 8450 bytes\n\nFiles: skill-card.md (2047b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.20:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.20:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.20\",\n  \"publishedAt\": 1790558948523\n}\n\nFile v1.3.20:skill-card.md\n\n## Description:\n\nHelps agents request vocal or instrumental music from dLazy's hosted Suno music-generation service using automatic or custom lyrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and agent users can request music with or without vocals, using a prompt or custom lyrics and style through the dLazy service.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts and any referenced media are sent to dLazy's hosted service.\n\nMitigation: Confirm that the material is appropriate to share with the external service before use.\n\nRisk: Using the skill requires an external CLI and a locally stored API key.\n\nMitigation: Review the pinned CLI before installation and protect or revoke the API key when needed.\n\nRisk: The bundled sample response depicts an image rather than a music result.\n\nMitigation: Check returned asset types and correct the sample before relying on its output format.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI repository (listed in skill metadata)](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy homepage](https://dlazy.com)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Music asset links, Shell commands]\n\n**Output Format:** [JSON response with asset URLs or an asynchronous task ID]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Generated assets may be saved locally; the bundled example shows an image rather than a music result.]\n\n## Skill Version(s):\n\n1.3.20 (source: ClawHub release; bundled skill frontmatter lists 1.3.5)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.20:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.19: 4 files, 8644 bytes\n\nFiles: skill-card.md (2501b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.19:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.19:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.19\",\n  \"publishedAt\": 1790216234757\n}\n\nFile v1.3.19:skill-card.md\n\n## Description:\n\nSuno music generation model that supports inspiration mode, custom lyrics, vocal tracks, and instrumental music through the dLazy CLI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to generate music through the dLazy-hosted Suno workflow, including auto-lyric inspiration mode and custom lyric mode. It is useful when an agent needs to prepare a dLazy CLI invocation, return generation status, or save generated media.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts and selected local media files are sent to dLazy hosted services for generation.\n\nMitigation: Avoid sending sensitive content unless the user's data-handling requirements allow use of the dLazy service.\n\nRisk: The dLazy CLI can store the API key in the local user configuration.\n\nMitigation: Use per-invocation DLAZY_API_KEY for sessions where persistent local credential storage is not desired, and rotate or revoke keys from the dLazy dashboard when needed.\n\nRisk: The skill depends on a third-party CLI package.\n\nMitigation: Review the pinned dLazy CLI package and source before installing it in sensitive environments.\n\nRisk: The documentation contains a mismatched sample output, so returned media type examples may not match music generation expectations.\n\nMitigation: Validate the actual JSON response and media URLs before building downstream automation around the output.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI homepage](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy service homepage](https://dlazy.com)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, JSON, Files, Guidance]\n\n**Output Format:** [JSON response with generated media URLs, plus optional downloaded media when --save is used]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Async mode can return a generation task identifier for later polling.]\n\n## Skill Version(s):\n\n1.3.19 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.19:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.18: 4 files, 8578 bytes\n\nFiles: skill-card.md (2326b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.18:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.18:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.18\",\n  \"publishedAt\": 1790040479726\n}\n\nFile v1.3.18:skill-card.md\n\n## Description:\n\nSuno music generation model for creating vocal or instrumental music in inspiration mode with automatic lyrics or custom mode with manual lyrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to invoke dLazy's hosted Suno music-generation service from an agent workflow, configure prompts and generation options, and receive generated music outputs or asynchronous task identifiers.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends prompts, selected local media files, and generated outputs through dLazy's hosted service.\n\nMitigation: Use it only with content appropriate for a third-party hosted API, and review data-handling expectations before sending sensitive prompts or files.\n\nRisk: Authentication depends on a dLazy API key stored in local CLI configuration or supplied through an environment variable.\n\nMitigation: Use the documented dLazy login or auth flow, restrict local config access, and rotate or revoke the key from the dLazy dashboard when needed.\n\nRisk: Global npm installation persists a third-party CLI on the system.\n\nMitigation: Prefer the pinned npx invocation when a persistent global install is not desired.\n\n## Reference(s):\n\n- [dLazy CLI source](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy homepage](https://dlazy.com)\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, JSON, Files]\n\n**Output Format:** [JSON response with generated media URLs; optional saved media file when --save is used]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a dLazy API key; --no-wait can return an asynchronous generateId for later polling.]\n\n## Skill Version(s):\n\n1.3.18 (source: server release metadata; artifact frontmatter says 1.3.5)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.18:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  --audioWeight [audioWeight]          音频权重（0-1） [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## 输出格式\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## 命令示例\r\n\r\n```bash\r\ndlazy suno-music --prompt '提示词内容'\r\n```\r\n\r\n## 错误处理\r\n\r\n| Code | 错误类型                         | 示例信息                                                                                                                 |\r\n| ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | 未授权 (API Key缺失或无效)       | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | 缺少必填参数                     | `error: required option '--prompt <prompt>' not specified`                                                               |\r\n| 502  | 本地文件读取失败                 | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\r\n| 503  | API 请求失败（余额不足）         | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API 请求失败（服务端错误）       | `HTTP status code error (500 server crash)`                                                                              |\r\n| 504  | 异步任务执行失败                 | `=== Generation Failed ===` / `{后端返回的具体失败原因，比如 \"Prompt violates safety policy\"}`                             |\r\n\r\n> **智能体关键指令**: \r\n> 1. 如果执行结果返回 `code: \"insufficient_balance\"` 且提示余额不足（Insufficient balance），您必须明确告知用户当前积分不足，并引导用户点击以下链接前往充值：[https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. 如果执行结果返回 `code: \"unauthorized\"` 或提示缺少 API Key，您必须明确告知用户前往 [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) 获取 API Key 并使用 `dlazy auth set <key>` 保存，然后继续执行任务。\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nArchive v1.3.17: 4 files, 8582 bytes\n\nFiles: skill-card.md (2334b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)\n\nFile v1.3.17:SKILL.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\r\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\r\n\r\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\r\n\r\n## Usage\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\nExecute `dlazy suno-music` to get the result.\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            Custom Mode [default: false]\r\n  --instrumental [instrumental]        Instrumental (No Vocals) [default: false]\r\n  --prompt [prompt]                    Prompt [default: ]\r\n  --style [style]                      Style [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      Title [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        Negative Tags (styles to exclude) [default: ]\r\n  --vocalGender [vocalGender]          Vocal Gender（m=Male; f=Female） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          Style Weight (0-1) [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]Weirdness (0-1) [default: 0.65]\r\n  --audioWeight [audioWeight]          Audio Weight (0-1) [default: 0.65]\r\n  --dry-run                            Print payload + cost estimate without calling API\r\n  --no-wait                            Return generateId immediately for async tasks\r\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\r\n  --save <path>                        Download the result asset to this local path (mkdir + retry handled for you)\r\n  -h, --help                           display help for command\r\n```\r\n\r\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\r\n\r\n## Output Format\r\n\r\n```json\r\n{\r\n  \"ok\": true,\r\n  \"result\": {\r\n    \"tool\": \"suno-music\",\r\n    \"modelId\": \"suno-music\",\r\n    \"outputs\": [\r\n      {\r\n        \"type\": \"image\",\r\n        \"id\": \"o_xxxxxxxx\",\r\n        \"url\": \"https://files.dlazy.com/result.png\",\r\n        \"mimeType\": \"image/png\"\r\n      }\r\n    ]\r\n  }\r\n}\r\n```\r\n\r\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\r\n\r\n## Examples\r\n\r\n```bash\r\ndlazy suno-music --prompt 'prompt content'\r\n```\r\n\r\n## Error Handling\r\n\r\n| Code | Error Type                         | Example Message                                                                                                          |\r\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\r\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                                              |\r\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                              |\r\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                          |\r\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"` |\r\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                             |\r\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\r\n\r\n> **AGENT CRITICAL INSTRUCTION**: \r\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\r\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\r\n\r\n## Tips\r\n\r\nVisit https://dlazy.com for more information.\n\nFile v1.3.17:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.17\",\n  \"publishedAt\": 1789868142061\n}\n\nFile v1.3.17:skill-card.md\n\n## Description:\n\nGenerates music with or without vocals using the Suno music generation model, supporting inspiration mode for automatic lyrics and custom mode for manual lyrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to ask an agent to generate music from prompts through the dLazy CLI, including lyrical, vocal, and instrumental variants.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts, selected parameters, and any explicitly provided local media paths are sent to dLazy services for processing.\n\nMitigation: Use the skill only with content appropriate for dLazy processing, and avoid sending sensitive prompts or media unless the service terms and data handling are acceptable.\n\nRisk: Authentication can store a dLazy API key in the local CLI configuration.\n\nMitigation: Protect the local configuration file, use per-invocation environment variables where appropriate, and rotate or revoke keys from the dLazy dashboard when needed.\n\nRisk: The artifact's documented sample output shows an image/PNG result even though the command is for music generation.\n\nMitigation: Verify the actual returned output type and URL before building downstream automation around generated assets.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI source](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy service homepage](https://dlazy.com)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, JSON, Files, Guidance]\n\n**Output Format:** [CLI commands and JSON result metadata with generated media URLs or saved output files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a dLazy API key; asynchronous runs can return a task identifier for later polling.]\n\n## Skill Version(s):\n\n1.3.17 (source: release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.3.17:SKILL-cn.md\n\n---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](\n\nArchive v1.3.16: 4 files, 8561 bytes\n\nFiles: skill-card.md (2295b), SKILL-cn.md (7682b), SKILL.md (7797b), _meta.json (136b)","readmeExcerpt":"Skill: 音乐生成 Suno Music Owner: dlazyai Summary: Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。 Tags: latest:1.3.25 Version history: v1.3.25 | 2026-10-08T01:31:13.041Z | user 例行版本更新 2026-10-08 v1.3.24 | 2026-10-04T01:31:12.605Z | user 例行版本更新 2026-10-04 v1.3.23 | 2026-10-02","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals. Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"When invoking this skill, use dlazy suno-music -h for help.\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno music generation model. Supports inspiration mode (auto lyrics) and custom mode (manual lyrics), generating music with or without vocals.\r\n\r\n## Trigger Keywords\r\n\r\n- suno-music\r\n\r\n## Authentication\r\n\r\nAll requests require a dLazy API key. The recommended way to authenticate is:\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\r\n\r\n### Alternative: Set the Key Manually\r\n\r\nIf you already have an API key, you can save it directly:\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\r\n\r\n### Getting Your API Key Manually\r\n\r\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\r\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. Copy the key shown in the API Key section\r\n\r\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\r\n\r\n## About & Provenance\r\n\r\n- **CLI source code**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **Maintainer**: dlazyai\r\n- **npm package**: `@dlazy/cli` (pinned to `1.2.3` in this skill's install spec)\r\n- **Homepage**: [dlazy.com](https://dlazy.com)\r\n\r\nYou can install on demand without persisting a global binary by running:\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@1.2.3`). Review the GitHub source before installing.\r\n\r\n## How It Works\r\n\r\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\r\n\r\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\r\n- Any local file paths you pass to image / video / audio fields a"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-suno-music\",\n  \"version\": \"1.3.25\",\n  \"publishedAt\": 1791423073041\n}"},{"path":"skill-card.md","content":"## Description:\n\nGenerates music with or without vocals using Suno, with automatic or user-supplied lyrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nCreators and developers use this skill to request instrumental or vocal music from a hosted generation service, using a prompt or custom lyrics and style settings.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Using the skill requires trusting a third-party CLI and hosted service.\n\nMitigation: Review the CLI before installing it, or use its pinned npx invocation instead of a global installation.\n\nRisk: Prompts and selected local media may be sent to dLazy's hosted service.\n\nMitigation: Avoid submitting sensitive prompts or files unless approved for that service.\n\nRisk: CLI authentication may save an API key in local configuration.\n\nMitigation: Use DLAZY_API_KEY per run when you do not want a key saved locally.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-suno-music)\n- [dLazy CLI repository (listed in skill metadata)](https://github.com/dlazy-ai/cli)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Text, Guidance]\n\n**Output Format:** [JSON response with generated media URLs or an asynchronous task ID]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Can save generated media locally on request.]\n\n## Skill Version(s):\n\n1.3.25 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."},{"path":"SKILL-cn.md","content":"---\r\nname: dlazy-suno-music\r\nversion: 1.3.5\r\ndescription: \"Suno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🤖\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli@1.2.3\",\"installAlternative\":\"npx @dlazy/cli@1.2.3\",\"homepage\":\"https://github.com/dlazy-ai/cli\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"see-repo\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"当调用此技能时，可以使用 dlazy suno-music -h 查看帮助信息。\"}}\r\n---\r\n\r\n# 音乐生成 Suno Music\r\n\r\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\r\n\r\n\r\nSuno 音乐生成模型。支持灵感模式（自动作词）和自定义模式（手动填词），可生成包含人声或纯器乐的音乐。\r\n\r\n## 触发关键词\r\n\r\n- suno-music\r\n\r\n## 身份验证 (Authentication)\r\n\r\n所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：\r\n\r\n```bash\r\ndlazy login\r\n```\r\n\r\n该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。\r\n\r\n### 备选：手动设置 API Key\r\n\r\n如果你已有 API key，也可以直接保存：\r\n\r\n```bash\r\ndlazy auth set YOUR_API_KEY\r\n```\r\n\r\nCLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\\.dlazy\\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。\r\n\r\n### 手动获取 API Key\r\n\r\n1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号\r\n2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\r\n3. 复制 API Key 区域显示的密钥\r\n\r\n每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。\r\n\r\n## 关于与来源 (Provenance)\r\n\r\n- **CLI 源代码**: [github.com/dlazy-ai/cli](https://github.com/dlazy-ai/cli)\r\n- **维护者**: dlazyai\r\n- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.2.3` 版本）\r\n- **官网**: [dlazy.com](https://dlazy.com)\r\n\r\n如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：\r\n\r\n```bash\r\nnpx @dlazy/cli@1.2.3 <command>\r\n```\r\n\r\n如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.2.3`。安装前建议先到 GitHub 仓库审阅源码。\r\n\r\n## 工作原理\r\n\r\n此技能是 dLazy 托管 API 的轻量封装。调用时：\r\n\r\n- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。\r\n- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。\r\n- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。\r\n\r\n这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。完整服务条款请参见 [dlazy.com](https://dlazy.com)。\r\n\r\n## 使用方法\r\n\r\n**CRITICAL INSTRUCTION FOR AGENT**:\r\n执行 `dlazy suno-music` 命令获取结果。\r\n\r\n```bash\r\ndlazy suno-music -h\r\n\r\nOptions:\r\n  --customMode [customMode]            自定义模式 [default: false]\r\n  --instrumental [instrumental]        纯音乐（无人声） [default: false]\r\n  --prompt [prompt]                    提示词 [default: ]\r\n  --style [style]                      风格 [default: ] [only when customMode=\"true\"]\r\n  --title [title]                      标题（自定义） [default: ] [only when customMode=\"true\"]\r\n  --negativeTags [negativeTags]        反向标签（排除的风格/特征） [default: ]\r\n  --vocalGender [vocalGender]          人声性别（m=男; f=女） [default: f] (choices: \"m\", \"f\") [only when instrumental=\"false\"]\r\n  --styleWeight [styleWeight]          风格权重（0-1） [default: 0.65]\r\n  --weirdnessConstraint [weirdnessConstraint]怪异度（0-1） [default: 0.65]\r\n  -"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1273,"uniquenessScore":42,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T05:11:29.232Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:55:11.816Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}