FamilyWall Integration

Interact with the FamilyWall family organization platform. Manage calendar events, shopping lists, tasks, family messaging, member locations, and the family wall/feed. Use when: (1) checking family calendar or creating events, (2) managing shopping lists or to-do items, (3) sending/reading family messages, (4) checking family member locations, (5) viewing the family wall/feed. Triggers: "family calendar", "family events", "shopping list", "grocery list", "family message", "family chat", "family location", "where is", "family wall", "family feed", "add to list", "family members", "familywall".

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:

Operation	Command
Status & Members
Account/family status	{baseDir}/scripts/familywall.py status
List family members	{baseDir}/scripts/familywall.py members
Calendar Events
List upcoming events	{baseDir}/scripts/familywall.py events list --days 7
Create event	{baseDir}/scripts/familywall.py events create "Title" --start "2026-03-10T14:00:00" --end "2026-03-10T15:00:00"
Create all-day event	{baseDir}/scripts/familywall.py events create "Holiday" --start "2026-03-10" --end "2026-03-11" --allday
Delete event	{baseDir}/scripts/familywall.py events delete EVENT_ID
Shopping Lists / Tasks
List all lists	{baseDir}/scripts/familywall.py lists list
View list items	{baseDir}/scripts/familywall.py lists items LIST_ID
Add item to list	{baseDir}/scripts/familywall.py lists add LIST_ID "Milk"
Add with quantity	{baseDir}/scripts/familywall.py lists add LIST_ID "Eggs" --quantity "12"
Check item (purchased)	{baseDir}/scripts/familywall.py lists check ITEM_ID
Uncheck item	{baseDir}/scripts/familywall.py lists check ITEM_ID --uncheck
Create new list	{baseDir}/scripts/familywall.py lists create "Groceries" --type SHOPPING
Create todo list	{baseDir}/scripts/familywall.py lists create "Chores" --type TODO
Messaging
List threads	{baseDir}/scripts/familywall.py messages threads
Read messages	{baseDir}/scripts/familywall.py messages read THREAD_ID --limit 20
Send message	{baseDir}/scripts/familywall.py messages send THREAD_ID "Hello family!"
Location
Get member locations	{baseDir}/scripts/familywall.py locations
Wall / Feed
Get family wall	{baseDir}/scripts/familywall.py wall --limit 20

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

Category	Endpoint	Description
Auth	log2in	Login with email/password
Account	accgetallfamily	Get all family data
Family	famlistfamily	List user's families
Events	evtlist	List calendar events
Events	evtcreate	Create event
Events	evtdelete	Delete event
Lists	tasklistlist	List all task/shopping lists
Lists	tasklistget	Get list with items
Lists	tasklistadd	Add item to list
Lists	tasklistcheck	Check/uncheck item
Lists	tasklistcreate	Create new list
Messages	imthreadlist	List IM threads
Messages	immessagelist	Get messages from thread
Messages	imsend	Send message
Location	loclist	Get member locations
Wall	walllist	Get wall/feed posts

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