FamilyWall Integration

FamilyWall family organization platform integration for managing calendars, lists, messaging, and more.

Authentication

FamilyWall uses email/password authentication with session tokens. Required environment variables:

• FAMILYWALL_EMAIL - FamilyWall account email
• FAMILYWALL_PASSWORD - FamilyWall account password

These should be set in ~/.openclaw/.env.

Test connection:

source ~/.openclaw/.env && {baseDir}/scripts/familywall.py status

Quick Reference

All operations use the {baseDir}/scripts/familywall.py script:

Common Workflows

Check upcoming family events

source ~/.openclaw/.env
{baseDir}/scripts/familywall.py events list --days 7

Add items to shopping list

source ~/.openclaw/.env
# First get the list ID
{baseDir}/scripts/familywall.py lists list
# Then add items
{baseDir}/scripts/familywall.py lists add "tasklist/12345_67890" "Milk"
{baseDir}/scripts/familywall.py lists add "tasklist/12345_67890" "Bread"
{baseDir}/scripts/familywall.py lists add "tasklist/12345_67890" "Eggs" --quantity "12"

Create a calendar event

source ~/.openclaw/.env
{baseDir}/scripts/familywall.py events create "Family Dinner" \
  --start "2026-05-15T18:00:00" \
  --end "2026-05-15T20:00:00" \
  --location "Home" \
  --description "Weekly family dinner"

Send a family message

source ~/.openclaw/.env
# Get thread list first
{baseDir}/scripts/familywall.py messages threads
# Send message to a thread
{baseDir}/scripts/familywall.py messages send "imthread/12345_67890" "Dinner is ready!"

Check family member locations

source ~/.openclaw/.env
{baseDir}/scripts/familywall.py locations

API Details

The FamilyWall API is at https://api.familywall.com/api. Authentication is session-based:

1. Login via log2in endpoint with email/password
2. Receive JSESSIONID cookie and tokenCsrf
3. Include both on subsequent requests

Key API Endpoints

Request Format

All requests are POST with application/x-www-form-urlencoded body. Parameters use prefix notation:

• a00 prefix for first call parameters
• a01call, a02call, etc. for batched calls
• partnerScope=Family required on all calls

Response Format

Responses are JSON with structure:

{
  "a00": {
    "r": {"r": <result_data>},  // Success
    "ex": {"ex": {"message": "..."}},  // Error
    "cn": "endpoint_name"
  }
}

Error Handling

Common errors:

• FizClassId 1: Account not found
• FizClassId 4: Account identifier not validated
• FizClassId 10: API key not found
• FizClassId 26: Account blocked
• FizClassId 502: Call not registered / missing parameter
• FizClassId 503: Model does not exist
• FizClassId 510: No family context (need to select family first)

Dependencies

• Python 3.10+ (uses stdlib urllib if requests not available)
• Optional: requests library for better HTTP handling

Full API Reference

The complete API definition is stored at {baseDir}/references/htmlformdef.js (559KB). This contains all endpoints, parameters, return types, and exceptions for the entire FamilyWall platform.

Available API categories:

• acc - Account management
• admin - Family admin rights
• album - Photo/media
• billing - Credits, subscriptions
• budget - Family budgets
• color - Color palette
• credit - Premium management
• ctc - Contacts
• device - Push notifications
• evt - Calendar events
• fam - Family management, invitations
• filer - File storage
• geo - Geocoding
• google - Google calendar sync
• im - Instant messaging
• key - API keys
• launchpad - Dashboard
• loc - Location, geofencing
• log2 - Authentication
• prf - Profiles
• recipe - Recipes
• settings - Family settings
• tasklist - Shopping/task lists
• wall - Family wall/feed
• web - Web utilities