| 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
fi-collar set-mode LOST_DOG
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)