AIFS - AI File System for Openclaw

A simple HTTP REST API for persistent cloud file storage designed for AI agents and developer workflows.

deploydon
v1.0.0
Jan 31, 2026
2
4.1k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install aifs-space

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 aifs-space 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 AIFS - AI File System?

AIFS (AI File System) provides a streamlined way to store, retrieve, and manage files in the cloud. It is specifically built to help developers and AI models persist data across sessions, share information between different agents, and maintain a consistent file system without the complexity of traditional cloud providers. By integrating this into your Openclaw Skills, you gain the ability to store session notes, logs, and project specifications in a structured, accessible environment using standard HTTP methods.

This system acts as a bridges the gap between ephemeral agent memory and permanent storage. Whether you are building a coding assistant that needs to remember project context or a research agent that aggregates data, this tool provides the necessary infrastructure to keep your data organized and retrievable via a simple API key authentication system.

AIFS - AI File System Use Cases

  • Persisting session notes and conversation history across different AI interactions to maintain context.
  • Sharing structured data or configuration files between multiple independent AI agents.
  • Storing and retrieving user-generated content or documents in a cloud-native directory structure.
  • Maintaining project-specific documentation and specifications in organized folders for better management.
  • Creating automated logs for long-running processes that need to be accessible from any device or session.

How AIFS - AI File System Works

  1. The user obtains an API key by signing up at AIFS.space, choosing from key types like admin, read-write, or read-only.
  2. The skill authenticates with the AIFS API using a Bearer token passed in the Authorization headers.
  3. When saving data, the agent sends a POST request to the write endpoint, which automatically creates any necessary directories up to 20 levels deep.
  4. To retrieve data, the agent calls the read endpoint, with the option to fetch the entire file or specific line ranges for efficiency.
  5. For updates, the system supports PATCH requests to modify specific lines without needing to rewrite the entire file content.
  6. All files can be listed or summarized via dedicated endpoints to provide a quick overview of the stored data.

AIFS - AI File System Setup

To get started with this skill, follow these steps:

  1. Sign up at AIFS.space and generate your API key.
  2. Configure your environment by setting the API key variable:
export AIFS_API_KEY='your_aifs_api_key_here'
  1. You can verify the connection using a simple curl command to list your files:
curl -H "Authorization: Bearer $AIFS_API_KEY" https://aifs.space/api/files
  1. Ensure your agent is configured to use this key when executing Openclaw Skills related to cloud storage.

AIFS - AI File System Data Schema & Taxonomy

AIFS organizes data using a hierarchical path-based system. Each file entry contains metadata to help manage storage efficiently within your Openclaw Skills workflows.

Attribute Type Description
path String The unique file path (e.g., projects/alpha/notes.md)
size Number The file size in bytes
modifiedAt String ISO 8601 timestamp of the last update
content String The actual text data stored in the file
total_lines Number Total line count for line-range operations

Files are logically grouped into folders which are created automatically upon file creation. The system supports a maximum directory depth of 20 levels.

AIFS - AI File System Advanced Features

  • Granular Permission Control: Use different keys for admin, read-write, read-only, or write-only access to secure your data.
  • Line-Level Patching: Update specific parts of a large file using the PATCH method to save bandwidth and reduce processing overhead.
  • Efficient Pagination: Read specific line ranges (start_line to end_line) to handle large documents without loading the full payload.
  • Automated Directory Management: Deep directory structures are handled automatically during write operations, simplifying complex data organization.
  • Quick Summarization: Use the summary endpoint to retrieve the first 500 characters of a file for fast previews and indexing.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*