AList-CLI for Openclaw

A comprehensive CLI bridge for the AList file management API, enabling AI agents to control diverse cloud storage backends through a unified interface.

leeshunee
v0.0.1
Mar 30, 2026
0
768
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install test-502

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install test-502 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is AList-CLI?

AList-CLI is a powerful integration designed to bridge the gap between AI coding agents and diverse cloud storage environments. By leveraging Openclaw Skills, this tool provides a standardized way to interact with the AList API, which supports dozens of storage providers like Google Drive, OneDrive, and local disks. It allows developers and automated agents to perform complex file operations without needing to implement provider-specific logic.

This skill is particularly valuable for workflows that require moving data between remote environments or managing large-scale assets. As part of the Openclaw Skills ecosystem, AList-CLI ensures that your AI agent has the necessary file system permissions and capabilities to act as a remote file manager, enhancing productivity in both development and devops contexts.

AList-CLI Use Cases

  • Automating the upload of build artifacts or generated assets to a remote cloud storage mount.
  • Searching for specific project documents across multiple cloud providers using a single unified query.
  • Organizing self-hosted media libraries by remotely creating directories and moving files.
  • Integrating cloud-to-local file synchronization within an AI-driven development workflow.

How AList-CLI Works

  1. The AI agent identifies a file management intent, such as a request to upload or list files in a cloud directory.
  2. The Openclaw Skills runtime invokes the AList-CLI script using the provided environment credentials.
  3. The script authenticates with the configured AList server using the login command to obtain a session.
  4. The command (e.g., upload, ls, or mv) is translated into a REST API request sent to the AList backend.
  5. The AList server executes the operation on the specific storage provider and returns the result back to the CLI.
  6. The agent receives a structured response, allowing it to proceed with the next step in the development task.

AList-CLI Setup

To get started with this skill, you must first configure your connection to an active AList server. Set the following environment variables in your workspace:

export ALIST_URL="https://your_alist_server"
export ALIST_USERNAME="your_username"
export ALIST_PASSWORD="your_password"

Once configured, you can execute commands via the Python bridge as follows:

python scripts/alist_cli.py login
python scripts/alist_cli.py ls /your/remote/path

AList-CLI Data Schema & Taxonomy

The AList-CLI skill organizes its data interactions based on the AList OpenAPI specification. It manages metadata and file structures as described below:

Component Description
Auth Token Managed internally after a successful login command.
File Object Includes name, size, modified time, and provider-specific attributes.
Path Mapping Uses virtual paths that map to specific mount points within AList.
API Version Compatible with AList V3 API endpoints.

AList-CLI Advanced Features

  • Unified search functionality across all mounted cloud storages via a single interface.
  • Support for offline downloading, allowing agents to trigger remote transfers without local bandwidth usage.
  • Granular file management commands including mkdir, mv, and rm for full remote lifecycle control.
  • Seamless integration with other Openclaw Skills for complex multi-step data processing pipelines.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*