AgentSkillsCN

bring-shopping-list

当用户咨询购物清单、采购食材、“加入购物清单”、“清单里有什么”、“从清单中移除”等与购物或食材相关的问题时，可使用此功能。该功能可无缝对接Bring!购物清单应用。

SKILL.md
--- frontmatter
name: bring-shopping-list
description: Use when asked about the shopping list, groceries, "add to shopping list", "what's on the list", "remove from list", or any shopping/grocery related request. Integrates with the Bring! shopping list app.
argument-hint: "[add|remove|list] [items...]"
user-invocable: false
metadata:
  openclaw:
    requires:
      env:
        - BRING_EMAIL
        - BRING_PASSWORD
      bins:
        - uv
    primaryEnv: BRING_EMAIL

Bring! Shopping List

Manage a Bring! shopping list — add items, remove items, mark items as completed, and check what's on the list.

Setup

  1. •Install uv if not already installed
  2. •Set environment variables for your Bring! account:
    bash
    export BRING_EMAIL="your-email@example.com"
export BRING_PASSWORD="your-password"
    Or add them to a .env file in your project root.

If you use Google login for Bring!, go to your Bring! account settings and set a separate password first.

Usage

All commands use bring.py in this skill's directory. Adjust the path based on where you installed the skill.

With uv (recommended)

bash
uv run --with bring-api --with python-dotenv python bring.py list --json
uv run --with bring-api --with python-dotenv python bring.py add "Milk" "Eggs" "Butter:Irish"
uv run --with bring-api --with python-dotenv python bring.py remove "Milk"
uv run --with bring-api --with python-dotenv python bring.py complete "Eggs"

With pip

bash
pip install -r requirements.txt
python bring.py list --json
python bring.py add "Milk" "Eggs" "Butter:Irish"
python bring.py remove "Milk"
python bring.py complete "Eggs"

Handling Requests

  1. •

    Parse the user's message for:

    • •Items to add ("add milk and eggs to the list")
    • •Items to remove ("remove milk from the list")
    • •Checking the list ("what's on the shopping list?")
    • •Item details/specs ("milk, but low fat" -> Milk:low fat)
  2. •

    Run the appropriate CLI command

  3. •

    Confirm the action naturally

Notes

  • •Requires BRING_EMAIL and BRING_PASSWORD environment variables
  • •Items can have optional specs via colon syntax: name:specification
  • •Uses the first (default) shopping list in the account
  • •Dependencies (bring-api, python-dotenv) are handled inline by uv run --with, or via pip install -r requirements.txt