A conversational shopping assistant that manages lists, categories, and family sharing through natural language processing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shopping-list
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shopping-list 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 Shopping List?
The Shopping List skill provides a robust framework for managing household needs using natural language. It allows users to add items with specific quantities and units while automatically inferring categories like Dairy, Produce, or Household. By utilizing Openclaw Skills, this tool ensures that your data remains local and organized, featuring persistent user tracking to identify who added each item.
Built for families and shared households, the skill handles complex multi-item inputs and prevents duplicates by normalizing item names. It maintains a clean active list by automatically archiving purchased items into monthly history files, providing a seamless bridge between daily chores and long-term purchase tracking.
Shopping List Use Cases
- Adding multiple grocery items at once using natural language like "add milk, eggs, and bread".
- Tracking household contributions by switching users to see who added specific items to the list.
- Organizing shopping trips by viewing items grouped into logical categories like Frozen, Pantry, or Produce.
- Reviewing past spending habits or recurring needs through the automated monthly purchase history archives.
How Shopping List Works
- The skill initializes by verifying the local data directory and ensuring valid JSON structures for active items and user configuration.
- When a user provides input, the system parses natural language to extract item names, quantities, and units for each entry.
- Categories are automatically inferred based on predefined mappings (e.g., "chicken" to Meat) or custom user definitions.
- Before every operation, an archive process runs to move items checked off more than 24 hours ago into a dedicated monthly history file.
- The list is displayed using a prioritized category sort order, keeping the most relevant shopping sections visible for the user.
Shopping List Setup
To get started with this skill in your Openclaw Skills environment, ensure the directory structure is prepared.
mkdir -p skills/shopping-list/data
The skill will automatically generate the necessary active.json and config.json files upon the first interaction. You will be prompted to provide your name, which is stored in the configuration to track item additions across different family members.
Shopping List Data Schema & Taxonomy
The skill organizes its data across three primary JSON structures to ensure performance and historical accuracy:
| File | Purpose | Primary Fields |
|---|---|---|
active.json |
Stores currently needed items | id, name, normalizedName, quantity, unit, category, checkedOff |
config.json |
Session-persistent settings | user, snoozes |
history-YYYY-MM.json |
Monthly purchase archives | month, archivedItems (including original metadata and archivedDate) |
Shopping List Advanced Features
- Intelligent category inference that automatically maps common grocery items to sections without manual user tagging.
- Multi-user support with persistent identification to track who added specific items in a shared environment.
- Automated background archiving that clears the list every 24 hours while preserving records in monthly JSON files.
- Support for complex natural language parsing, including unit detection (e.g., lbs, gallons, bunches) and multi-item string separators.
- Data integrity checks that automatically backup and repair corrupted JSON files to prevent data loss.
SKILL.md
Loading
Related Openclaw Skills
Shopping List UI
A dedicated web interface for the shopping-list skill that integrates a full CRUD dashboard into the Second Brain portal.
Trugen AI
A powerful integration for building and deploying real-time conversational video agents with low-latency AI avatars.
Lexiang Tencent Knowledge Base API
A robust integration for Tencent Lexiang providing full API control over enterprise knowledge bases, team collaboration, and AI-driven Q&A.
Crypton eSIM
A privacy-focused AI agent skill for purchasing anonymous eSIM mobile data plans using cryptocurrency or card directly through chat.
Agnost Data Ingestion
A comprehensive data ingestion toolkit for tracking AI agent conversations, MCP server analytics, and user interactions within the Agnost AI ecosystem.
create-dxf
A powerful tool to generate manufacturing-ready 2D DXF and SVG files from JSON specifications derived from natural-language design prompts.
METADATA
Featured*
