← All skills
Tencent SkillHub · Communication & Collaboration

Imsg Media

Fetch iMessage/Messages.app attachments (voice memos and images) and process them — transcribe audio via Silicon Flow ASR (SenseVoiceSmall), and analyze imag...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Fetch iMessage/Messages.app attachments (voice memos and images) and process them — transcribe audio via Silicon Flow ASR (SenseVoiceSmall), and analyze imag...

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, scripts/imsg_voice_transcribe.py

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

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.

Upgrade existing

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.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.1

Documentation

ClawHub primary doc Primary doc: SKILL.md 12 sections Open source page

imsg-media

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

macOS permissions

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

API key (audio only)

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

CLI dependency

imsg CLI: npm install -g imsg

Trigger conditions

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

Decision flow

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

Step 1 — Get the sender identifier

Always read from the message envelope: [iMessage sender@example.com ...] → use sender@example.com [SMS +1234567890 ...] → use +1234567890 Never hardcode an address

Step 2 — Fetch the attachment

# 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.

Step 3a — Audio: transcribe

# 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

Step 3b — Image: analyze

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.

Supported formats

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

Troubleshooting

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

Category context

Messaging, meetings, inboxes, CRM, and teammate communication surfaces.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
1 Docs1 Scripts
  • SKILL.md Primary doc
  • scripts/imsg_voice_transcribe.py Scripts