← Back to Skills Marketplace
swor-dart

smb-auto-mount

by Sword-Art · GitHub ↗ · v1.0.7 · MIT-0
cross-platform ✓ Security Clean
138
Downloads
1
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install smb-auto-mount
Description
Auto-mount Windows SMB shares on Linux with systemd automount. Credentials entered interactively, never passed via command line. Requires sudo, cifs-utils (m...
Usage Guidance
This skill appears to do exactly what it says: create on-demand systemd-mounted SMB shares and store credentials in /etc with root-only permissions. Before using it: (1) read the three scripts fully (they are included) and confirm you are comfortable with the exact changes to /etc/fstab and the creation of /etc/smb-creds-<name>.txt; (2) back up /etc/fstab (the README even suggests this); (3) test with the one-time mount first (mount-smb.sh) before adding persistent entries; (4) run locally from a trusted account — do not grant remote agents or automated services sudo that could run these scripts unattended; (5) after removing a persistent mount, delete its /etc/smb-creds-*.txt; and (6) if you prefer not to keep plaintext credential files under /etc, consider alternative credential storage (system keyring) or use ephemeral mounts. The scripts include input validation and use secure prompts, which is good practice; the main remaining risk is the expected system-level impact of modifying fstab and storing credentials as root-readable files.
Capability Analysis
Type: OpenClaw Skill Name: smb-auto-mount Version: 1.0.7 The smb-auto-mount skill bundle provides scripts for managing SMB shares on Linux. It follows security best practices by using interactive password prompts (read -s) to avoid command-line exposure, creating restricted credential files (mode 600), and using temporary files for smbclient operations. While the scripts require sudo and modify /etc/fstab, these actions are necessary for the stated purpose and are clearly documented in SKILL.md and the script logic (add-to-fstab.sh, mount-smb.sh).
Capability Assessment
Purpose & Capability
Name/description match the included scripts and required tools. Requiring sudo, cifs-utils, and smbclient is appropriate for auto-mounting SMB shares and editing /etc/fstab.
Instruction Scope
SKILL.md instructs the user to run the provided scripts which explicitly prompt for passwords and warn about modifying /etc/fstab. The scripts do modify system-wide configuration and create persistent credential files in /etc; this is expected for persistent mounts but is high-impact and should be reviewed before running.
Install Mechanism
No automated install; the skill is instruction/script-only. That keeps the risk low because nothing is downloaded or written automatically by an installer.
Credentials
No external environment variables or unrelated credentials are requested. The scripts rely on standard sudo-provided SUDO_UID/SUDO_GID values and prompt interactively for passwords, which aligns with the stated design to avoid command-line password exposure.
Persistence & Privilege
The scripts intentionally create persistent state (fstab entries and /etc/smb-creds-*.txt files) and enable systemd automount units; this is coherent with the feature but elevates persistence and must be run with root privileges. The skill itself is not forced-always and does not declare extra privileges, but running the scripts requires sudo.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install smb-auto-mount
  3. After installation, invoke the skill by name or use /smb-auto-mount
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
Metadata: Fixed required binaries format in description for registry parsing
v1.0.6
Metadata: Added dependencies and system requirements to frontmatter description
v1.0.5
Docs: Added security warnings, removed unsafe password examples, added metadata config
v1.0.4
Security: interactive password input, idempotent fstab, dynamic UID/GID, dependency checks
v1.0.3
Security: sanitize local-name, use -A for smbclient to hide password from ps
v1.0.2
Simplified scripts and docs. Removed AI fluff.
v1.0.1
Security: Use credential files instead of plaintext passwords in fstab. Added Chinese documentation.
v1.0.0
Initial release of smb-auto-mount. - Automatically mount Windows SMB shares on Linux using systemd automount. - Includes scripts for share discovery, persistent fstab configuration, and manual mounting. - Supports on-demand mounting with fast offline timeout handling. - Provides troubleshooting guidance and security recommendations. - Suitable for managing multiple Windows SMB connections from Linux.
Metadata
Slug smb-auto-mount
Version 1.0.7
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 8
Frequently Asked Questions

What is smb-auto-mount?

Auto-mount Windows SMB shares on Linux with systemd automount. Credentials entered interactively, never passed via command line. Requires sudo, cifs-utils (m... It is an AI Agent Skill for Claude Code / OpenClaw, with 138 downloads so far.

How do I install smb-auto-mount?

Run "/install smb-auto-mount" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is smb-auto-mount free?

Yes, smb-auto-mount is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does smb-auto-mount support?

smb-auto-mount is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created smb-auto-mount?

It is built and maintained by Sword-Art (@swor-dart); the current version is v1.0.7.

💬 Comments