ai-pa

name	ai-pa
description	Route and execute inter-PA coordination tasks in the OpenClaw multi-agent PA network. Triggers when: contacting another PA, passing a message between owners, broadcasting to a PA group, handling group lead/silence rules, or adding a new PA to the directory. NOT for: contact lookups (use contact-list skill), calendar invites (use meetings skill), or billing issues (use billing-monitor skill).

AI-PA Network Skill

Minimum Model

Any model that can follow numbered steps and run bash commands.

---

Directory Setup

All contact and PA data lives in contact-list.md (workspace root). This is the single source of truth. For lookups (phone, PA, group JID) → use the contact-list skill first, then return here for coordination.

❌ data/pa-directory.json is deprecated. Use contact-list.md instead.

---

Group Leadership Rules

Some groups in the PA network have a designated lead PA. When a group has a lead:

• Only the lead PA responds to questions in that group
• Other PAs stay silent unless explicitly tagged by the lead
• This prevents duplicate/echo answers

Current Group Ownership

Group	JID	Lead PA	Rule
PA Onboarding	[e-mail]	Heleni	Heleni responds to all questions. All other PAs: stay silent unless Heleni tags you.

If you are NOT the lead PA for a group → do not respond to general questions there. You may still respond if:

1. Heleni (the lead) directly tags your name
2. Your owner sends a message directly to you in the group

---

Core Rules

Contact the PA (not the owner) for:

• Scheduling meetings
• Passing messages between owners
• Coordination and follow-ups

Contact the owner directly only when:

• Their PA is unresponsive for >1 hour on a time-sensitive matter
• Explicitly instructed by your owner

Never contact an owner directly if contact_preference is "pa_only".

---

Task Templates

Find a PA's Contact

Use the contact-list skill → lookup by owner name in contact-list.md. The PA column shows PA_NAME (+phone). The Active PAs section has full details.

grep -i "OWNER_NAME" /path/to/workspace/contact-list.md

If no match found → ask your owner for the contact details.

Schedule a Meeting

1. Use the contact-list skill to find the other PA's phone and owner details in contact-list.md
2. Message the PA:
   "Hey [PA Name], [your owner] wants to meet [their owner].
    Are they available [proposed time]? Or what works best?"
3. Wait for reply. If no reply after 2 hours on a business day:
   → Follow up once.
   If no reply after 4 hours:
   → Tell your owner and suggest contacting them directly.
4. Once agreed, create calendar event:
   GOG_ACCOUNT=[e-mail] gog calendar create primary \
     --summary "Meeting: [Owner A] + [Owner B]" \
     --start "YYYY-MM-DDTHH:MM:SS+00:00" \
     --end "YYYY-MM-DDTHH:MM:SS+00:00" \
     --attendees "[e-mail]"
5. Confirm with both PAs

Broadcast to All PAs

1. Use contact-list.md to find the PA coordination group JID
2. Send to the group (not individual DMs)
3. For personal follow-ups only: DM each PA individually

If no coordination group exists → message each PA individually and suggest creating one.

Send Email on Owner's Behalf

Always confirm with owner before sending.

GOG_ACCOUNT=[e-mail] gog gmail send \
  --to "[e-mail]" \
  --subject "Subject" \
  --body "Body"

If gog returns an auth error:

gog auth add [e-mail] --services gmail
# Then retry the send command

---

Add a New PA to Directory

Use the contact-list skill's "Add a New PA" flow. It updates contact-list.md with:

1. New row in Active PAs table
2. PA info in the owner's contact row
3. New DM target in PA Sync List
4. Git push

---

PA Unresponsive Protocol

1. Try messaging their phone number again
2. If no response after 2 hours on a business day → contact their owner (only if contact_preference allows)
3. Log the issue in your memory files

---

Quick Reference

Task	Action
Find PA phone	Use contact-list skill → grep contact-list.md
Schedule meeting	Contact other PA → agree time → create calendar event
Broadcast message	Use PA coordination group JID
Billing issue	See billing-monitor skill
New PA	Use contact-list skill → add to contact-list.md → announce in group
PA unresponsive	Wait 2h → contact owner if urgent
Directory missing	Create from schema above

---

Cost Tips

• Cheap: Simple lookups (find phone, list PAs) — any small model works
• Expensive: Multi-step coordination with reasoning (timezones, conflicts) — use larger model only when needed
• Batch: When adding multiple PAs, run one Python script — not one per PA
• Avoid: Don't search the web for contact info if it's in the local directory

---

Error Reference

Error	Cause	Fix
Legacy pa-directory.json missing	Usually harmless, because contact-list.md is the source of truth	Ignore unless a legacy consumer explicitly requires the JSON mirror
JSON parse error in legacy directory	Bad file format in an optional compatibility file	Run python3 -m json.tool data/pa-directory.json only if that legacy file is still in use
PA not found	Spelling mismatch or not added	Search by partial name in contact-list.md; add the PA there
gog auth error	Token expired	Re-run gog auth add [e-mail] --services gmail
No PA coordination group	Early-stage network	Message individually; suggest creating a group