[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75CMQYM38956C0PTYFDS657":3,"skill-same:01M75CMQYM38956C0PTYFDS657":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":6,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M75CMQYM38956C0PTYFDS657","truenas-skill",null,"Manage TrueNAS SCALE via API. Check pool health, manage datasets and snapshots, monitor alerts, control services, manage apps, orchestrate Dockge container stacks, and manage bookmarks. Use when the user asks about their NAS, storage, backups, containers, bookmarks, or homelab services.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fanotb\u002Ftruenas-skill\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: truenas-skill\ndescription: >\n  Manage TrueNAS SCALE via API. Check pool health, manage datasets and snapshots,\n  monitor alerts, control services, manage apps, orchestrate Dockge container stacks,\n  and manage bookmarks. Use when the user asks about their NAS, storage, backups,\n  containers, bookmarks, or homelab services.\nlicense: MIT\nhomepage: https:\u002F\u002Fgithub.com\u002Fanotb\u002Ftruenas-skill\ncompatibility: Requires curl, jq, and Node.js 18+. Network access to TrueNAS instance.\nmetadata: {\"author\": \"anotb\", \"version\": \"1.2.0\", \"openclaw\": {\"requires\": {\"env\": [\"TRUENAS_URL\", \"TRUENAS_API_KEY\"], \"bins\": [\"curl\", \"jq\", \"node\"]}, \"primaryEnv\": \"TRUENAS_API_KEY\"}}\n---\n\n# TrueNAS SCALE Skill\n\nManage a TrueNAS SCALE server and its apps via the TrueNAS API and Dockge Socket.IO.\n\n## Setup\n\n### Required Environment Variables\n\n```\nTRUENAS_URL       — TrueNAS base URL (e.g., https:\u002F\u002F10.0.0.5:444)\nTRUENAS_API_KEY   — API key from TrueNAS UI → API Keys\n```\n\n### Optional: TLS Configuration\n\n```\nTRUENAS_VERIFY_TLS  — Set to \"1\" to enforce TLS certificate validation (default: skip for self-signed certs)\n```\n\n### Optional: Dockge (Docker Compose UI)\n\n```\nDOCKGE_URL        — Dockge URL (e.g., http:\u002F\u002F10.0.0.5:5001)\nDOCKGE_USER       — Dockge login username\nDOCKGE_PASS       — Dockge login password\n```\n\n### Optional: Homelab Service API Keys\n\nSee the `references\u002F` directory for per-service env vars. Common ones:\n\n```\nSONARR_URL, SONARR_API_KEY           — TV show management\nRADARR_URL, RADARR_API_KEY           — Movie management\nPROWLARR_URL, PROWLARR_API_KEY       — Indexer management\nOVERSEERR_URL, OVERSEERR_API_KEY     — Media request UI\nPLEX_URL                             — Media server (no auth on LAN)\nTAUTULLI_URL, TAUTULLI_API_KEY       — Plex analytics\nQBITTORRENT_URL                      — Torrent client (no auth)\nSABNZBD_URL, SABNZBD_API_KEY         — Usenet client\nAUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY\nNTFY_URL                             — Push notifications\nSYNCTHING_URL, SYNCTHING_API_KEY     — File sync\nN8N_URL, N8N_API_KEY                 — Workflow automation\nNOCODB_URL, NOCODB_API_KEY           — Database\nCHANGEDETECTION_URL, CHANGEDETECTION_API_KEY\nCRAFTY_URL, CRAFTY_API_KEY           — Game servers\nLAZYLIBRARIAN_URL, LAZYLIBRARIAN_API_KEY\nMETUBE_URL                           — YouTube downloader\nKARAKEEP_URL, KARAKEEP_API_KEY       — Bookmarks with AI tagging\n```\n\n## API Notes\n\n**HTTPS REQUIRED:** TrueNAS auto-revokes API keys used over HTTP.\n\n> **REST API Deprecation Notice:** The REST API (`\u002Fapi\u002Fv2.0\u002F`) is deprecated in TrueNAS 25.04\n> and **fully removed in 26.04**. Use the WebSocket API (via `scripts\u002Ftruenas-ws.mjs`) as\n> the forward-compatible method. REST examples below still work on 24.10 and 25.x.\n\n### REST API (Legacy)\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002F[endpoint]\" \\\n  -H \"Authorization: Bearer $TRUENAS_API_KEY\"\n```\n\nThe `-k` flag is needed for self-signed certificates (common on home servers).\n\n### WebSocket API (Recommended)\n\nThe WebSocket API uses a DDP-like protocol (Meteor style). REST paths become dot notation:\n`\u002Fapi\u002Fv2.0\u002Fapp` → `app.query`, `\u002Fapi\u002Fv2.0\u002Fsystem\u002Finfo` → `system.info`.\n\n```javascript\n\u002F\u002F Connect: wss:\u002F\u002F\u003Chost>\u002Fwebsocket (rejectUnauthorized: false for self-signed)\n\n\u002F\u002F 1. Handshake\nsend: {\"msg\": \"connect\", \"version\": \"1\", \"support\": [\"1\"]}\nrecv: {\"msg\": \"connected\", \"session\": \"...\"}\n\n\u002F\u002F 2. Authenticate\nsend: {\"id\": \"1\", \"msg\": \"method\", \"method\": \"auth.login_with_api_key\", \"params\": [\"API_KEY\"]}\nrecv: {\"id\": \"1\", \"msg\": \"result\", \"result\": true}\n\n\u002F\u002F 3. Call methods\nsend: {\"id\": \"2\", \"msg\": \"method\", \"method\": \"system.info\", \"params\": []}\nsend: {\"id\": \"3\", \"msg\": \"method\", \"method\": \"app.query\", \"params\": []}\n```\n\nUse the helper script for WebSocket calls: `node scripts\u002Ftruenas-ws.mjs \u003Cmethod> [params_json]`\n\n## Security Notes\n\n- **Self-signed certificates:** TLS verification is skipped by default (`curl -k`, `rejectUnauthorized: false`) because homelab servers typically use self-signed certs. Set `TRUENAS_VERIFY_TLS=1` to enforce strict TLS validation.\n- **API key scope:** Use a read-only or least-privilege API key when possible. TrueNAS lets you scope keys to specific endpoints.\n- **Credentials stay local:** All env vars are read at runtime and sent only to the configured service endpoints. Nothing is phoned home.\n\n## Core Operations\n\n### System Info\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fsystem\u002Finfo\" -H \"Authorization: Bearer $TRUENAS_API_KEY\"\n```\n\n### Pool Health\n\n```bash\n# All pools with health status\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, healthy}'\n\n# Or via WebSocket\nnode scripts\u002Ftruenas-ws.mjs pool.query '[]'\n```\n\nThe API returns a `.healthy` boolean per pool. For deeper status, inspect the full pool object.\n\n### Active Alerts\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Falert\u002Flist\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {level, formatted}'\n```\n\n### Running Services\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fservice\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.state == \"RUNNING\") | .service'\n```\n\n## Dataset Management\n\n### List Datasets\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fdataset\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, type, used: .used.parsed, available: .available.parsed}'\n```\n\n### Create Dataset\n\n```bash\ncurl -sk -X POST \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fdataset\" \\\n  -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\": \"pool\u002Fpath\u002Fnew-dataset\"}'\n```\n\n### Delete Dataset\n\n```bash\n# Destructive — confirm with user first\ncurl -sk -X DELETE \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fdataset\u002Fid\u002FDATASET_ID\" \\\n  -H \"Authorization: Bearer $TRUENAS_API_KEY\"\n```\n\n## Snapshots & Replication\n\n### List Snapshots\n\n```bash\n# WebSocket (required on 25.10+, \u002Fapi\u002Fv2.0\u002Fzfs\u002Fsnapshot returns 404)\nnode scripts\u002Ftruenas-ws.mjs zfs.snapshot.query '[]'\n```\n\n### Create Snapshot\n\n```bash\nnode scripts\u002Ftruenas-ws.mjs zfs.snapshot.create '[{\"dataset\": \"pool\u002Fdataset\", \"name\": \"manual-YYYY-MM-DD\"}]'\n```\n\n### Snapshot Task Status\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fsnapshottask\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {dataset, schedule, enabled}'\n```\n\n### Replication Health\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Freplication\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, state: .state.state}'\n```\n\n## App Management\n\nTrueNAS Apps are the official marketplace for installing containerized services.\n\n### List Installed Apps\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, state, version}'\n```\n\n### Check for Updates\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.upgrade_available) | .name'\n```\n\n### Install \u002F Update Apps\n\nSee `references\u002Fapp-installation.md` for the full installation guide covering:\n- Checking app templates and storage requirements\n- Creating datasets with proper ACLs\n- Installing with correct storage mappings\n- Handling apps with multiple storage mounts\n\n### App Status\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp?name=APP_NAME\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[0] | {name, state, portals}'\n```\n\n## Dockge (Docker Compose Stacks)\n\nDockge is a companion UI for Docker Compose stacks not in the TrueNAS Apps catalog.\nIt uses Socket.IO, not REST. Use the provided scripts.\n\n### Prerequisites\n\n```bash\nnpm install   # in this skill's root directory\n```\n\n### List Stacks\n\n```bash\nnode scripts\u002Fdockge-list.mjs\n```\n\n### Update Stacks\n\n```bash\n# Update all running stacks\nnode scripts\u002Fdockge-update.mjs\n\n# Update specific stacks\nnode scripts\u002Fdockge-update.mjs mystack1 mystack2\n```\n\n### Socket.IO Protocol Details\n\nDockge uses Socket.IO with WebSocket transport.\n\n**Status codes:**\n- 1 = inactive\u002Fexited\n- 3 = running\n- 4 = updating\n\n**Key events:**\n- `login` — authenticate with username\u002Fpassword\n- `stackList` — get all stacks (received via `agent` event)\n- `agent`, \"\", \"updateStack\", stackName — trigger pull + restart\n\n**Note:** Stacks prefixed with `ix-` are TrueNAS-managed apps visible to Dockge — skip those when updating.\n\n## Monitoring Checklist\n\nRun these commands for a quick health overview:\n\n```bash\n# Pool health\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, healthy}'\n\n# Active alerts\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Falert\u002Flist\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {level, formatted}'\n\n# Running services\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fservice\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.state == \"RUNNING\") | .service'\n\n# App updates available\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.upgrade_available) | .name'\n\n# Replication status\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Freplication\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, state: .state.state}'\n```\n\n## Homelab Services\n\nThis skill includes reference files for common homelab service categories. Each covers\nAPI patterns, env vars, and common agent tasks for services that typically run alongside\nTrueNAS:\n\n| Reference | Services | File |\n|-----------|----------|------|\n| Media management | Overseerr, Sonarr, Radarr, Prowlarr, Plex, Tautulli | `references\u002Fmedia-management.md` |\n| App installation | TrueNAS native app install guide | `references\u002Fapp-installation.md` |\n| Download clients | qBittorrent, SABnzbd, FlareSolverr | `references\u002Fdownloads.md` |\n| Homelab services | ntfy, Syncthing, n8n, NocoDB, ChangeDetection, Crafty | `references\u002Fhomelab-services.md` |\n| Books & media | Audiobookshelf, LazyLibrarian, Calibre-Web, MeTube | `references\u002Fbooks-and-media.md` |\n| Bookmarks | Karakeep (AI-powered bookmark manager) | `references\u002Fbookmarks.md` |\n\nLoad the relevant reference file when the user asks about a specific service category.\n\n## Common Tasks\n\n### \"Check NAS health\"\n\nRun the monitoring checklist above. Summarize pool states, alerts, and any pending updates.\n\n### \"What's running?\"\n\n```bash\n# TrueNAS apps\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.state == \"RUNNING\") | .name'\n\n# Dockge stacks (if configured)\nnode scripts\u002Fdockge-list.mjs\n```\n\n### \"Install an app\"\n\nFollow the guide in `references\u002Fapp-installation.md`:\n1. Check app template for storage requirements\n2. Create dataset(s) under the apps pool\n3. Set ACL with apps preset\n4. Install app with correct storage mappings\n\n### \"Take a snapshot\"\n\n```bash\nnode scripts\u002Ftruenas-ws.mjs zfs.snapshot.create '[{\"dataset\": \"pool\u002Fdataset\", \"name\": \"manual-snapshot-name\"}]'\n```\n\n### \"What's downloading?\"\n\nSee `references\u002Fdownloads.md` for qBittorrent and SABnzbd API commands.\n\n### \"Add a movie\u002Fshow\"\n\nSee `references\u002Fmedia-management.md` for Overseerr request workflow.\n","# TrueNAS SCALE Skill\n\nManage a TrueNAS SCALE server and its apps via the TrueNAS API and Dockge Socket.IO.\n\n## Setup\n\n### Required Environment Variables\n\n```\nTRUENAS_URL       — TrueNAS base URL (e.g., https:\u002F\u002F10.0.0.5:444)\nTRUENAS_API_KEY   — API key from TrueNAS UI → API Keys\n```\n\n### Optional: TLS Configuration\n\n```\nTRUENAS_VERIFY_TLS  — Set to \"1\" to enforce TLS certificate validation (default: skip for self-signed certs)\n```\n\n### Optional: Dockge (Docker Compose UI)\n\n```\nDOCKGE_URL        — Dockge URL (e.g., http:\u002F\u002F10.0.0.5:5001)\nDOCKGE_USER       — Dockge login username\nDOCKGE_PASS       — Dockge login password\n```\n\n### Optional: Homelab Service API Keys\n\nSee the `references\u002F` directory for per-service env vars. Common ones:\n\n```\nSONARR_URL, SONARR_API_KEY           — TV show management\nRADARR_URL, RADARR_API_KEY           — Movie management\nPROWLARR_URL, PROWLARR_API_KEY       — Indexer management\nOVERSEERR_URL, OVERSEERR_API_KEY     — Media request UI\nPLEX_URL                             — Media server (no auth on LAN)\nTAUTULLI_URL, TAUTULLI_API_KEY       — Plex analytics\nQBITTORRENT_URL                      — Torrent client (no auth)\nSABNZBD_URL, SABNZBD_API_KEY         — Usenet client\nAUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY\nNTFY_URL                             — Push notifications\nSYNCTHING_URL, SYNCTHING_API_KEY     — File sync\nN8N_URL, N8N_API_KEY                 — Workflow automation\nNOCODB_URL, NOCODB_API_KEY           — Database\nCHANGEDETECTION_URL, CHANGEDETECTION_API_KEY\nCRAFTY_URL, CRAFTY_API_KEY           — Game servers\nLAZYLIBRARIAN_URL, LAZYLIBRARIAN_API_KEY\nMETUBE_URL                           — YouTube downloader\nKARAKEEP_URL, KARAKEEP_API_KEY       — Bookmarks with AI tagging\n```\n\n## API Notes\n\n**HTTPS REQUIRED:** TrueNAS auto-revokes API keys used over HTTP.\n\n> **REST API Deprecation Notice:** The REST API (`\u002Fapi\u002Fv2.0\u002F`) is deprecated in TrueNAS 25.04\n> and **fully removed in 26.04**. Use the WebSocket API (via `scripts\u002Ftruenas-ws.mjs`) as\n> the forward-compatible method. REST examples below still work on 24.10 and 25.x.\n\n### REST API (Legacy)\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002F[endpoint]\" \\\n  -H \"Authorization: Bearer $TRUENAS_API_KEY\"\n```\n\nThe `-k` flag is needed for self-signed certificates (common on home servers).\n\n### WebSocket API (Recommended)\n\nThe WebSocket API uses a DDP-like protocol (Meteor style). REST paths become dot notation:\n`\u002Fapi\u002Fv2.0\u002Fapp` → `app.query`, `\u002Fapi\u002Fv2.0\u002Fsystem\u002Finfo` → `system.info`.\n\n```javascript\n\u002F\u002F Connect: wss:\u002F\u002F\u003Chost>\u002Fwebsocket (rejectUnauthorized: false for self-signed)\n\n\u002F\u002F 1. Handshake\nsend: {\"msg\": \"connect\", \"version\": \"1\", \"support\": [\"1\"]}\nrecv: {\"msg\": \"connected\", \"session\": \"...\"}\n\n\u002F\u002F 2. Authenticate\nsend: {\"id\": \"1\", \"msg\": \"method\", \"method\": \"auth.login_with_api_key\", \"params\": [\"API_KEY\"]}\nrecv: {\"id\": \"1\", \"msg\": \"result\", \"result\": true}\n\n\u002F\u002F 3. Call methods\nsend: {\"id\": \"2\", \"msg\": \"method\", \"method\": \"system.info\", \"params\": []}\nsend: {\"id\": \"3\", \"msg\": \"method\", \"method\": \"app.query\", \"params\": []}\n```\n\nUse the helper script for WebSocket calls: `node scripts\u002Ftruenas-ws.mjs \u003Cmethod> [params_json]`\n\n## Security Notes\n\n- **Self-signed certificates:** TLS verification is skipped by default (`curl -k`, `rejectUnauthorized: false`) because homelab servers typically use self-signed certs. Set `TRUENAS_VERIFY_TLS=1` to enforce strict TLS validation.\n- **API key scope:** Use a read-only or least-privilege API key when possible. TrueNAS lets you scope keys to specific endpoints.\n- **Credentials stay local:** All env vars are read at runtime and sent only to the configured service endpoints. Nothing is phoned home.\n\n## Core Operations\n\n### System Info\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fsystem\u002Finfo\" -H \"Authorization: Bearer $TRUENAS_API_KEY\"\n```\n\n### Pool Health\n\n```bash\n# All pools with health status\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, healthy}'\n\n# Or via WebSocket\nnode scripts\u002Ftruenas-ws.mjs pool.query '[]'\n```\n\nThe API returns a `.healthy` boolean per pool. For deeper status, inspect the full pool object.\n\n### Active Alerts\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Falert\u002Flist\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {level, formatted}'\n```\n\n### Running Services\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fservice\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.state == \"RUNNING\") | .service'\n```\n\n## Dataset Management\n\n### List Datasets\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fdataset\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, type, used: .used.parsed, available: .available.parsed}'\n```\n\n### Create Dataset\n\n```bash\ncurl -sk -X POST \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fdataset\" \\\n  -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\": \"pool\u002Fpath\u002Fnew-dataset\"}'\n```\n\n### Delete Dataset\n\n```bash\n# Destructive — confirm with user first\ncurl -sk -X DELETE \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fdataset\u002Fid\u002FDATASET_ID\" \\\n  -H \"Authorization: Bearer $TRUENAS_API_KEY\"\n```\n\n## Snapshots & Replication\n\n### List Snapshots\n\n```bash\n# WebSocket (required on 25.10+, \u002Fapi\u002Fv2.0\u002Fzfs\u002Fsnapshot returns 404)\nnode scripts\u002Ftruenas-ws.mjs zfs.snapshot.query '[]'\n```\n\n### Create Snapshot\n\n```bash\nnode scripts\u002Ftruenas-ws.mjs zfs.snapshot.create '[{\"dataset\": \"pool\u002Fdataset\", \"name\": \"manual-YYYY-MM-DD\"}]'\n```\n\n### Snapshot Task Status\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\u002Fsnapshottask\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {dataset, schedule, enabled}'\n```\n\n### Replication Health\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Freplication\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, state: .state.state}'\n```\n\n## App Management\n\nTrueNAS Apps are the official marketplace for installing containerized services.\n\n### List Installed Apps\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, state, version}'\n```\n\n### Check for Updates\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.upgrade_available) | .name'\n```\n\n### Install \u002F Update Apps\n\nSee `references\u002Fapp-installation.md` for the full installation guide covering:\n- Checking app templates and storage requirements\n- Creating datasets with proper ACLs\n- Installing with correct storage mappings\n- Handling apps with multiple storage mounts\n\n### App Status\n\n```bash\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp?name=APP_NAME\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[0] | {name, state, portals}'\n```\n\n## Dockge (Docker Compose Stacks)\n\nDockge is a companion UI for Docker Compose stacks not in the TrueNAS Apps catalog.\nIt uses Socket.IO, not REST. Use the provided scripts.\n\n### Prerequisites\n\n```bash\nnpm install   # in this skill's root directory\n```\n\n### List Stacks\n\n```bash\nnode scripts\u002Fdockge-list.mjs\n```\n\n### Update Stacks\n\n```bash\n# Update all running stacks\nnode scripts\u002Fdockge-update.mjs\n\n# Update specific stacks\nnode scripts\u002Fdockge-update.mjs mystack1 mystack2\n```\n\n### Socket.IO Protocol Details\n\nDockge uses Socket.IO with WebSocket transport.\n\n**Status codes:**\n- 1 = inactive\u002Fexited\n- 3 = running\n- 4 = updating\n\n**Key events:**\n- `login` — authenticate with username\u002Fpassword\n- `stackList` — get all stacks (received via `agent` event)\n- `agent`, \"\", \"updateStack\", stackName — trigger pull + restart\n\n**Note:** Stacks prefixed with `ix-` are TrueNAS-managed apps visible to Dockge — skip those when updating.\n\n## Monitoring Checklist\n\nRun these commands for a quick health overview:\n\n```bash\n# Pool health\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fpool\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, healthy}'\n\n# Active alerts\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Falert\u002Flist\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {level, formatted}'\n\n# Running services\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fservice\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.state == \"RUNNING\") | .service'\n\n# App updates available\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.upgrade_available) | .name'\n\n# Replication status\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Freplication\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | {name, state: .state.state}'\n```\n\n## Homelab Services\n\nThis skill includes reference files for common homelab service categories. Each covers\nAPI patterns, env vars, and common agent tasks for services that typically run alongside\nTrueNAS:\n\n| Reference | Services | File |\n|-----------|----------|------|\n| Media management | Overseerr, Sonarr, Radarr, Prowlarr, Plex, Tautulli | `references\u002Fmedia-management.md` |\n| App installation | TrueNAS native app install guide | `references\u002Fapp-installation.md` |\n| Download clients | qBittorrent, SABnzbd, FlareSolverr | `references\u002Fdownloads.md` |\n| Homelab services | ntfy, Syncthing, n8n, NocoDB, ChangeDetection, Crafty | `references\u002Fhomelab-services.md` |\n| Books & media | Audiobookshelf, LazyLibrarian, Calibre-Web, MeTube | `references\u002Fbooks-and-media.md` |\n| Bookmarks | Karakeep (AI-powered bookmark manager) | `references\u002Fbookmarks.md` |\n\nLoad the relevant reference file when the user asks about a specific service category.\n\n## Common Tasks\n\n### \"Check NAS health\"\n\nRun the monitoring checklist above. Summarize pool states, alerts, and any pending updates.\n\n### \"What's running?\"\n\n```bash\n# TrueNAS apps\ncurl -sk \"$TRUENAS_URL\u002Fapi\u002Fv2.0\u002Fapp\" -H \"Authorization: Bearer $TRUENAS_API_KEY\" \\\n  | jq '.[] | select(.state == \"RUNNING\") | .name'\n\n# Dockge stacks (if configured)\nnode scripts\u002Fdockge-list.mjs\n```\n\n### \"Install an app\"\n\nFollow the guide in `references\u002Fapp-installation.md`:\n1. Check app template for storage requirements\n2. Create dataset(s) under the apps pool\n3. Set ACL with apps preset\n4. Install app with correct storage mappings\n\n### \"Take a snapshot\"\n\n```bash\nnode scripts\u002Ftruenas-ws.mjs zfs.snapshot.create '[{\"dataset\": \"pool\u002Fdataset\", \"name\": \"manual-snapshot-name\"}]'\n```\n\n### \"What's downloading?\"\n\nSee `references\u002Fdownloads.md` for qBittorrent and SABnzbd API commands.\n\n### \"Add a movie\u002Fshow\"\n\nSee `references\u002Fmedia-management.md` for Overseerr request workflow.\n",{"name":5,"license":15,"homepage":24,"metadata":25,"description":37,"compatibility":38},"https:\u002F\u002Fgithub.com\u002Fanotb\u002Ftruenas-skill",{"author":26,"version":27,"openclaw":28},"anotb","1.2.0",{"requires":29,"primaryEnv":32},{"env":30,"bins":33},[31,32],"TRUENAS_URL","TRUENAS_API_KEY",[34,35,36],"curl","jq","node","Manage TrueNAS SCALE via API. Check pool health, manage datasets and snapshots, monitor alerts, control services, manage apps, orchestrate Dockge container stacks, and manage bookmarks. Use when the user asks about their NAS, storage, backups, containers, bookmarks, or homelab services.\n","Requires curl, jq, and Node.js 18+. Network access to TrueNAS instance.","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fanotb\u002Ftruenas-skill",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill truenas-skill",{"tool":54,"command":55},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill truenas-skill",{"tool":57,"command":58},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill truenas-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fanotb\u002Ftruenas-skill\u002FSKILL.md",true,[],[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":70},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":70},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":70},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":70},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":70},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":70},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]