Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Fetch iMessage/Messages.app attachments (voice memos and images) and process them — transcribe audio via Silicon Flow ASR (SenseVoiceSmall), and analyze imag...
Fetch iMessage/Messages.app attachments (voice memos and images) and process them — transcribe audio via Silicon Flow ASR (SenseVoiceSmall), and analyze imag...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Full iMessage multimedia pipeline: 🎙️ Voice memo → text via Silicon Flow ASR (SenseVoiceSmall, cloud, no local model) 🖼️ Image → description/OCR via agent's built-in vision model
Full Disk Access must be granted to the process running OpenClaw Settings → Privacy & Security → Full Disk Access → add your terminal/app Without this, imsg cannot read ~/Library/Messages/chat.db and will return permissionDenied
Silicon Flow API key — sign up free at https://siliconflow.cn Long-term use: add to ~/.openclaw/.env: SILICON_FLOW_KEY=sk-... Quick test / override: pass --api-key sk-... directly to the script Image analysis does not require this key
imsg CLI: npm install -g imsg
Activate this skill when: Incoming message text contains the attachment placeholder  User says "语音转文字", "转写", "识别语音", "transcribe" User says "看图", "识别图片", "读图", "OCR", "截图里写的什么" User references a photo/audio/file they just sent via iMessage
Attachment detected? ├── Audio (.m4a / .caf / .wav / .mp3) → transcribe via Silicon Flow ASR ├── Image (.jpg / .png / .heic / .gif) → read with vision model └── Unknown / not downloaded → increase --limit or ask user to resend
Always read from the message envelope: [iMessage sender@example.com ...] → use sender@example.com [SMS +1234567890 ...] → use +1234567890 Never hardcode an address
# Run from the skill directory cd ~/.openclaw/skills/imsg-voice-transcribe python3 scripts/imsg_voice_transcribe.py fetch \ --identifier "sender@example.com" \ --limit 50 Returns JSON with file, type (audio or image), and metadata. If nothing found, try --limit 100.
# One-liner (fetch + transcribe) python3 scripts/imsg_voice_transcribe.py auto \ --identifier "sender@example.com" \ --limit 50 --raw # Or transcribe a specific file python3 scripts/imsg_voice_transcribe.py transcribe \ --file /path/to/audio.m4a --raw # Quick test with explicit API key (no env setup needed) python3 scripts/imsg_voice_transcribe.py transcribe \ --file /path/to/audio.m4a --api-key sk-... --raw
After fetch returns an image path (e.g. {"file": "/path/to/photo.jpg", "type": "image"}): # Example: fetch image from a sender python3 scripts/imsg_voice_transcribe.py fetch \ --identifier "sender@example.com" --type image --limit 50 # → {"file": "/Users/.../Messages/Attachments/photo.jpg", "type": "image", ...} Then in the agent: If HEIC/HEIF: convert first → sips -s format png "input.heic" --out "output.png" Open with the read tool → agent vision model processes it Respond with: what it is, main subject, any text/OCR, notable details Default image response format: What it is: photo / screenshot / document Main subject: 1–2 sentences Text (OCR): quote key text, or "无明显文字" Details: 3–5 bullets Follow-up: ask if they want OCR / table extraction / comparison / etc.
FormatTypeNotes.m4aAudioStandard iMessage voice memo.cafAudioOlder iOS voice memo (AAC in CAF).wav .mp3AudioOther sources.jpg .jpeg .pngImageStandard photos.heic .heifImageiPhone default — convert to PNG first.gifImageAnimated or static
ErrorCauseFixpermissionDeniedNo Full Disk AccessGrant FDA in System SettingsSILICON_FLOW_KEY not setMissing API keyAdd to ~/.openclaw/.envNo attachments foundLow limit or iCloud not syncedIncrease --limit; ask user to resendRequest timed outNetwork or large fileRetry; check file < 25MBHEIC not displayingFormat not supported by readConvert with sips first
Messaging, meetings, inboxes, CRM, and teammate communication surfaces.
Largest current source with strong distribution and engagement signals.