mirroir
Control a real iPhone through macOS iPhone Mirroring — screenshot, tap, swipe, type, launch apps, record video, OCR, and run multi-step scenarios. Works with any app on screen, no source code or jailbreak required.
Why use this skill?
Learn how to use the Mirroir skill to control your iPhone via macOS iPhone Mirroring. Automate taps, swipes, and app navigation directly from OpenClaw.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/jfarcand/mirroirWhat This Skill Does
The Mirroir skill acts as a powerful bridge between OpenClaw and your physical iPhone. By leveraging the macOS Sequoia iPhone Mirroring feature, it provides an interface for the AI to view and manipulate your mobile device in real-time. Unlike traditional software-based emulators, Mirroir interacts with the actual hardware, allowing it to perform any task a human can, such as tapping buttons, swiping through menus, entering text, and launching installed apps. It utilizes advanced OCR to understand the current screen state, ensuring that the agent can adapt to dynamic app interfaces without needing underlying source code or device modifications like jailbreaking.
Installation
Installation is straightforward but requires specific macOS permissions to function correctly. You can install it via a one-line terminal command: /bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)". Alternatively, users comfortable with package managers can use Homebrew via brew tap jfarcand/tap && brew install iphone-mirroir-mcp. Once the binary is installed, ensure you have enabled the necessary Karabiner-Elements DriverKit extensions in System Settings under 'Login Items & Extensions'. Proper accessibility and screen recording permissions must also be granted to the OpenClaw agent to allow for the visual analysis and input relay necessary to operate the device.
Use Cases
The Mirroir skill is indispensable for automating cross-platform workflows. Use it to send messages via apps like WhatsApp or Signal that aren't natively supported by macOS, add events to your iPhone-exclusive calendar, or conduct end-to-end testing of mobile-first applications. It is particularly effective for managing device settings, taking screenshots for documentation, or navigating complex mobile login flows that require multi-factor authentication inputs. If a task involves interacting with an app that lives exclusively on your phone, Mirroir is the correct tool.
Example Prompts
- "Open my iPhone, go to Instagram, and post the latest photo from my camera roll with the caption 'Weekend vibes'."
- "Check my iPhone settings to see if my cellular data is enabled and toggle it off if it is on."
- "Look at my iPhone screen and tell me if I have any new notifications from the Reminders app, then swipe them away."
Tips & Limitations
Always ensure that your iPhone is unlocked and the iPhone Mirroring app is active on your macOS desktop before invoking the skill. Mirroir performs best when the screen is not obstructed by pop-ups or transition animations. Note that for security-sensitive operations (like banking apps or FaceID prompts), the agent may require manual authentication. If the agent struggles to identify buttons, use the describe_screen tool to help the AI map the UI coordinates accurately. Avoid using this skill for tasks that have better-integrated macOS alternatives, such as managing desktop-synced notes or sending messages via the standard Messages.app.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-jfarcand-mirroir": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, code-execution