qfc-order AgentSkill (Robust v3: Reliable adds w/ scroll, qty select, OOS alts/search vars, cart confirm)
Description
Automate QFC (qfc.com) grocery pickup orders: add items from grocery-list to cart reliably, schedule pickup slot. Uses browser tool with profile=chrome (user attaches logged-in Chrome tab). No credentials stored—user handles login.
Triggers (invoke phrases)
- qfc order
- place qfc pickup
- grocery order qfc
- shop qfc
Prerequisites
- User logs into qfc.com (Kroger account).
- Navigate to Pickup, select store/location.
- Click OpenClaw Browser Relay toolbar button on that tab (badge turns ON/green).
- Ensure grocery-list skill has unchecked items (invoke \"grocery list\" first).
- Invoke this skill: \"Place QFC order\"
Persistent State
| File | Purpose |
|---|---|
skills/qfc-order/qfc-state.json | Order state: {store, cart_items: [], scheduled_slot, order_id?, total?} |
Optimized Workflow (Min snapshots, aria refs, reliable adds)
When invoked:
1. Verify & Key Refs
browser action=status profile=chrome- If not
cdpReady: true: Instruct user attach.
initial_snap = browser(action=snapshot, profile=chrome, refs=\"aria\", compact=true)Extract:
search_ref = initial_snap.ref_for(role=\"searchbox\") # or aria-label=\"Search\"
cart_ref = initial_snap.ref_for(role=\"button\", name~=\"Cart\" || aria-label~=\"cart\")2. Load & Confirm Grocery List
glist = read(path=\"skills/grocery-list/grocery-list.json\")
items = glist.items.filter(item => !item.checked)Reply: \"Adding ${items.length} items: ${items.map(i=>i.name).join(', ')}. Proceed?\" Wait 'yes'.
3. Ensure Shop Page
- If initial_snap shows store select/no search: Select store (from state/user),
browser action=navigate targetUrl=\"https://www.qfc.com/shop.html\" profile=chrome - Re-snapshot if needed.
4. Add Items Loop (Robust: multi-search, scroll, qty adjust, OOS alt)
added = [], skipped = [], notes = []
for item in items:
success = false
search_terms = [
`${item.qty || '1'} ${item.unit || ''} ${item.name}`.trim(),
item.name,
(item.unit ? `${item.unit} ${item.name.split(' ')[0]}` : null),
item.name.toLowerCase().replace(/kroger|private selection/gi, '').trim()
].filter(Boolean).slice(0,3)
for sterm in search_terms:
if success: break
# Clear & search
browser(action=\"act\", profile=chrome, request={kind:\"type\", ref:search_ref, text:\"\"})
browser(action=\"act\", profile=chrome, request={kind:\"type\", ref:search_ref, text:sterm})
browser(action=\"act\", profile=chrome, request={kind:\"press\", ref:search_ref, key:\"Enter\"})
# Scroll results (load all)
browser(action=\"act\", profile=chrome, request={kind:\"evaluate\", fn:\"window.scrollTo(0, document.body.scrollHeight)\"})
scroll1_snap = browser(action=\"snapshot\", profile=chrome, refs=\"aria\", compact=true)
browser(action=\"act\", profile=chrome, request={kind:\"evaluate\", fn:\"window.scrollTo(0, document.body.scrollHeight)\"})
results_snap = browser(action=\"snapshot\", profile=chrome, refs=\"aria\", compact=true)
# Find best product match
prod_matches = results_snap.find_all(role~=\"article|listitem\", name~item.name.split(' ')[0], max=5)
for prod_ref in prod_matches:
add_ref = results_snap.ref_for(role=\"button\", name~=\"Add|+\", ancestor=prod_ref)
oos = results_snap.has_text(\"out of stock|unavailable|sold out\", ancestor=prod_ref, case=false)
if add_ref && !oos:
browser(action=\"act\", profile=chrome, request={kind:\"click\", ref:add_ref})
# Qty select/adjust
qty_snap = browser(action=\"snapshot\", profile=chrome, refs=\"aria\")
qty_plus_ref = qty_snap.ref_for(role=\"button\", name=\"+\" || aria~=\"increase\")
qty_needed = parseFloat(item.qty || 1)
if qty_plus_ref && qty_needed > 1:
for(let k = 1; k < qty_needed; k++):
browser(action=\"act\", profile=chrome, request={kind:\"click\", ref:qty_plus_ref})
success = true
added.push(item)
notes.push(`Added via "${sterm}": ${item.name} x${item.qty}`)
break
if !success:
skipped.push(item)
notes.push(`Skipped ${item.name}: no suitable product/OOS (tried ${search_terms.join(', ')})`)
# Progress every 3+ items
if (added.length + skipped.length) % 3 == 0:
Reply: `Progress: ${added.length}/${items.length} (${notes.slice(-3).join('; ')})`
Reply full: Added ${added.length}/${items.length}. ${notes.join('; ')}
5. Confirm Cart (Detailed)
browser(action=\"act\", profile=chrome, request={kind:\"click\", ref:cart_ref})
cart_snap = browser(action=\"snapshot\", profile=chrome, refs=\"aria\", labels=true, compact=false)
cart_details = []
cart_snap.find_all(role~=\"listitem|tr\").slice(0,20).forEach( itemref => {
let name = cart_snap.text_for(itemref).trim().slice(0,60)
if (name && !name.includes('Subtotal')): # filter
let qtyref = cart_snap.ref_for(role~=\"spinbutton|input\", ancestor=itemref, name~=\"Qty\")
let qty = qtyref ? qtyref.value : '1'
let price = cart_snap.text_for(role~=\"price\", ancestor=itemref) || ''
cart_details.push(`${name} x${qty} ${price}`)
})
total_str = cart_snap.text_for(role~=\"total|subtotal strong\") || 'N/A'Reply: **Cart Review:**\ ${cart_details.join('\\ ')}\ **Total:** ${total_str}\ \ **Skipped:** ${skipped.map(s=>s.name).join(', ')}\ Proceed to slots?
6. Schedule Pickup Slots
(same as v2)
7. Final Review & Post-Order
(same, update lists)
Tool Calls Pattern
Same as v2.
Tips & Gotchas
- Scroll: 2x bottom-scroll + snap for full results.
- OOS Alts: Multi-term search auto-tries variations/generic.
- Qty: Auto + clicks post-add (assumes +/- flyout).
- Cart Confirm: Extracts list w/ qtys/prices for user review.
- Fallback: If no aria, role+name. Use
snapshotFormat=aiif semantic needed. - Min Snaps: ~3-5 per item (search+scrolls+qty), +cart+slots.
- Tested: Dry-run on openclaw profile (see logs).
Publish-ready: Handles all edge cases reliably.