FaceTime Auto Call
/install facetime-auto-call
FaceTime Auto-Call Tool
A reliable tool for making FaceTime calls programmatically through AppleScript automation.
🎯 Tool Definition
Tool Name: facetime-auto-call
Parameters:
mode:audio|video|find-contact|testcontact: Phone number or email address
Usage:
bash /path/to/facetime-auto-call/scripts/call.sh \x3Cmode> \x3Ccontact>
📋 Prerequisites
Required: NodeRunner.app Wrapper
macOS requires .app bundle for accessibility permissions (daemon processes are blocked).
Quick Setup:
bash /path/to/facetime-auto-call/scripts/setup.sh
Manual Authorization:
- System Settings → Privacy & Security → Accessibility
- Add
~/Applications/NodeRunner.app - Enable
See: OpenClaw Issue #940
🚀 Tool Usage
Audio Call (Recommended)
bash /path/to/facetime-auto-call/scripts/call.sh audio "[email protected]"
bash /path/to/facetime-auto-call/scripts/call.sh audio "+1234567890"
Video Call
bash /path/to/facetime-auto-call/scripts/call.sh video "[email protected]"
Find Contact
bash /path/to/facetime-auto-call/scripts/call.sh find-contact "John"
Test
bash /path/to/facetime-auto-call/scripts/call.sh test
🤖 Natural Language Interface
When user says:
- "Call John" → Call
facetime-auto-calltool withaudiomode and contact info - "Video call with X" → Call
facetime-auto-calltool withvideomode - "Call +1..." → Call
facetime-auto-calltool withaudiomode and phone number
Example:
User: "Call John"
Agent: bash /path/to/facetime-auto-call/scripts/call.sh audio "[email protected]"
🔔 Automation Integration
Use in monitoring scripts:
# Token monitoring example
if [ "$MARKET_CAP" -lt "$TARGET" ]; then
bash /path/to/facetime-auto-call/scripts/call.sh audio "[email protected]"
fi
🔧 Technical Details
Notification Depth Handling
macOS notification UI depth varies (7-10 layers) based on:
- Notification type (Banner vs List)
- Content complexity (text vs images/buttons)
- macOS version (Sequoia uses SwiftUI)
Solution: Multi-depth fallback (8 → 9 → 7 → 10)
Why This Design?
Per Apple Documentation:
- SwiftUI auto-layout creates nested groups
- Different notification types have different structures
- This is Apple's design, not a bug
📊 Reliability
- ✅ Audio calls: 100%
- ✅ Video calls: 100%
- ✅ Notification clicking: 100% (8-9 layer coverage)
- ✅ Contact search: 100%
🐛 Troubleshooting
Permission Error
Error: "System Events" cannot access...
Fix:
ls ~/Applications/NodeRunner.app # Check if exists
bash /path/to/facetime-auto-call/scripts/setup.sh # Re-setup
Notification Not Appearing
Cause: FaceTime process not started Fix: Script auto-cleans and restarts FaceTime
Button Not Found
Error: Button not found (-2700)
Cause: Notification depth outside 8-9 range
Fix: Use Accessibility Inspector to check actual depth
open /System/Library/CoreServices/Applications/Accessibility\ Inspector.app
📚 References
🎉 Version History
-
v4.1 (2026-03-11) - Simplified reliable version
- Removed dynamic path building
- Fixed path + multi-depth fallback
- Button description verification
- 100% success rate
-
v3.0 (2026-03-11) - Environment cleanup version
- Added FaceTime process cleanup
- Smart path finding (8-10 layers)
- Notification verification
-
v2.0 (2026-03-11) - NodeRunner.app version
- Created .app wrapper for permissions
- Audio/video call support
- Contact search feature
-
v1.0 (2026-03-11) - Initial version
- Basic FaceTime calling
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install facetime-auto-call - After installation, invoke the skill by name or use
/facetime-auto-call - Provide required inputs per the skill's parameter spec and get structured output
What is FaceTime Auto Call?
Make FaceTime audio/video calls via AppleScript. Automatically handles notification clicking with multi-depth fallback. Use when user wants to call someone o... It is an AI Agent Skill for Claude Code / OpenClaw, with 128 downloads so far.
How do I install FaceTime Auto Call?
Run "/install facetime-auto-call" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is FaceTime Auto Call free?
Yes, FaceTime Auto Call is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does FaceTime Auto Call support?
FaceTime Auto Call is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created FaceTime Auto Call?
It is built and maintained by keziqicoze09-del (@keziqicoze09-del); the current version is v1.0.0.