fi-collar

name	fi-collar
description	Check Potato's Fi collar GPS location, battery, and connection status. Use when asked where Potato is, collar battery level, or whether Potato is at Crosstown or the Cabin.
allowed-tools	Bash(fi-collar:*)
metadata	{"openclaw":{"emoji":"F","requires":{"bins":["fi-collar"]}}}

Fi Collar — Potato's GPS Tracker

Check Potato's real-time GPS location, battery, and connection status via the Fi Series 3+ collar API.

Commands

Get current location

fi-collar location

Returns JSON with GPS coordinates, nearest known location (crosstown/cabin), distance, and whether Potato is within the home geofence.

Get full status

fi-collar status

Returns JSON with location + battery level, connection type (Base/User/Cellular), activity type (Rest/Walk), and Fi base station status.

Get walk path (during active walk only)

fi-collar walk-path

Returns the dense GPS polyline from Fi's OngoingWalk — timestamped positions and path points. Returns {"walking": false} if not currently on a walk.

Set collar mode

fi-collar set-mode NORMAL      # standard GPS (~3-7min updates)
fi-collar set-mode LOST_DOG    # high-frequency GPS (~15-30s updates)

LOST_DOG mode drains battery faster — used automatically by the dog walk listener during walks, then reset to NORMAL on return.

Test login

fi-collar login

Example Output

{
  "name": "Potato",
  "activity": "Rest",
  "latitude": ${CABIN_LAT},
  "longitude": ${CABIN_LON},
  "location": "cabin",
  "distance_m": 26,
  "at_location": true,
  "battery": 97,
  "connection": "User",
  "connectionDetail": "Dylan",
  "place": "Philly",
  "address": "[private address]"
}

Integration with Dog Walk Listener

Fi GPS is polled every 60s during dog walk return monitoring. When Potato re-enters the home geofence, Roombas are docked automatically. This works at both Crosstown and Cabin locations.

Auth

• Account: ${TRYFI_EMAIL} (password in TRYFI_PASSWORD env var)
• Session cached at ~/.config/fi-collar/session.json (12hr TTL, auto-re-login on 401)
• Credentials: TRYFI_EMAIL + TRYFI_PASSWORD in ~/.openclaw/.secrets-cache

Collar Details

• Dog: Potato
• Collar: Fi Series 3+, Serial ${TRYFI_COLLAR_SERIAL}
• Pet ID: ${TRYFI_PET_ID}
• Base station: "Crosstown" at Crosstown Ave (always online, WiFi connected)
• GPS: GNSS (GPS + GLONASS + Galileo), updates every ~7 min at rest, more frequent during walks
• Cellular: Built-in LTE for GPS reporting when away from WiFi/base

Geofence

Home locations loaded from env vars (CROSSTOWN_LAT/LON, CABIN_LAT/LON in secrets-cache):

• Crosstown: 150m radius
• Cabin: 300m radius (larger due to rural setting)