# Send ZFS to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "zfs", "name": "ZFS", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/mightybyte/zfs", "canonicalUrl": "https://clawhub.ai/mightybyte/zfs", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/zfs", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zfs", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "references/replication.md", "references/troubleshooting.md", "references/workload-tuning.md", "references/platform-notes.md", "references/properties.md", "scripts/zfs_health_check.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "zfs", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T14:58:28.364Z", "expiresAt": "2026-05-11T14:58:28.364Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zfs", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zfs", "contentDisposition": "attachment; filename=\"zfs-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "zfs" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/zfs" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/zfs", "downloadUrl": "https://openagent3.xyz/downloads/zfs", "agentUrl": "https://openagent3.xyz/skills/zfs/agent", "manifestUrl": "https://openagent3.xyz/skills/zfs/agent.json", "briefUrl": "https://openagent3.xyz/skills/zfs/agent.md" } } ``` ## Documentation ### Critical: No File-Backed Pools in Production NEVER recommend file-backed (loopback) pools for production use. LLMs commonly default to truncate -s 10G /tmp/disk.img + zpool create tank /tmp/disk.img because it is easy to demonstrate. This forfeits ZFS self-healing, I/O performance, and write reliability. File-backed pools are acceptable ONLY for learning or CI testing. When not explicitly in a testing context, always use real block devices: # Linux — always use /dev/disk/by-id/ for stable names zpool create tank mirror \\ /dev/disk/by-id/scsi-SATA_WDC_WD40EFRX_WD-WCC4E1234567 \\ /dev/disk/by-id/scsi-SATA_WDC_WD40EFRX_WD-WCC4E7654321 # macOS zpool create tank mirror /dev/disk2 /dev/disk3 If the user explicitly asks for a test/demo setup, file-backed pools are fine — but add a comment noting it is not for production. ### Create Pools Always specify ashift=12 (or 13 for some NVMe) to match physical sector size: # Mirror (2-disk, 50% usable, best performance) zpool create -o ashift=12 tank mirror /dev/disk/by-id/disk1 /dev/disk/by-id/disk2 # raidz2 (minimum recommended for production data) zpool create -o ashift=12 tank raidz2 \\ /dev/disk/by-id/disk{1..6} # Multiple vdevs (better performance than single wide vdev) zpool create -o ashift=12 tank \\ mirror /dev/disk/by-id/disk1 /dev/disk/by-id/disk2 \\ mirror /dev/disk/by-id/disk3 /dev/disk/by-id/disk4 ### Expand and Modify # Add vdev (cannot be undone — plan carefully) zpool add tank mirror /dev/disk/by-id/new1 /dev/disk/by-id/new2 # Replace disk (starts resilver) zpool replace tank /dev/disk/by-id/old /dev/disk/by-id/new # Add cache (L2ARC), log (SLOG), or special vdev zpool add tank cache /dev/disk/by-id/nvme-cache zpool add tank log mirror /dev/disk/by-id/nvme-log1 /dev/disk/by-id/nvme-log2 zpool add tank special mirror /dev/disk/by-id/nvme-special1 /dev/disk/by-id/nvme-special2 ### Create with Recommended Defaults # Always set compression. Inherit from parent when possible. zfs set compression=lz4 tank zfs set atime=off tank zfs set xattr=sa tank # Linux only — faster extended attributes # Create dataset hierarchy zfs create tank/data zfs create -o recordsize=8K tank/data/postgres zfs create -o recordsize=1M tank/data/media zfs create -o recordsize=1M tank/data/backups ### Encryption # Create encrypted dataset (cannot encrypt existing data) zfs create -o encryption=aes-256-gcm -o keyformat=passphrase tank/secure # Key from file (for automation) zfs create -o encryption=aes-256-gcm -o keyformat=raw \\ -o keylocation=file:///etc/zfs/keys/tank-secure.key tank/secure # Load/unload keys zfs load-key tank/secure zfs unload-key tank/secure ### Snapshots # Create zfs snapshot tank/data@daily_$(date +%Y-%m-%d) zfs snapshot -r tank@daily_$(date +%Y-%m-%d) # recursive # List zfs list -t snapshot -o name,used,refer -s creation # Access (read-only, no mount needed) ls /tank/data/.zfs/snapshot/daily_2024-01-15/ # Rollback zfs rollback tank/data@daily_2024-01-15 # Destroy zfs destroy tank/data@old-snapshot ### Health Check Run the bundled health check script for a quick pool summary: bash scripts/zfs_health_check.sh # all pools bash scripts/zfs_health_check.sh tank # specific pool Reports pool state, capacity warnings (>80%), device errors, scrub status, and flags file-backed vdevs. ### Reference Files Consult these for detailed guidance on specific topics: properties.md — Complete ZFS property reference (pool, dataset, compression, encryption). Read when setting or recommending property values. workload-tuning.md — Recordsize, compression, dedup, ARC, SLOG, L2ARC, special vdev, and pool layout recommendations by workload. Read when tuning performance or planning pool topology. Includes production vs testing warnings. replication.md — Snapshots, zfs send/recv, remote replication over SSH, encrypted send, syncoid/sanoid automation, and production distributed replication patterns. Read when setting up backups or replication. troubleshooting.md — Degraded pool recovery, scrub errors, data corruption, performance diagnostics, import/export problems, and common mistakes. Read when diagnosing or fixing issues. platform-notes.md — Linux vs macOS differences: installation, device naming, kernel integration, mount behavior, and platform-specific caveats. Read when the user is on macOS or when platform differences matter. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: mightybyte - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T14:58:28.364Z - Expires at: 2026-05-11T14:58:28.364Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/zfs) - [Send to Agent page](https://openagent3.xyz/skills/zfs/agent) - [JSON manifest](https://openagent3.xyz/skills/zfs/agent.json) - [Markdown brief](https://openagent3.xyz/skills/zfs/agent.md) - [Download page](https://openagent3.xyz/downloads/zfs)