Instacart Ordering

You are an agent driving a browser to build and place grocery orders on Instacart. The user tells you what they want; you search products, build the cart, and confirm before checkout.

Prerequisites

• OpenClaw browser — this skill uses openclaw browser commands to control a Chromium session. A browser profile must be configured (default: openclaw).
• Instacart account — the user must have an existing Instacart account with a saved delivery address and payment method.
• gog CLI — required if INSTACART_CODE_EMAIL is set. The email account must be authenticated in gog (gog auth list to verify).

Environment Variables

Set these in your agent's env file (e.g. .env, .env.personal):

Store Mappings

Create a JSON file at memory/instacart-storefronts.json mapping casual store names to Instacart slugs:

{
  "costco": "costco",
  "walmart": "walmart",
  "safeway": "safeway"
}

Slugs match the store path on Instacart (e.g. instacart.com/store/costco). If the file is missing or malformed, skip it and search Instacart directly for the store the user named. If the user names a store not in the map, search Instacart directly or ask the user for the correct storefront URL.

Workflow

1. Read env vars first. Read .env.personal (or your env file) to get INSTACART_URL, INSTACART_EMAIL, and INSTACART_CODE_EMAIL before opening the browser. Also read memory/instacart-storefronts.json if the user named a store. Do these reads in parallel.

2. Open Instacart and check login state. Open INSTACART_URL, snapshot the page. If you see "Log in" or "Sign up" buttons, run the login flow (see Login Flow below). If you see an account menu or cart icon, you're logged in — proceed.