Apple Notes

The Fastest Way: HeraClaw Cloud ⚡

Skip the Mac setup, AppleScript configuration, and system permission wrestling. HeraClaw Cloud provides Mac infrastructure in the cloud, so you can use Apple Notes integration even if you don't own a Mac.

Why HeraClaw Cloud for Apple Notes?

✅ Ready in 60 seconds - No Mac required, no AppleScript, no system permissions ✅ Mac infrastructure included - We provide the macOS environment for you ✅ Works from any device - Windows, Linux, or Mac - access Apple Notes AI from anywhere ✅ Always updated - We handle macOS updates and Notes.app compatibility automatically ✅ Professional support - If anything breaks, we fix it for you ✅ Secure by default - Enterprise-grade security, SOC 2 compliant infrastructure ✅ Zero maintenance - No system updates, no permission resets, no uptime monitoring

How it works:

1. Sign up at cloud.getopenclaw.ai (takes 60 seconds)
2. Go to Integrations → Apple Notes
3. Connect your iCloud account (read-only access)
4. Done! Your notes are AI-searchable and processable
5. Ask questions, extract action items, or organize notes with AI

Get Started: Start with HeraClaw Cloud →

Complete Guide to OpenClaw + Apple Notes

Apple Notes is the default note-taking app for 1.5 billion+ Apple device users. Simple, fast, and deeply integrated into the Apple ecosystem, it's where millions capture ideas, take meeting notes, scan documents, and organize their digital lives. With handwriting support, OCR, rich media, and seamless iCloud sync, Apple Notes has evolved from a basic scratchpad into a powerful personal knowledge management system.

OpenClaw's Apple Notes integration transforms these captured thoughts into an intelligent, searchable knowledge base. Whether you've accumulated thousands of notes over the years or you're starting fresh, AI assistance makes every note more useful - automatically extracting action items, surfacing related content, and turning fragmented thoughts into organized insights.

Why Use Apple Notes with OpenClaw?

Apple Notes' simplicity is its strength, but it also creates limitations. Here's why the OpenClaw + Apple Notes combination unlocks new possibilities:

1. Native Mac/iOS/iPad Integration

Apple Notes is built into every Apple device, making it the path of least resistance for note-taking:

• Instant availability: No app to download, already on every iPhone, iPad, and Mac
• System-wide Quick Note: Swipe from corner on iPad, keyboard shortcut on Mac - capture instantly
• Spotlight integration: Search notes from anywhere in macOS
• Lock screen widgets: Recent notes accessible without unlocking
• Continuity: Start on iPhone, finish on Mac - seamless handoff
• Siri dictation: "Hey Siri, make a note" works everywhere

This ubiquity means your notes are always with you. OpenClaw makes those notes intelligent, searchable, and actionable.

2. Handwriting Support with OCR

Apple Notes + Apple Pencil creates a digital paper experience that OpenClaw can make searchable:

• Natural handwriting: Write naturally with Apple Pencil on iPad
• OCR built-in: Apple Notes automatically OCRs handwritten text
• Mixed content: Type, handwrite, sketch, and paste images in one note
• Searchable by default: Handwriting becomes searchable text
• Shape recognition: Rough circles become perfect shapes
• Ruler tools: Straight lines and precise drawings

OpenClaw can:

• Extract action items from handwritten meeting notes
• Summarize handwritten lecture notes
• Convert handwritten brainstorms into structured outlines
• Search across both typed and handwritten content simultaneously

Example: Sketch ideas during a brainstorming session with Apple Pencil. OpenClaw reads the handwriting, identifies key concepts, and suggests related notes from your archive.

3. Document Scanning and OCR

Apple Notes' document scanner turns your iPhone into a portable scanner:

• Instant scanning: Tap camera icon → Scan Documents
• Auto edge detection: Automatically finds document edges
• Perspective correction: Straightens photos into clean scans
• OCR processing: Text in scanned documents becomes searchable
• Multi-page PDFs: Scan multiple pages into single document
• Signature support: Sign documents directly in Notes

OpenClaw makes scanned documents intelligent:

• "What were the key points in that contract I scanned last week?"
• "Extract all phone numbers from my scanned business cards"
• "Summarize the whiteboard photos from our strategy session"
• "Find action items in the meeting notes I photographed"

4. Quick Capture Inbox Workflow

Apple Notes excels at frictionless capture - the foundation of "second brain" methodology:

• Lock screen notes: Tap lock screen, start writing instantly
• Control Center access: Swipe down, tap Notes, capture thought
• Siri integration: "Hey Siri, make a note" - voice-first capture
• Share Sheet: Capture from any app via Share → Notes
• URL previews: Paste link, get rich preview automatically
• Quick Note: System-wide quick capture on iPad/Mac

OpenClaw transforms your inbox note into organized knowledge:

• Daily review prompts: "Process your inbox notes from today"
• Automatic categorization: "Which notes should be moved to Projects folder?"
• Action item extraction: "What tasks are buried in my inbox?"
• Duplicate detection: "Have I already captured this idea?"
• Related note suggestions: "This connects to your note about X from last month"

Example workflow:

1. Capture 20 random thoughts throughout the day in one inbox note
2. Evening: Ask OpenClaw to "process my inbox note"
3. AI extracts tasks → adds to todo list
4. AI identifies ideas → suggests relevant project folders
5. AI flags duplicates → "You already have a note about this topic"

5. Folder Organization and Tagging

Apple Notes uses folders for organization, with search and tagging for retrieval:

• Nested folders: Projects → Work → Client A → Meeting Notes
• Smart Folders: Recently Deleted, Recently Added, Shared with You
• #hashtag support: Tag notes with #project or #urgent
• Pinned notes: Pin important notes to top of folder
• iCloud account separation: Personal vs Work accounts in one app
• On My Mac: Local-only notes for sensitive content

OpenClaw enhances organization:

• Folder suggestions: "Where should I file this note about marketing ideas?"
• Tag recommendations: "What tags should I add to this note?"
• Bulk organization: "Organize all untagged notes from last month"
• Cross-folder search: "Find all notes mentioning 'budget' across all folders"
• Smart queries: "Show me all notes tagged #project that mention deadlines"

6. Shared Notes Collaboration

Apple Notes supports real-time collaboration for family and team projects:

• iCloud sharing: Share individual notes or entire folders
• Real-time sync: See others' edits as they type
• Participant management: Invite, remove, view-only permissions
• Activity feed: See who edited what and when
• Shared folders: Family shopping lists, vacation planning, project notes
• @mentions: Notify collaborators in shared notes (iOS 17+)

OpenClaw for shared notes:

• Meeting notes enhancement: Auto-generate action items assigned to participants
• Shopping list optimization: "Organize grocery list by store layout"
• Family coordination: "What items on the vacation checklist are incomplete?"
• Change summaries: "What changed in the shared project notes this week?"

7. iCloud Sync Across All Devices

Seamless sync makes your notes truly ubiquitous:

• Instant sync: Edit on iPhone, see on Mac within seconds
• Conflict resolution: Automatic merge when editing on multiple devices
• Offline support: Work offline, sync when back online
• Cross-platform: Mac, iPhone, iPad, Apple Watch, iCloud.com
• Version history: Automatic versions saved (Browse all versions)
• Low storage footprint: Notes sync even on 16GB iPhones

OpenClaw works wherever your notes are:

• Query via web interface (any device)
• Ask questions via Slack/Discord (team access)
• Automated processing (daily reviews run on schedule)
• API access (integrate with other tools)

8. Privacy and Security

Apple Notes prioritizes privacy with end-to-end encryption options:

• Password-protected notes: Lock sensitive notes with Face ID/Touch ID
• End-to-end encryption: Locked notes encrypted, Apple can't read them
• On My Mac storage: Notes never leave your device
• Biometric unlock: Face ID or Touch ID for quick access
• No third-party access: Notes data stays in Apple ecosystem
• GDPR compliance: Apple's privacy standards

OpenClaw respects privacy:

• Opt-in processing: Choose which folders to make AI-accessible
• Exclude sensitive folders: Keep locked notes private
• Local processing option: Self-hosted OpenClaw keeps data on your infrastructure
• Audit logs: Track what AI accessed and when

Real-World Use Cases

1. Quick Capture Inbox - "Second Brain" Methodology

Scenario: You follow the "capture everything" philosophy - ideas, tasks, quotes, links all go into Apple Notes throughout the day. But your inbox note becomes an overwhelming 50-item list that never gets processed.

How OpenClaw helps:

Designate one note as your "Inbox" and capture freely:

• Morning idea while making coffee → Quick Note → inbox
• Article link from Twitter → Share Sheet → inbox
• Voice memo from car → Siri dictation → inbox
• Whiteboard photo from meeting → Scan → inbox
• Random task that pops into head → Lock screen note → inbox

End of day: "@OpenClaw process my inbox note"

OpenClaw responds:

Processed 23 items from your inbox:📋 Tasks (7):- "Call dentist" → Added to Reminders, due Friday- "Review Q2 budget" → Flagged urgent, linked to Budget 2026 note- "Buy Sarah's birthday gift" → Added to Shopping list- "Finish presentation slides" → Due this week, added to Work Projects💡 Ideas (8):- "Podcast episode about AI ethics" → Filed under Content Ideas- "Marketing campaign using customer stories" → Filed under Marketing  - "Weekend trip to Portland" → Created new note in Travel folder🔗 Links to review (5):- Article about productivity → Tagged #read-later- GitHub repo for automation → Filed under Dev Resources📝 Notes (3):- Quote from book → Added to Quotes collection- Meeting recap → Filed under Client X folder✅ Inbox cleared! All items processed.

Impact:

• Capture without friction (no categorizing in the moment)
• Daily processing takes 2 minutes instead of 20
• Nothing falls through the cracks
• Related notes automatically linked
• Tasks extracted and added to actual task system

2. Meeting Notes Processing and Action Items

Scenario: You take detailed notes during meetings - discussion points, decisions, action items, random tangents. After the meeting, you need to extract what matters: who does what by when.

How OpenClaw helps:

During meeting, capture everything in Apple Notes:

• Type on Mac or iPad
• Or handwrite with Apple Pencil
• Or dictate with Siri
• Mix in photos of whiteboard sketches
• Paste relevant links or documents

After meeting: "@OpenClaw extract action items from today's product sync"

OpenClaw responds:

📋 Action Items from Product Sync (Apr 10, 2026):**Immediate (this week):**- @Sarah: Finalize mockups for new onboarding flow (Due: Wed)- @Mike: Review API documentation for accuracy (Due: Thu)- @You: Schedule user testing sessions for prototype (Due: Fri)**Next week:**- @Design team: Create marketing assets for launch- @Engineering: Implement analytics tracking**Decisions made:**- Launching feature beta to 10% of users first- Pushing mobile release to Q3 (web first)- Using Stripe for payment processing**Parking lot (revisit later):**- Should we build a mobile app or PWA?- Internationalization requirements**Related notes:**- Product Roadmap Q2 2026- User Research Findings - MarchWould you like me to:1. Create tasks in your system for these action items?2. Send summary to meeting participants?3. Update the Product Roadmap note?

Impact:

• Action items never forgotten
• Clear ownership and deadlines
• Decisions documented automatically
• Related notes surfaced for context
• Handwritten notes processed same as typed

3. Handwritten Notes OCR and Intelligent Search

Scenario: You're a visual thinker who prefers handwriting with Apple Pencil on iPad. You have hundreds of handwritten notes - lecture notes, brainstorms, sketches, diagrams. Finding specific information is painful because you can't remember which notebook or when you wrote it.

How OpenClaw helps:

All your handwritten notes are automatically OCR'd by Apple Notes. OpenClaw makes them intelligently searchable:

• Natural language queries: "What did I learn about quantum computing last semester?" → finds handwritten physics notes from September
• Concept search: "Show me all notes about marketing strategies" → finds typed and handwritten notes across all folders
• Visual search: "Find the diagram I drew about system architecture" → locates sketch from 3 months ago
• Cross-reference: "Which class notes mention machine learning?" → finds relevant lectures

Advanced capabilities:

• Summarize handwritten lectures: "Summarize my Biology 201 notes from last month"
• Extract formulas: "What math formulas did I write down for the exam?"
• Connect ideas: "This brainstorm sketch relates to what other notes?"
• Study guide generation: "Create a study guide from all my CS notes this semester"

Example:

You: "What notes do I have about user research methods?"OpenClaw:Found 7 notes mentioning user research methods:1. **UX Class - Week 3** (handwritten, Feb 15)   - Discussed: Interviews, surveys, usability testing   - Key quote: "Always test with 5-7 users minimum"   2. **Project Planning Brainstorm** (typed, Mar 2)   - Decided to use interviews + prototype testing   - Linked to: Customer Interview Questions note3. **Book Notes: The Mom Test** (mixed typed/sketches, Jan 20)   - Diagram of good vs bad interview questions   - [Shows thumbnail of hand-drawn diagram]4. **Team Meeting - Research Phase** (handwritten, Mar 15)   - Action: Schedule 10 user interviews   - Budget: $500 for participant incentivesWould you like me to create a summary of your learnings about user research methods across all these notes?

Impact:

• Handwritten notes become as searchable as typed text
• Visual diagrams and sketches retrievable by concept
• Study faster by searching across entire semester of notes
• Never lose that one important diagram you sketched

4. Personal Journal with AI Reflection

Scenario: You maintain a daily journal in Apple Notes - thoughts, gratitude, challenges, wins. Over time, you've accumulated years of entries. You want to reflect on patterns, growth, and recurring themes, but manually re-reading hundreds of entries is overwhelming.

How OpenClaw helps:

Your journal becomes a source of personal insights:

• Pattern recognition: "What themes appear most in my journal over the last year?"
• Mood tracking: "How has my stress level changed over the last 6 months?"
• Growth reflection: "How have I grown since last year's entries?"
• Gratitude highlights: "What am I most grateful for based on my journal?"
• Challenge identification: "What problems keep recurring in my journal?"
• Annual reviews: "Summarize my year based on journal entries"

Example:

You: "What patterns do you see in my journal from the last 3 months?"OpenClaw:Analyzed 87 journal entries (Jan 10 - Apr 10, 2026):📈 **Positive trends:**- Mentioned "exercise" 34 times (up from 12 times in Q4)- Gratitude for relationships increased (family mentioned 45 times)- More entries about creative projects (18 mentions vs 6 last quarter)⚠️ **Recurring challenges:**- Work stress appears every Sunday evening (12 occurrences)- Sleep quality concerns mentioned 23 times- "Overwhelmed" appears 15 times, usually mid-week💡 **Insights:**- Your best days include: morning walks, creative work, time with friends- Tuesday afternoons seem most productive (noted 8 times)- You're more reflective on weekends (60% of introspective entries)🎯 **Suggestions based on patterns:**1. Consider addressing Sunday evening work anxiety (recurring theme)2. Your morning routine correlates with better days (17/19 great days started with morning routine)3. You've mentioned wanting to "read more" 8 times but only completed 3 books - want to set a goal?Would you like me to:- Generate a detailed Q1 reflection?- Identify your most grateful moments?- Track specific themes going forward?

Impact:

• Self-awareness from data you already captured
• Patterns visible that you couldn't see manually
• Motivation from seeing growth over time
• Actionable insights from reflection
• Privacy maintained (journal stays in locked notes if preferred)

5. Research Note Organization and Synthesis

Scenario: You're researching a complex topic - reading articles, saving quotes, capturing ideas from podcasts, clipping web pages. You have 40+ notes scattered across folders, filled with information. Now you need to synthesize this research into a coherent understanding or write a paper/article.

How OpenClaw helps:

Research notes become a connected knowledge base:

• Synthesize findings: "Summarize what I've learned about climate change solutions"
• Find connections: "How do these 15 articles on AI ethics relate to each other?"
• Quote extraction: "Pull all relevant quotes about renewable energy"
• Gap identification: "What aspects of this topic haven't I researched yet?"
• Outline generation: "Create an outline for an article based on my research notes"
• Source tracking: "Which sources did I learn X from?"

Example:

You: "Help me synthesize my research on personal productivity systems"OpenClaw:Analyzed 23 notes tagged #productivity-research:📚 **Main themes (from your notes):**1. **Capture systems** (8 notes)   - Getting Things Done (GTD) methodology   - Building a Second Brain (BASB)   - Zettelkasten note-taking   - Common principle: "Capture everything, decide later"2. **Focus techniques** (6 notes)   - Pomodoro Technique   - Deep Work principles   - Time blocking   - Key insight: "Uninterrupted blocks > fragmented hours"3. **Review systems** (5 notes)   - Weekly reviews (GTD)   - Daily shutdown routines   - Monthly reflection   - Your note: "Review is where the magic happens"4. **Digital tools** (4 notes)   - Note apps comparison   - Task managers   - Calendar strategies   - Your observation: "Tool doesn't matter as much as system"💡 **Synthesis:**Your research points to a 3-phase system:1. Capture (inbox, quick notes, minimal friction)2. Process (daily review, organize, prioritize)3. Execute (time blocking, deep work, pomodoro)🎯 **Suggested outline for article:**I. Introduction: The productivity paradox (from your note on Apr 3)II. Phase 1: Frictionless Capture    - Why capture matters (quote from "Building a Second Brain")    - Your inbox workflowIII. Phase 2: Intelligent Processing      - Weekly review template (from GTD notes)    - Your adaptation with AI assistanceIV. Phase 3: Focused Execution    - Deep work + Pomodoro (synthesis of your 2 favorite techniques)    - Your personal resultsV. Conclusion: System > Tools📝 **Quotes ready to use:**- "Your mind is for having ideas, not holding them" (GTD note, Feb 12)- "The palest ink is better than the best memory" (Zettelkasten note, Mar 3)- [12 more quotes organized by section]❓ **Research gaps:**- You haven't explored email management systems much- Limited notes on handling interruptions- Could benefit from case studies/examplesWould you like me to generate a first draft based on this outline?

Impact:

• Research synthesis in minutes vs hours
• Connections found that you missed
• Outline generated from your actual notes
• Quotes organized and attributed
• Research gaps identified before writing

6. Shared Family Notes (Shopping, Planning, Coordination)

Scenario: Your family shares notes for shopping lists, vacation planning, home projects, and daily coordination. Multiple people add items, update status, and check things off. But lists get messy, outdated items accumulate, and it's hard to see what's actually important.

How OpenClaw helps:

Family shared notes become intelligent, organized, and actionable:

Shopping list optimization:

• "Organize grocery list by store layout" → AI reorders items by aisle
• "What do we need for this week's meals?" → Cross-references meal plan note
• "Remove items we already bought" → Flags duplicates and completed items
• "Suggest items we usually buy but forgot" → Checks purchase history patterns

Vacation planning:

• "What's not done on our Hawaii trip checklist?" → Shows incomplete items with deadlines
• "Summarize our vacation plans for the family" → Creates day-by-day itinerary
• "Budget check for the trip" → Sums expenses from notes
• "What did we pack last time we traveled?" → References previous trip notes

Home project coordination:

• "Who's responsible for what in the kitchen remodel?" → Extracts assignments
• "What's the status of the basement project?" → Timeline summary from notes
• "Find the measurements I wrote down for the new couch" → Searches across notes

Example:

You: "@OpenClaw optimize our grocery list for Whole Foods"OpenClaw:Reorganized your shared "Groceries - Apr 10" note by store layout:🥬 **Produce (entrance, right side):**- Spinach (organic)- Tomatoes- Avocados (x3)- Bananas- Apples (Honeycrisp)🥛 **Dairy (back left):**- Milk (oat milk - Sarah's preference)- Greek yogurt- Cheddar cheese🥩 **Meat/Seafood (back right):**- Chicken breast (2 lbs)- Salmon (wild caught)🥫 **Packaged goods (center aisles):**- Pasta (whole wheat)- Pasta sauce- Olive oil- Coffee (dark roast)❄️ **Frozen (far back):**- Frozen berries- Ice cream (vanilla)💡 **Suggestions:**- You usually buy eggs but they're not on this list - forgot?- Bread is missing (bought weekly for past 6 weeks)- Garlic (used in 3 recipes in your meal plan note)⚠️ **Removed duplicates:**- "Milk" was listed twice- "Tomatoes" appeared in 2 different sections**Estimated total:** $87 (based on usual prices)**Missing from last week's list:** Eggs, bread, garlic, onionsShall I add the suggested items?

Impact:

• Shopping trips 30% faster with organized lists
• Never forget regular items
• No more buying duplicates
• Budget awareness before shopping
• Vacation planning becomes collaborative and complete

7. Student Lecture Notes Enhancement

Scenario: You're a student taking notes in 5 classes. You type some notes on Mac, handwrite others on iPad, record audio summaries, and scan professor handouts. Midterms approach and you need to study efficiently across hundreds of pages of notes.

How OpenClaw helps:

Transform scattered notes into study materials:

Study guide generation:

• "Create a study guide for Biology 201 midterm" → AI synthesizes all lecture notes
• "What are the key concepts from Chapter 3?" → Pulls from class notes + textbook notes
• "Make flashcards from my Chemistry notes" → Generates Q&A pairs
• "What topics did the professor emphasize?" → Flags repeated concepts

Cross-class connections:

• "How does this History topic relate to my Political Science class?" → Finds connections
• "What math concepts apply to my Physics homework?" → Links relevant notes

Lecture review:

• "Summarize last week's Economics lectures" → Condenses 5 hours of notes to key points
• "What questions should I ask in office hours?" → Identifies gaps in understanding

Exam prep:

• "Practice questions based on my notes" → Generates sample exam questions
• "What haven't I reviewed yet?" → Tracks coverage
• "Weak areas in my understanding?" → Identifies concepts with fewer notes/examples

Example:

You: "Help me study for my Computer Science midterm on algorithms"OpenClaw:Analyzed 14 lecture notes from CS 301 (Jan 15 - Apr 8):📚 **Topic coverage:****1. Sorting Algorithms (4 lectures)**- Bubble Sort, Merge Sort, Quick Sort- Big O notation for each- Your handwritten note (Feb 3): "Quick Sort average O(n log n), worst O(n²)"- Practice problems: 8 solved, 3 marked "review later"**2. Search Algorithms (3 lectures)**  - Binary search, DFS, BFS- Graph traversal (professor emphasized this - mentioned 5 times)- Your note: "BFS uses queue, DFS uses stack - don't mix up!"**3. Dynamic Programming (3 lectures)**- Memoization vs tabulation- Fibonacci, knapsack problem- ⚠️ Your note (Mar 20): "Still confused about optimal substructure"**4. Greedy Algorithms (2 lectures)**- Dijkstra's algorithm- Minimum spanning trees- Less detailed notes here - possible weak spot?**5. Complexity Analysis (2 lectures)**- Big O, Theta, Omega notation- Space vs time tradeoffs- Your summary: "Optimize for time first, then space"🎯 **Study recommendations:****High priority (likely on exam):**1. Graph traversal (BFS/DFS) - professor emphasized heavily2. Quick Sort implementation - 3 practice problems assigned3. Dynamic programming concepts - 30% of recent homework**Review needed:**1. Dynamic programming (you flagged confusion)2. Greedy algorithms (fewer notes, less practice)3. Complexity proof techniques (only 1 example in notes)**Practice problems to redo:**- Knapsack problem (marked "struggled with this")- Dijkstra implementation (incomplete in notes)- Binary tree traversal (no code example)📝 **Generated study guide:**[Comprehensive 8-page guide with:- Concept summaries from all lectures- Code examples from your notes- Practice problems (20 questions)- Solution walkthroughs for tough problems]⏰ **Study plan for next 3 days:**Day 1: Sorting + Search algorithms (strong areas, quick review)Day 2: Dynamic Programming (needs deep focus, your weak spot)Day 3: Greedy algorithms + practice exam questionsWant me to create flashcards or practice problems for any specific topic?

Impact:

• Study time cut 40% with focused review
• Weak areas identified before exam
• Cross-lecture connections found
• Handwritten notes and typed notes synthesized together
• Practice problems generated from your actual notes

8. Daily Review and Note Cleanup

Scenario: You're diligent about capturing information but your Apple Notes library is becoming chaotic - 847 notes across 23 folders, duplicates, outdated info, orphaned notes in wrong folders. You know you should organize but it's overwhelming.

How OpenClaw helps:

Automated maintenance keeps your notes library clean:

Daily cleanup prompts:

• "Review notes created today" → Quick check before end of day
• "Find duplicates" → Flags notes with similar content
• "Orphaned notes without tags or folders?" → Shows unorganized items
• "Outdated notes to archive?" → Finds old notes that might not be relevant

Weekly maintenance:

• "Notes I haven't opened in 6 months" → Candidates for archiving
• "Inbox processing" → Clear capture inbox
• "Tag suggestions" → Recommends tags for untagged notes
• "Folder reorganization ideas" → Suggests better structure

Monthly review:

• "Most useful notes this month" → Surfaces your top references
• "Least accessed folders" → Potential for consolidation
• "Note quality check" → Flags notes that are just links or too brief
• "Connection opportunities" → Notes that should be linked

Example:

You: "@OpenClaw run my weekly note maintenance"OpenClaw:📊 **Weekly Maintenance Report (Apr 3-10, 2026)****Activity summary:**- Created: 18 new notes- Modified: 34 notes- Deleted: 2 notes- Most active folder: Work Projects (12 edits)🔍 **Issues found:****1. Duplicates (3 sets):**- "Meeting with Sarah" (Apr 8) + "Sarah 1:1 Notes" (Apr 8)  → Same content, merge them?- "Q2 Goals" (Jan 15) + "2026 Q2 Planning" (Mar 30)  → 85% overlap, consolidate?  **2. Inbox overflow (12 items):**Your inbox note has 12 unprocessed items from this week:- 5 are tasks → Should move to Reminders- 4 are article links → Tag #read-later?- 3 are ideas → Create project notes?**3. Untagged notes (7):**Recent notes without tags (harder to find later):- "Random thoughts Apr 9" → Suggest tags: #ideas, #personal- "API documentation notes" → Suggest tags: #dev, #reference- "Book recommendations" → Suggest tags: #reading, #wishlist**4. Orphaned notes (4):**Notes in wrong folders:- "Grocery list" in Work folder → Move to Personal?- "Client X contract" in Personal → Move to Work/Clients?**5. Outdated content (2):**- "2025 Goals" (still pinned) → Archive or update for 2026?- "Apartment hunting notes" (you moved 8 months ago) → Archive?**6. Quality issues (3):**- "TODO" (empty note, created Mar 15)- "https://article-link.com" (just a URL, no context)- "!!" (one exclamation mark, created Apr 2 at 2am)✅ **Suggested actions:**1. Merge 3 duplicate note sets2. Process inbox (create tasks, tag articles, expand ideas)3. Add tags to 7 untagged notes4. Move 4 notes to correct folders5. Archive 2 outdated notes6. Delete or expand 3 low-quality notesShall I make these changes? (I'll ask before deleting anything)📈 **Insights:**- You create most notes on Monday mornings (planning mode)- Your most referenced note: "Project Ideas Master List" (opened 14 times)- Folders you never use: "Recipes" (0 opens in 3 months)- You're good at tagging work notes, but personal notes often untagged🎯 **Recommendation:**Set up a daily 5-minute review:- Process inbox every evening- Tag new notes before bed- This would prevent weekly backlogWant me to create a daily reminder?

Impact:

• Note library stays organized with minimal effort
• Find information faster (proper tags and folders)
• Reduce cognitive load (no duplicate/outdated info)
• Better capture habits (inbox actually gets processed)
• Insights into your note-taking patterns

Features Deep Dive

Native Notes.app Access

Direct integration with Apple's Notes app:

• Reads all notes, folders, and attachments
• Supports both iCloud and "On My Mac" notes
• Works with typed, handwritten, and scanned content
• Processes locked notes (with your permission)
• Accesses shared notes and collaboration data
• Respects folder hierarchy and organization

Handwriting Recognition (OCR)

Advanced handwriting understanding:

• Apple Pencil handwritten text fully searchable
• Mixed handwriting + typed content in same note
• Sketch and diagram recognition
• Multiple handwriting styles supported
• Works with scanned documents and photos
• Cursive and print handwriting both recognized
• Multi-language handwriting support (50+ languages)

Document Scanning Integration

Intelligent processing of scanned content:

• Business card scanning and contact extraction
• Receipt OCR with amount and date extraction
• Whiteboard photo enhancement and text extraction
• PDF document analysis and summarization
• Multi-page document processing
• Signature and form field recognition

Quick Note and Inbox Processing

Streamlined capture and organization:

• Instant capture from lock screen, Control Center, Siri
• Daily inbox review and processing
• Automatic categorization and filing suggestions
• Task extraction from captured notes
• Link preview and metadata extraction
• Voice memo transcription and processing

Smart Search and Retrieval

Intelligent search beyond keyword matching:

• Natural language queries ("What did I learn about X?")
• Semantic search (finds related concepts, not just exact words)
• Cross-note connections and relationships
• Search across typed, handwritten, and scanned content simultaneously
• Temporal search ("notes from last quarter about marketing")
• Fuzzy matching (finds notes even with typos)

Folder and Tag Intelligence

Advanced organization assistance:

• Auto-suggest folders for new notes
• Tag recommendations based on content
• Bulk organization and cleanup
• Duplicate detection and merging
• Folder hierarchy optimization
• Smart folder creation suggestions

Shared Notes Enhancement

Collaboration features for shared notes:

• Multi-user action item extraction with assignments
• Change tracking and summarization
• Participant activity insights
• Merge conflict resolution suggestions
• Shared folder organization
• @mention and notification processing

Attachment Processing

Rich media understanding:

• Image analysis and description
• Photo text extraction (OCR)
• PDF content analysis
• Audio file transcription (voice memos)
• Video thumbnail and metadata extraction
• Web link preview and summarization

Privacy Controls

Granular privacy and access management:

• Opt-in folder access (choose which folders AI can read)
• Exclude locked notes from processing
• "On My Mac" local processing option
• Audit logs of AI access
• Temporary access grants
• Revocable permissions

Cross-Device Sync

Works across all your Apple devices:

• Mac, iPhone, iPad, Apple Watch
• Real-time sync via iCloud
• Offline support with sync when online
• Consistent experience across devices
• Web interface for non-Apple device access

Automated Reviews and Summaries

Scheduled maintenance and insights:

• Daily inbox processing prompts
• Weekly review summaries
• Monthly usage insights
• Duplicate and quality checks
• Outdated content flagging
• Organization health score

Action Item Extraction

Intelligent task detection:

• Extract todos from meeting notes
• Identify deadlines and due dates
• Assign responsibility from collaborative notes
• Export to Reminders or task apps
• Track task completion over time

Content Synthesis

Advanced knowledge work:

• Multi-note summarization
• Research synthesis across notes
• Outline generation from scattered ideas
• Quote extraction and attribution
• Concept mapping and visualization
• Gap analysis in knowledge base

Setup Option 1: HeraClaw Cloud (Recommended)

Time required: 60 seconds Technical skill: None macOS required: No (we provide Mac infrastructure) Cost: Included in HeraClaw Cloud subscription Best for: 95% of users, especially Windows/Linux users

Why HeraClaw Cloud?

• No Mac required - We provide macOS infrastructure in the cloud
• Works from Windows, Linux, or Mac
• No AppleScript configuration
• No system permission battles
• No macOS version compatibility issues
• No iCloud sync conflicts
• Professional support included
• Automatic updates and security patches
• 99.9% uptime SLA
• Enterprise-grade security

Special advantage: Mac infrastructure included

Apple Notes integration requires macOS (Notes.app doesn't exist on Windows/Linux). HeraClaw Cloud provides:

• Dedicated macOS environment for your account
• Your iCloud account connected securely
• Notes synced and processed in our Mac infrastructure
• Access from ANY device (Windows PC, Linux workstation, Mac)

You get Apple Notes AI capabilities without owning a Mac.

Steps:

1. Sign up for HeraClaw Cloud

• Visit cloud.getopenclaw.ai
• Click "Sign In" (no credit card required)
• Create your account (takes 60 seconds)

2. Navigate to Integrations

• Click "Integrations" in the left sidebar
• Find "Apple Notes" in the list
• Click "Connect to iCloud"

3. Authorize iCloud Access

• Enter your iCloud credentials (secure, encrypted)
• Choose read-only or read-write access
• Select which folders to make accessible
• Grant permissions

4. Initial Sync

• HeraClaw Cloud syncs your notes (takes 1-5 minutes depending on library size)
• Progress bar shows sync status
• You'll get notification when complete

5. Choose Processing Options

• Select which folders AI can access
• Exclude locked notes (optional)
• Enable handwriting OCR (recommended)
• Set up daily review schedule (optional)

6. Test It

• Ask: "How many notes do I have?"
• Try: "What did I write about yesterday?"
• Test search: "Find notes about project planning"

That's it! Your Apple Notes are now AI-powered.

What You Get with HeraClaw Cloud:

✅ Mac Infrastructure Included - No need to own a Mac ✅ Instant Setup - No technical configuration ✅ Automatic Sync - Notes sync continuously via iCloud ✅ Professional Support - Email, chat, and phone support ✅ 99.9% Uptime - SLA-backed reliability ✅ Enterprise Security - SOC 2, GDPR, HIPAA available ✅ Handwriting OCR - Apple Pencil notes fully searchable ✅ No Maintenance - We manage macOS updates, permissions ✅ Cross-Platform Access - Use from any device

Security & Privacy:

• iCloud credentials encrypted at rest (AES-256)
• TLS 1.3 for all data in transit
• Your notes never shared with third parties
• SOC 2 Type II certified infrastructure
• GDPR compliant
• Optional: Exclude sensitive folders from AI processing
• Audit logs of all AI access

Pricing: See cloud.getopenclaw.ai/pricing (starts with affordable personal plans)

Get Started: Start with HeraClaw Cloud →

Setup Option 2: Self-Hosted (Advanced)

Time required: 30-45 minutes (first time) Technical skill: Intermediate to Advanced macOS required: YES - Must have Mac computer (cannot self-host on Windows/Linux) Cost: Mac hardware ($1000+) + your time Best for: Mac users with technical skills and privacy requirements

IMPORTANT: macOS is absolutely required for self-hosting

Apple Notes integration ONLY works on macOS because:

• Notes.app only exists on Mac (not Windows/Linux)
• AppleScript automation requires macOS
• iCloud Notes sync requires Apple ecosystem
• System permissions require macOS security framework

If you don't have a Mac, use HeraClaw Cloud (we provide Mac infrastructure).

Who should self-host?

✅ Mac users with technical expertise ✅ Organizations with strict data residency requirements ✅ Users who cannot use cloud services for compliance ✅ Technical enthusiasts comfortable with macOS automation ✅ Teams already managing Mac servers/infrastructure

Who should NOT self-host?

❌ Windows or Linux users (macOS required - use HeraClaw Cloud instead) ❌ Non-technical users uncomfortable with Terminal/AppleScript ❌ Anyone who values time over cost savings ❌ Users without Mac hardware

Prerequisites:

• macOS computer (MacBook, Mac Mini, iMac, or Mac Studio)
• macOS Ventura (13.0) or later
• OpenClaw installed and running on the Mac
• Terminal access and basic command-line knowledge
• iCloud account with Apple Notes enabled
• Administrator access to grant system permissions
• Understanding of macOS security permissions

Detailed Self-Hosted Setup

Step 1: Verify macOS Version and Notes.app

1. Check macOS version:

sw_vers# Should show macOS 13.0 or higher

1. Verify Notes.app is installed:

open -a Notes# Notes app should launch

1. Verify iCloud Notes is enabled:

• Open Notes.app
• Check that you see "iCloud" in the sidebar
• If not: System Settings → [Your Name] → iCloud → Enable Notes

1. Check you have notes to work with:

• Count your notes in Notes.app
• Note which folders you want to make accessible

Step 2: Install OpenClaw (if not already installed)

# Install via Homebrew (recommended)brew install openclaw# Or download from GitHubcurl -L https://github.com/openclaw/openclaw/releases/latest/download/openclaw-macos.tar.gz | tar xzsudo mv openclaw /usr/local/bin/# Verify installationopenclaw --version

Step 3: Grant System Permissions

Apple Notes integration requires several macOS permissions:

1. Automation permission (for AppleScript):

   • Run the OpenClaw Apple Notes integration for first time
   • macOS will prompt: "OpenClaw would like to control Notes.app"
   • Click "OK" to grant permission

2. Full Disk Access (for reading Notes database):

   • System Settings → Privacy & Security → Full Disk Access
   • Click the lock icon, enter password
   • Click "+" button
   • Navigate to /usr/local/bin/openclaw (or wherever installed)
   • Add OpenClaw to the list
   • Toggle ON

3. Restart OpenClaw after granting permissions:

openclaw gateway restart

Step 4: Configure OpenClaw for Apple Notes

Edit your OpenClaw config file (~/.openclaw/config.yaml or ~/.config/openclaw/config.yaml):

integrations:  apple_notes:    enabled: true        # Which iCloud account (if you have multiple)    icloud_account: "iCloud"  # Usually "iCloud" or "On My Mac"        # Folders to make accessible (leave empty for all)    allowed_folders:      - "Work"      - "Personal"      - "Projects"      # Omit folders you want to exclude        # Exclude locked notes from AI processing?    exclude_locked_notes: true        # Enable handwriting OCR (requires macOS 14+)    handwriting_ocr: true        # Sync interval (how often to check for new notes)    sync_interval: 300  # seconds (5 minutes)        # Read-only mode (AI can read but not modify notes)    read_only: false        # Processing options    process_attachments: true  # Process images, PDFs, etc.    process_scanned_documents: true        # Performance settings    max_note_length: 50000  # chars (skip very long notes)    max_attachments_per_note: 10

Finding folder names:

Open Notes.app and look at the sidebar. Folder names are exactly as they appear:

• "iCloud" → Main iCloud folder
• "On My Mac" → Local-only notes
• "Work", "Personal", etc. → Your custom folders

Step 5: Initial Sync and Test

1. Start OpenClaw with Apple Notes integration:

openclaw gateway start

1. Check logs for successful connection:

openclaw gateway logs --follow

Look for:

✓ Apple Notes integration initialized✓ Connected to iCloud account: iCloud✓ Found 547 notes across 12 folders✓ Syncing notes... (this may take a few minutes)✓ Initial sync complete: 547 notes indexed✓ Handwriting OCR enabled✓ Ready to process queries

1. Test the integration:

openclaw query "How many notes do I have?"# Should respond with your note countopenclaw query "What notes did I create today?"# Should list today's notesopenclaw query "Find notes about project planning"# Should search across all accessible notes

Step 6: Advanced Configuration

Exclude specific notes or folders:

integrations:  apple_notes:    # Exclude entire folders    excluded_folders:      - "Private"      - "Journal"      - "Confidential"        # Exclude notes with specific tags    excluded_tags:      - "#private"      - "#sensitive"

Performance tuning for large libraries:

If you have 5000+ notes:

integrations:  apple_notes:    # Index in batches to avoid memory issues    batch_size: 100        # Only index notes modified in last N days    index_recent_only: 90  # days        # Skip very old notes    skip_notes_older_than: 365  # days        # Incremental sync (only changed notes)    incremental_sync: true

Handwriting and OCR settings:

integrations:  apple_notes:    handwriting_ocr: true        # OCR confidence threshold (0-100)    ocr_confidence_threshold: 70        # Languages to recognize    ocr_languages:      - "en-US"      - "es-ES"      - "fr-FR"

Attachment processing:

integrations:  apple_notes:    process_attachments: true        # Which attachment types to process    attachment_types:      - "image"  # Photos, screenshots      - "pdf"    # PDF documents      - "audio"  # Voice memos (transcription)      - "video"  # Video files (thumbnail extraction)        # Max attachment size (MB)    max_attachment_size: 50

Step 7: Automation and Scheduled Tasks

Set up automated note processing:

automation:  apple_notes:    # Daily inbox processing    - schedule: "0 20 * * *"  # 8 PM daily      action: "process_inbox"      params:        inbox_note: "Inbox"        notify: true        # Weekly review    - schedule: "0 18 * * 5"  # Friday 6 PM      action: "weekly_review"      params:        generate_summary: true        check_duplicates: true        suggest_tags: true        # Daily duplicate detection    - schedule: "0 9 * * *"  # 9 AM daily      action: "find_duplicates"      params:        similarity_threshold: 0.85        notify_if_found: true

Step 8: Run OpenClaw as a Service

To keep OpenClaw running in background:

Option 1: macOS LaunchAgent (recommended)

Create ~/Library/LaunchAgents/com.openclaw.gateway.plist:

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>Label</key>    <string>com.openclaw.gateway</string>    <key>ProgramArguments</key>    <array>        <string>/usr/local/bin/openclaw</string>        <string>gateway</string>        <string>start</string>    </array>    <key>RunAtLoad</key>    <true/>    <key>KeepAlive</key>    <true/>    <key>StandardOutPath</key>    <string>/tmp/openclaw.log</string>    <key>StandardErrorPath</key>    <string>/tmp/openclaw-error.log</string></dict></plist>

Load the service:

launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plistlaunchctl start com.openclaw.gateway# Check statuslaunchctl list | grep openclaw

Option 2: Simple background process

# Run in backgroundnohup openclaw gateway start > ~/openclaw.log 2>&1 &# Check it's runningps aux | grep openclaw

Troubleshooting Self-Hosted Setup

"Permission Denied" or "Can't Access Notes"

Symptoms: OpenClaw can't read notes, errors about permissions

Potential causes:

1. Missing Full Disk Access permission
2. Missing Automation permission
3. Running OpenClaw with wrong user account

Fix:

1. System Settings → Privacy & Security → Full Disk Access
2. Ensure OpenClaw is in the list and toggled ON
3. System Settings → Privacy & Security → Automation
4. Ensure OpenClaw can control Notes.app
5. Restart OpenClaw: openclaw gateway restart

"Notes.app Not Responding"

Symptoms: Integration hangs, Notes.app becomes unresponsive

Potential causes:

1. Too many notes being processed at once
2. Very large attachments
3. Notes.app already doing iCloud sync

Fix:

# Reduce batch sizeintegrations:  apple_notes:    batch_size: 50  # Lower from default 100    max_attachment_size: 20  # Lower from default 50

Also try:

# Quit Notes.app before OpenClaw synckillall Notes# Restart OpenClawopenclaw gateway restart

"Handwriting Not Recognized"

Symptoms: Handwritten notes not showing up in search results

Potential causes:

1. macOS version too old (need 14.0+ for best OCR)
2. Handwriting OCR disabled
3. OCR confidence threshold too high

Fix:

# Check macOS versionsw_vers# Need macOS 14.0 (Sonoma) or later for advanced OCR# Enable handwriting OCR in configintegrations:  apple_notes:    handwriting_ocr: true    ocr_confidence_threshold: 60  # Lower threshold

"Sync Very Slow" (Large Note Libraries)

Symptoms: Initial sync takes hours for 5000+ notes

Potential causes:

1. Processing all notes including very old ones
2. Large attachments being processed
3. Network slow (downloading iCloud notes)

Fix:

integrations:  apple_notes:    # Only sync recent notes initially    index_recent_only: 30  # days        # Skip large attachments    max_attachment_size: 10  # MB        # Smaller batches    batch_size: 25        # Skip very long notes    max_note_length: 20000  # chars

After initial sync, gradually increase index_recent_only or remove the limit.

"Locked Notes Not Working"

Symptoms: Can't access password-protected notes

Potential causes:

1. OpenClaw doesn't have password (by design - security)
2. Locked notes excluded in config

Fix: Locked notes require manual unlocking:

1. Open Notes.app
2. Unlock the note with Face ID/Touch ID/password
3. Leave note unlocked
4. OpenClaw can now access it (while unlocked)

Or exclude locked notes entirely (recommended):

integrations:  apple_notes:    exclude_locked_notes: true  # Skip password-protected notes

"Duplicate Notes Created"

Symptoms: OpenClaw created duplicate notes instead of modifying existing

Potential causes:

1. Read-only mode disabled
2. Sync conflict during edit
3. Multiple devices syncing simultaneously

Fix:

integrations:  apple_notes:    read_only: true  # Prevent accidental modifications

If you want AI to modify notes:

integrations:  apple_notes:    read_only: false    # Wait for iCloud sync before modifying    wait_for_sync: true    sync_timeout: 30  # seconds

"Shared Notes Not Syncing"

Symptoms: Shared collaborative notes don't appear

Potential causes:

1. Shared notes in different iCloud account
2. Shared folder excluded in config
3. Network issue with iCloud

Fix:

1. Check which iCloud account has the shared notes (Notes.app sidebar)
2. Ensure config includes that account:

integrations:  apple_notes:    # If you have multiple iCloud accounts    icloud_accounts:      - "iCloud"  # Primary account      - "iCloud (Work)"  # Shared account

1. Check allowed_folders includes shared folders

"High CPU Usage"

Symptoms: OpenClaw or Notes.app using lots of CPU

Potential causes:

1. Continuous OCR processing
2. Large attachment processing
3. Too frequent sync interval

Fix:

integrations:  apple_notes:    # Reduce sync frequency    sync_interval: 600  # 10 minutes instead of 5        # Process OCR in batches, not continuously    ocr_batch_processing: true    ocr_schedule: "0 */6 * * *"  # Every 6 hours        # Skip large attachments    max_attachment_size: 5  # MB

Security Best Practices for Self-Hosted

1. Protect Sensitive Notes

integrations:  apple_notes:    # Exclude sensitive folders    excluded_folders:      - "Private"      - "Passwords"  # Don't store passwords in Notes!      - "Medical"      - "Financial"        # Exclude locked notes    exclude_locked_notes: true        # Exclude by tag    excluded_tags:      - "#confidential"      - "#private"

2. Use Read-Only Mode

If you only need AI to read (not modify) notes:

integrations:  apple_notes:    read_only: true  # AI can search/analyze but not edit

3. Enable Audit Logging

Track what AI accessed:

logging:  audit:    enabled: true    log_file: "~/.openclaw/audit.log"    include_queries: true  # Log what was searched    include_accessed_notes: true  # Log which notes were read    include_timestamps: true

4. Local-Only Notes for Sensitive Data

Use "On My Mac" folder for data that shouldn't sync to iCloud:

1. In Notes.app: File → New Note in "On My Mac"
2. These notes never leave your Mac (not in iCloud)
3. OpenClaw can access them locally

integrations:  apple_notes:    icloud_accounts:      - "On My Mac"  # Local only    # Don't include "iCloud" if you want local-only

5. Backup Your Notes

Before enabling AI modifications:

# Export all notes to backupopenclaw apple-notes export --output ~/notes-backup-2026-04-10# Or use macOS Time Machine# System Settings → General → Time Machine → Enable

6. Regular Permission Audits

Quarterly, review what OpenClaw can access:

openclaw apple-notes audit# Shows:# - Which folders are accessible# - How many notes indexed# - Which notes were accessed in last 30 days# - Any excluded folders

Comparison: HeraClaw Cloud vs Self-Hosted

Why 95% of users choose HeraClaw Cloud:

✅ No Mac needed - Windows and Linux users can use Apple Notes AI ✅ Zero setup friction - No permissions, no AppleScript, no debugging ✅ macOS updates don't break it - We handle compatibility ✅ Access from anywhere - Web interface, mobile apps, any device ✅ Professional support - When things break, we fix them ✅ Time savings - 30-45 min setup + ongoing maintenance adds up ✅ Better OCR - We use latest macOS with optimized settings

When self-hosting makes sense:

✅ You own a Mac and are technically proficient ✅ Data cannot leave your device (regulatory/compliance) ✅ You want complete control over processing ✅ You have time to maintain and troubleshoot ✅ You're comfortable with AppleScript and macOS permissions ✅ Budget constraints (one-time Mac cost vs subscription)

Special note for Windows/Linux users:

If you don't have a Mac, self-hosting is impossible. Apple Notes integration requires macOS. Your only options:

1. HeraClaw Cloud (we provide Mac infrastructure)
2. Buy a Mac specifically for this (expensive)
3. Rent a Mac cloud service + self-host (complex and expensive)

HeraClaw Cloud is the only practical solution for non-Mac users.

Frequently Asked Questions

Q: Can I use this on Windows or Linux?

A: Self-hosted: No. Apple Notes only exists on macOS. You need a Mac to self-host.

HeraClaw Cloud: Yes! We provide Mac infrastructure in the cloud, so you can use Apple Notes AI from Windows, Linux, or any device. This is the primary advantage of HeraClaw Cloud for non-Mac users.

Q: What about locked/password-protected notes?

A: Locked notes use end-to-end encryption. Options:

1. Exclude them (recommended): AI won't access locked notes at all
2. Unlock manually: Unlock in Notes.app, then AI can access while unlocked
3. Remove lock: Remove password protection (not recommended for sensitive data)

Best practice: Keep sensitive notes locked and excluded from AI processing.

Q: Can it read handwritten notes?

A: Yes! Apple Notes automatically OCRs handwriting from Apple Pencil. OpenClaw can:

• Search handwritten text like typed text
• Extract action items from handwritten meeting notes
• Summarize handwritten lecture notes
• Process mixed typed + handwritten notes

Requires macOS 14+ for best OCR accuracy. HeraClaw Cloud always uses latest macOS.

Q: What about scanned documents?

A: Yes! Scanned documents (via Notes.app camera scanner) are OCR'd automatically. OpenClaw can:

• Extract text from scanned receipts, business cards, contracts
• Analyze whiteboard photos
• Process multi-page PDF scans
• Search across scanned document content

Q: Does it work with iCloud shared notes?

A: Yes! Shared notes and collaborative folders are supported. You can:

• Extract action items assigned to participants
• Summarize changes made by collaborators
• Track who added what
• Organize shared family notes (shopping lists, vacation planning)

Q: Can I exclude certain folders?

A: Absolutely. You control which folders AI can access:

• Cloud: Choose folders during setup
• Self-hosted: Configure allowed_folders or excluded_folders in config

Common exclusions: Private, Journal, Medical, Financial folders.

Q: How does sync work?

A: Notes sync via iCloud:

• Cloud: We connect to your iCloud account, continuous sync
• Self-hosted: Notes.app syncs via iCloud, OpenClaw reads local database

Changes appear within minutes across all devices.

Q: Can AI modify my notes?

A: Configurable:

• Read-only mode (default): AI can search and analyze, but not edit
• Read-write mode: AI can add tags, create notes, organize

For safety, start with read-only mode. Enable editing only if needed.

Q: What about "On My Mac" local notes?

A: Supported:

• Cloud: We can access local notes via your iCloud account
• Self-hosted: Full access to "On My Mac" notes

Local notes never leave your Mac, but AI can still process them.

Q: Is my data secure?

A: HeraClaw Cloud:

• SOC 2 Type II certified
• Encryption in transit (TLS 1.3) and at rest (AES-256)
• GDPR compliant
• iCloud credentials encrypted
• Optional: Exclude sensitive folders

Self-hosted:

• Your responsibility, but data never leaves your Mac
• Use "On My Mac" for notes that shouldn't sync to cloud
• Enable audit logging to track access

Q: How many notes can it handle?

A: HeraClaw Cloud: Unlimited. We've tested with users who have 10,000+ notes.

Self-hosted: Depends on Mac hardware:

• Under 1,000 notes: Any Mac works fine
• 1,000-5,000 notes: Mac with 8GB+ RAM recommended
• 5,000+ notes: 16GB+ RAM, use performance tuning settings

Q: Can it process attachments (images, PDFs, audio)?

A: Yes:

• Images: OCR text, describe content, analyze screenshots
• PDFs: Extract text, summarize documents
• Audio (voice memos): Transcribe to text
• Videos: Extract thumbnails, metadata

Q: What if I have multiple iCloud accounts?

A: Supported:

• Cloud: Connect multiple accounts, we sync all
• Self-hosted: Configure multiple accounts in config

Example: Personal iCloud + Work iCloud accounts both accessible.

Q: Can I export my notes?

A: Yes:

openclaw apple-notes export --format markdown --output ~/notes-backup# Exports all accessible notes to Markdown files

Formats: Markdown, JSON, plain text, HTML.

Q: Does it work on iPad or iPhone?

A: The processing happens on Mac (Notes.app requires macOS), but you can access AI features from any device:

• Cloud: Web interface, mobile apps work on any device
• Self-hosted: Need Mac for processing, but can query via API from iPhone/iPad

Your notes sync via iCloud, so edits on iPhone appear on Mac instantly.

Q: What about privacy - can HeraClaw see my notes?

A: HeraClaw Cloud:

• We process notes to provide AI features
• Notes are encrypted in transit and at rest
• We don't sell data or use it to train models
• SOC 2 audited infrastructure
• You can exclude sensitive folders

Self-hosted:

• Notes never leave your Mac
• Complete privacy (you control infrastructure)
• Ideal for highly sensitive data

Q: Can I migrate from self-hosted to Cloud (or vice versa)?

A: Yes! Your notes are in Apple Notes (iCloud), not tied to processing method:

• Self-hosted → Cloud: Sign up, connect same iCloud account, instant access
• Cloud → Self-hosted: Download OpenClaw, configure, connect same iCloud account

No data migration needed - both access the same Apple Notes library.

Q: How fast is search?

A: Very fast:

• Simple searches: Under 1 second (even across 1000s of notes)
• Semantic searches: 1-3 seconds (AI understanding of meaning)
• Complex queries (summarize, extract, synthesize): 3-10 seconds

Q: Can I schedule automated tasks?

A: Yes:

• Cloud: Set up schedules in dashboard (daily inbox processing, weekly reviews)
• Self-hosted: Configure automation in config (cron-style schedules)

Example: Daily 8 PM inbox processing, Friday evening weekly review.

Q: What if I have a really messy note library?

A: OpenClaw helps clean it up:

• Duplicate detection and merging
• Tag suggestions for untagged notes
• Folder reorganization recommendations
• Outdated content flagging
• Quality checks (empty notes, just links, etc.)

Start with: "Help me organize my notes library" and AI will audit and suggest cleanup.

Q: Does it support multiple languages?

A: Yes:

• Notes in any language are processed
• OCR supports 50+ languages (handwriting recognition)
• Queries can be in any language
• Responses in your query language

Q: Can I use it for team knowledge base?

A: Apple Notes is designed for personal/family use, not team knowledge bases. For teams:

• Use shared notes for small team collaboration (2-5 people)
• For larger teams, consider Notion/Confluence integrations instead
• Or: Export notes to markdown, import to team wiki

Q: What happens if I delete a note?

A: Deleted notes go to "Recently Deleted" folder (30-day retention):

• AI won't access deleted notes (excluded by default)
• After 30 days, Apple permanently deletes
• To recover: Restore from "Recently Deleted" in Notes.app

Q: Can AI create new notes?

A: Yes (if read-write mode enabled):

• "Create a note for project ideas from our brainstorm"
• "Make a shopping list from meal plan notes"
• "Generate study guide note from lecture notes"

New notes appear in Notes.app within seconds via iCloud sync.

Q: How do I remove the integration?

A: Cloud:

1. HeraClaw Dashboard → Integrations → Apple Notes
2. Click "Disconnect"
3. Your notes remain in Apple Notes (unchanged)

Self-hosted:

1. Edit config: apple_notes: enabled: false
2. Restart OpenClaw
3. Optionally: System Settings → Privacy → Remove OpenClaw from Full Disk Access

Get Started

For 95% of users (recommended):

Start with HeraClaw Cloud →

• 60-second setup
• No Mac required (we provide infrastructure)
• Works on Windows, Linux, Mac
• No technical skills needed
• Professional support
• 99.9% uptime SLA
• Try it risk-free (no credit card required)

For Mac users with technical skills:

Self-Hosting Setup Guide →

• 30-45 minute setup
• Requires macOS (Mac computer mandatory)
• Requires DevOps skills
• You maintain infrastructure
• Full control and customization
• Data stays on your Mac

Questions? Email support@cloud.getopenclaw.ai or join our community for help.

Last updated: April 10, 2026

Built with OpenClaw — The open-source AI assistant platform. Self-host or use HeraClaw Cloud.