FTP Client Skill (ZC)#

Skill ID: ftp-client-zc

Description: Provides basic FTP operations (list, upload, download, delete, rename) for a configured FTP server. All operations are performed via the Node.js basic-ftp library. Credentials are obtained from OpenClaw's secret store (key ftp-client-zc/cred) or, as a fallback, from a local creds.json file (which is excluded from publishing).

Parameters#

ActionRequired argsOptional argsDescriptionlist``host (or use stored)path (remote directory, default /)List files/directories in the given remote path.upload``localPath, remotePath``hostUpload a local file (or directory) to the FTP server.download``remotePath, localPath``hostDownload a remote file (or directory) to local filesystem.delete``remotePath``hostDelete a remote file or empty directory.rename``oldPath, newPath``hostRename or move a remote file/directory.

If host, user, and password are omitted, the skill will first try to read them from the OpenClaw secret ftp-client-zc/cred; if not found, it falls back to the local creds.json (which should not be published).

Usage Examples#

text

# List root directory (uses stored credentials)
openclaw skill run ftp-client-zc list

# Upload a file, overriding host
openclaw skill run ftp-client-zc upload --host 47.119.167.86 --user test --password zhangchong --localPath "C:\path\file.txt" --remotePath "/uploads/file.txt"

Security#

• Credentials are never logged.
• All network actions require explicit user approval via /approve before execution.
• When using the local creds.json fallback, ensure the file is protected by filesystem permissions and is excluded from the published npm package via .npmignore.

---

Created by 张小龙🦞