A secure interface for AI agents to interact with iCloud Drive, Photos, and Find My services using local authentication and safety gates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install icloud
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install icloud using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is iCloud?
The iCloud skill is a specialized module designed for the Openclaw Skills ecosystem that empowers AI agents to operate within Apple's cloud environment. It provides a bridge to iCloud Drive, Photos, and Find My services, allowing for tasks such as file inspection, device tracking, and media metadata retrieval. Built with a security-first mindset, this skill ensures that all authentication occurs locally on the user's machine, keeping sensitive Apple ID credentials and 2FA codes entirely out of the chat history.
By leveraging this skill, developers can automate workflows that involve personal data stored in the Apple ecosystem while maintaining high safety standards. The skill utilizes a read-first methodology, meaning agents must verify the environment and account scope before escalating to any write operations, ensuring precision and preventing accidental data loss.
iCloud Use Cases
- Tracking Apple device locations and statuses through Find My integration.
- Automating the organization and retrieval of documents within iCloud Drive.
- Accessing and managing photo metadata or media files from iCloud Photos.
- Building complex automation routines that require secure access to personal Apple cloud data.
- Enhancing AI agent capabilities with cross-device synchronization via the Openclaw Skills framework.
How iCloud Works
- The skill initiates a local authentication flow using the pyicloud library, requiring the user to handle 2FA via a terminal prompt.
- Once authenticated, the agent performs a read-only discovery phase to map available devices, folders, and photo albums.
- Operational context is stored in a structured local directory (~/icloud/) to track session status and account scope without persisting secrets.
- For any high-risk operations, such as deleting files or enabling Lost Mode, the skill generates a summary and requires explicit user approval.
- Every action is followed by a deterministic verification step, where the agent re-reads the state from Apple's servers to confirm success.
iCloud Setup
To integrate this skill into your environment, ensure you have Python 3 installed and follow these steps to set up the Openclaw Skills dependency:
# Install the pyicloud dependency
pip install pyicloud==2.4.1
# Initialize the iCloud directory for local memory
mkdir -p ~/icloud/
# Follow the secure integration guidelines in the local setup file
cat setup.md
iCloud Data Schema & Taxonomy
The iCloud skill organizes its operational data locally to ensure reliability and transparency. This is part of the standard data management pattern in Openclaw Skills:
| File | Purpose |
|---|---|
memory.md |
Tracks the current account scope, integration mode, and session status. |
operations-log.md |
Records all executed commands, result checks, and rollback instructions. |
device-map.md |
Maps device aliases to stable, unique Apple device IDs. |
drive-map.md |
Maintains a verified map of iCloud Drive folder paths and structures. |
safety-events.md |
Logs all risky actions that received explicit user confirmation. |
iCloud Advanced Features
- Local interactive authentication that bypasses the need to share credentials in agent conversations.
- Read-only escalation workflow that mandates discovery before any state-changing operations.
- Built-in safety boundaries for risky actions like lost mode activation or bulk file deletion.
- Idempotent operation handling to ensure repeat-safe commands across the Openclaw Skills platform.
- Real-time session expiry handling that pauses workflows to restore trust through local re-authentication.
SKILL.md
Loading
Related Openclaw Skills
Ibiza AI Travel & Lifestyle Agent
A high-fidelity guidance system for navigating Ibiza as a traveler, remote worker, or entrepreneur.
Hype
A comprehensive assistant for Hyperliquid perpetuals trading, account management, and L1 ecosystem interactions.
Hungarian
Transform stiff, robotic AI-generated Hungarian into warm, authentic, and human-sounding conversational text.
Hugging Face
A comprehensive integration for Openclaw Skills to discover, benchmark, and execute Hugging Face models and datasets with built-in compliance checks.
Icons
A technical framework for implementing accessible, performant, and scalable SVG icons in modern web applications.
IELTS Study Assistant
A comprehensive AI study assistant for IELTS candidates featuring automated scoring, band gap analysis, and progress tracking.
Featured*
