Memorist Agent
Help your parents and grandparents tell their stories before it's too late.
Memorist Agent conducts adaptive, empathetic interviews across 9 life domains — in English or Chinese. It remembers every name, place, and year the narrator mentions and follows up with targeted questions to draw out richer memories.
Why Memorist Agent?
- Local-first — Every story fragment, entity, and chapter lives on your machine at
~/.openclaw/memorist_agent/. Nothing is uploaded to any server. You own your family's data completely.
- Private by design — No accounts, no cloud sync, no third-party databases. The only network calls are the ones you explicitly trigger (sending a WhatsApp question or sharing an export). Delete the folder and it's gone.
- Easy to use — Run
/memorist_agent setup, answer 4 questions, and you're interviewing. Relay mode works immediately with zero configuration. WhatsApp auto-reply takes one extra command. The AI handles question flow, entity tracking, and story writing — you just talk to your family.
- Bilingual — Native support for English and Chinese (普通话). The agent mirrors the narrator's language naturally, including dialect phrases and colloquial expressions.
- Works with any channel — WhatsApp, Telegram, WeCom, iMessage, or just relay questions in person over tea. The skill adapts to however your family communicates.
Quick Start — Your First Interview
Step 1 — Set up a narrator:
/memorist_agent setup
Step 2 — Pick "Relay" mode (easiest — no extra config needed). You'll get questions to ask your narrator in person, over the phone, or via any messaging app. Type or paste their answers back.
Step 3 — Run the interview:
/memorist_agent interview --narrator "Dad"
That's it. After 3–5 questions, the skill saves a story fragment automatically.
Want hands-free WhatsApp? Pick "WhatsApp auto-reply" during setup instead. The narrator chats directly with their own dedicated agent — no copy-pasting needed. Requires WhatsApp gateway setup (see Prerequisites below).
What You Need
- OpenClaw gateway running:
openclaw status should show gateway running.
- Everything else is set up automatically on first run.
Nice to have (based on your setup):
| Feature |
What to configure |
| WhatsApp auto-reply |
WhatsApp linked (openclaw status), narrator's number in channels.whatsapp.allowFrom or dmPolicy: "open", mkdir -p ~/.openclaw/media |
| Telegram auto-reply |
Telegram bot configured, narrator's numeric user ID in channels.telegram.allowFrom |
| WeCom auto-reply |
@sunnoy/wecom plugin loaded, channels.wecom.enabled: true |
| iMessage auto-reply |
macOS only. channels.imessage.enabled: true, narrator's phone/email in channels.imessage.allowFrom, Full Disk Access granted to terminal. Requires imsg CLI (brew install pj4533/homebrew-imsg/imsg) |
| Voice replies (TTS) |
messages.tts configured in openclaw config — see references/media-and-voice.md |
| Voice note transcription |
pip3 install mlx-whisper (Apple Silicon) or brew install openai-whisper, or run /memorist_agent setup-stt |
File paths use ~/.openclaw/ ($HOME/.openclaw/ on all platforms — macOS, Linux, Windows WSL).
Commands
| Command |
Description |
/memorist_agent setup |
Add a narrator and configure their interview channel |
/memorist_agent interview [--narrator NAME] [--domain DOMAIN] |
Start or continue an interview session |
/memorist_agent spawn [--narrator NAME] |
Enable auto-reply — creates a dedicated agent for this narrator |
/memorist_agent despawn [--narrator NAME] |
Disable auto-reply — remove the dedicated agent |
/memorist_agent remind [--narrator NAME] |
Send a gentle reminder to continue their story |
/memorist_agent stories [--narrator NAME] [--domain DOMAIN] |
Browse collected story fragments |
/memorist_agent entities [--narrator NAME] |
Show the entity map: people, places, years |
/memorist_agent compile [--narrator NAME] |
Compile fragments into polished memoir chapters |
/memorist_agent export [--narrator NAME] [--format md|json|txt] |
Export the memoir to a file |
/memorist_agent share [--narrator NAME] |
Invite a family co-editor to review |
/memorist_agent status |
Show all narrators, progress, and agent status |
/memorist_agent setup-stt |
Auto-install voice transcription |
Life Story Domains
| ID |
Domain (EN) |
Domain (ZH) |
Sample Opening Question |
origins |
Origins & Childhood |
出身与童年 |
"Where were you born, and what's your earliest memory of home?" |
growing-up |
Growing Up |
成长岁月 |
"What was school like for you? Who were your closest friends?" |
family-history |
Family History |
家族历史 |
"Tell me about your parents — what kind of people were they?" |
love |
Love & Partnership |
爱情与伴侣 |
"How did you and Mum/Dad first meet?" |
work |
Work & Career |
工作与事业 |
"What was your first real job? What did you dream of becoming?" |
places |
Places & Journeys |
地方与旅途 |
"What places have you lived in across your life?" |
history |
Historical Moments |
历史时刻 |
"You lived through [decade] — what do you remember most?" |
milestones |
Family Milestones |
家庭里程碑 |
"What family celebrations stand out most in your memory?" |
wisdom |
Values & Wisdom |
价值观与智慧 |
"What's the most important lesson life has taught you?" |
Storage Layout
All data is stored locally at ~/.openclaw/memorist_agent/:
~/.openclaw/memorist_agent/
├── owner.json # Skill owner's name
├── narrators.json # Index of all narrators
├── narrators/
│ └── {narrator-id}/
│ ├── profile.json # Narrator metadata & domain progress
│ ├── entities.json # Extracted people, places, years
│ ├── sessions.json # Interview session log
│ ├── fragments/ # Story fragments by domain
│ ├── chapters/ # Compiled memoir chapters
│ ├── exports/ # Exported memoir files
│ └── workspace/ # Agent workspace (if auto-reply enabled)
/memorist_agent setup
Purpose: Register a narrator and choose how interviews will be conducted.
Steps:
First-run bootstrap: Create the data directory if it doesn't exist:
mkdir -p ~/.openclaw/memorist_agent/narrators
- If
narrators.json doesn't exist, create it as [].
- If this is the first run, ask: "What's your name? (This is how narrators will know who set this up.)" Save to
~/.openclaw/memorist_agent/owner.json as { "name": "{name}" }. Skip if owner.json already exists.
Ask the user:
Let's set up your narrator. I'll ask a few questions.
1. What is their name? (e.g. "Dad", "Grandma Li", "Uncle Chen")
2. What's their relationship to you? (parent / grandparent / relative / friend)
3. What language should I interview them in?
[1] English
[2] Chinese (普通话)
[3] Both (start in Chinese, key summaries in English)
4. How should I conduct interviews?
[1] Relay — I give you questions, you ask them and bring back answers
(Works with any channel: in person, phone call, WeChat, etc.)
[2] WhatsApp auto-reply — they chat directly with a dedicated agent
(Requires WhatsApp gateway. I'll help you set it up.)
[3] iMessage auto-reply — they chat via iMessage with a dedicated agent
(macOS only. Requires iMessage channel configured.)
[4] Telegram auto-reply — they chat via Telegram with a dedicated agent
(Requires Telegram bot configured.)
[5] Live — the narrator is here right now, let's start talking
If "WhatsApp auto-reply" is selected:
a. Ask for their WhatsApp number (with country code, e.g. +1234567890).
b. Validate allowlist: Read the openclaw config and check if the number is in channels.whatsapp.allowFrom or if dmPolicy is "open". If NOT:
⚠️ {number} is not in your WhatsApp allowlist yet.
Their replies will be silently dropped without this.
I can add it for you — shall I update channels.whatsapp.allowFrom?
[Yes, add it] / [No, I'll do it manually]
If user says yes, add the number to channels.whatsapp.allowFrom in the openclaw config file.
c. Verify gateway: Check openclaw status output. If WhatsApp is not linked:
⚠️ WhatsApp gateway is not connected.
Run: openclaw status
If WhatsApp shows "not linked", you'll need to pair it first.
For now, I'll set up the narrator in Relay mode. You can switch to
WhatsApp auto-reply later with /memorist_agent spawn.
Fall back to relay mode if gateway is not ready.
d. Create media directory: mkdir -p ~/.openclaw/media (gateway rejects media from other paths).
If "iMessage auto-reply" is selected:
a. Ask for their phone number or Apple ID email.
b. Check platform: If not macOS, warn: "iMessage is only available on macOS. Switching to Relay mode."
c. Validate allowlist: Check if the number/email is in channels.imessage.allowFrom or if dmPolicy is "open". Offer to add if missing (same flow as WhatsApp step 3b).
d. Verify iMessage: Check openclaw status — iMessage should show OK or configured. If not:
⚠️ iMessage channel is not configured.
Make sure:
1. channels.imessage.enabled: true in your openclaw config
2. imsg CLI is installed: brew install pj4533/homebrew-imsg/imsg
3. Full Disk Access is granted to your terminal app
(System Settings → Privacy & Security → Full Disk Access)
For now, I'll set up in Relay mode. Switch later with /memorist_agent spawn.
e. Create media directory: mkdir -p ~/.openclaw/media.
If "Telegram auto-reply" is selected:
a. Ask for their Telegram user ID (numeric). Explain: "Ask them to message @userinfobot on Telegram to get their numeric ID."
b. Validate allowlist: Check if the ID is in channels.telegram.allowFrom. Offer to add if missing.
c. Verify Telegram: Check openclaw status — Telegram should show OK. Warn and fall back to relay if not configured.
If "Live" is selected: Note that the narrator is present — skip channel setup, start interview immediately after setup completes.
Generate a narrator ID: narrator-{slug(name)}-{timestamp}.
Create ~/.openclaw/memorist_agent/narrators/{id}/ directory structure (including fragments/, chapters/, exports/ subdirs):
profile.json:
{
"id": "{narrator-id}",
"name": "{name}",
"relationship": "{relationship}",
"lang": "{en|zh|both}",
"channel": "{relay|whatsapp|imessage|telegram|live}",
"whatsapp": "{number or null}",
"imessage": "{phone or email or null}",
"telegram": "{numeric user ID or null}",
"replyFormat": "text",
"createdAt": "{ISO timestamp}",
"domains": {
"origins": { "status": "not-started", "fragmentCount": 0 },
"growing-up": { "status": "not-started", "fragmentCount": 0 },
"family-history": { "status": "not-started", "fragmentCount": 0 },
"love": { "status": "not-started", "fragmentCount": 0 },
"work": { "status": "not-started", "fragmentCount": 0 },
"places": { "status": "not-started", "fragmentCount": 0 },
"history": { "status": "not-started", "fragmentCount": 0 },
"milestones": { "status": "not-started", "fragmentCount": 0 },
"wisdom": { "status": "not-started", "fragmentCount": 0 }
}
}
entities.json: { "people": [], "places": [], "years": [], "events": [] }
sessions.json: []
Append narrator to narrators.json.
If channel is "whatsapp", "imessage", or "telegram", immediately recommend auto-reply:
Narrator added: {name}
Language : {lang}
Channel : WhatsApp ({number})
For the best experience, I recommend enabling auto-reply so {name}
can chat directly without you copy-pasting messages.
Enable now? /memorist_agent spawn --narrator "{name}"
[Skip — I'll use relay mode for now]
Otherwise (relay or live):
Narrator added: {name}
Language : {lang}
Channel : {channel}
Domains : 9 life story domains ready
Start the first interview with:
/memorist_agent interview --narrator "{name}"
/memorist_agent interview
Purpose: Conduct one interview session covering one memory domain. Generates 1–3 story fragments and updates the entity map.
Usage:
/memorist_agent interview — auto-selects narrator and next domain
/memorist_agent interview --narrator "Dad" — specific narrator
/memorist_agent interview --narrator "Dad" --domain origins — specific domain
/memorist_agent interview --narrator "Dad" --resume — continue last session
High-level flow:
- Load narrator context (profile, entities, prior fragments)
- Pick next domain (or resume in-progress one)
- Generate opening question adapted to language and prior context
- Send question via configured channel (relay, WhatsApp, or live)
- Run adaptive follow-up loop (3–5 exchanges per session)
- Distill exchanges into a first-person story fragment
- Update entity map and save all data
Error handling:
- If no narrators exist: "No narrators set up yet. Run
/memorist_agent setup first."
- If all 9 domains are complete: "All domains are complete! Run
/memorist_agent compile to create the memoir."
- If WhatsApp gateway is down: Fall back to relay mode and warn the user.
For detailed step-by-step instructions, read: references/interview-workflow.md
Interview principles (read before first session): references/interview-principles.md
/memorist_agent remind
Purpose: Send a gentle, warm reminder to continue sharing stories.
Steps:
- Load narrator profile. Find in-progress or next not-started domain.
- Generate personalized reminder referencing something they already shared.
- Send via WhatsApp if configured, otherwise display for relay.
/memorist_agent stories
Purpose: Browse collected story fragments.
Usage:
/memorist_agent stories — all fragments for default narrator
/memorist_agent stories --narrator "Dad" --domain origins — filtered
Steps:
- Load all fragment files for the narrator.
- Display grouped by domain: title, preview, people/places mentioned, pending follow-ups.
- Show total fragment count and domain coverage.
/memorist_agent entities
Purpose: Show the entity map — all people, places, years, events extracted from stories.
Steps:
- Load
entities.json for the narrator.
- Display grouped by type, with follow-up status (resolved vs pending).
- Show count of unresolved entities that will be followed up automatically.
/memorist_agent compile, export, share
Purpose: Compile fragments into memoir chapters, export to file, share with family.
For detailed instructions, read: references/compile-export-share.md
/memorist_agent spawn, despawn
Purpose: Enable or disable auto-reply for a narrator. "Spawn" creates a dedicated, isolated agent that chats directly with the narrator — no copy-pasting needed. "Despawn" removes it.
After spawning, all messages from the narrator's WhatsApp/Telegram route directly to their personal agent. The main session is never touched.
Error handling:
- If gateway is not running: "Gateway is not running. Start it with
openclaw gateway start, then try again."
- If WhatsApp is not linked: "WhatsApp is not connected. Run
openclaw status to check."
- If narrator's number is not in allowlist: Offer to add it (same as setup step 3b).
- If spawn fails for any reason: Fall back gracefully — "Auto-reply couldn't be enabled. You can still use relay mode with
/memorist_agent interview."
For detailed instructions, read: references/spawn-despawn.md
/memorist_agent status
Purpose: Overview of all narrators and their progress.
Steps:
- Load
narrators.json and each narrator's profile.json.
- Display per narrator: name, relationship, language, channel, agent status, domain progress bar, fragment count, last session date.
- Show available commands.
Memorist Agent — Overview
Narrators: {N}
───────────────────────────────
{name} ({relationship})
Language : {lang}
Channel : {Relay / WhatsApp auto-reply / Live}
Agent : {active/none}
Progress : {bar} {N}/9 domains
Fragments : {count} stories collected
───────────────────────────────
Common Issues
| Problem |
Cause |
Fix |
| Narrator's WhatsApp replies don't arrive |
Number not in allowlist |
Add to channels.whatsapp.allowFrom in openclaw config, or set dmPolicy: "open" |
/memorist_agent spawn fails |
Gateway not running |
openclaw gateway start or openclaw gateway restart |
| Media sends hang (text works) |
Gateway WhatsApp connection crashed |
openclaw gateway restart |
| Voice notes not transcribed |
No STT tool installed |
Run /memorist_agent setup-stt |
| Voice replies don't play properly |
Wrong audio format |
WhatsApp needs OGG/Opus, not MP3. See references/media-and-voice.md |
| TTS produces garbled speech |
Wrong voice language |
Set messages.tts.edge.voice to match narrator's language in openclaw config |
| Interview says "no narrators" |
Haven't run setup yet |
Run /memorist_agent setup first |
| All domains complete |
Interviews finished |
Run /memorist_agent compile to create the memoir |
Privacy Architecture
| Data |
Where it lives |
Who can access |
| Story fragments |
~/.openclaw/memorist_agent/ |
Local machine only |
| Entity map |
~/.openclaw/memorist_agent/ |
Local machine only |
| Interview sessions |
~/.openclaw/memorist_agent/ |
Local machine only |
| Compiled chapters |
~/.openclaw/memorist_agent/ |
Local machine only |
| WhatsApp messages sent |
Narrator's WhatsApp |
Narrator only |
| Exported files |
Path you choose |
You control sharing |
Claude AI processes text during active sessions. If privacy-sensitive, use relay mode — type questions manually and record answers yourself.
Tool Usage Notes
- file_read / file_write: all narrator data at
~/.openclaw/memorist_agent/.
- whatsapp_send_message: used only when narrator channel is
whatsapp.
- fetch: only called if user runs
/memorist_agent share with API option.
- web_search: not used. This skill is intentionally offline-first.
For media format requirements, TTS config, STT setup, and troubleshooting, read: references/media-and-voice.md
1---2name: memorist-agent3description: "Memorist Agent — helps you capture your parents' and family members' life stories through adaptive interviews via WhatsApp, WeChat, or direct conversation. Organizes stories into memoir chapters. Local-first, privacy-protected. Bilingual: English + Chinese (普通话). Commands: /memorist_agent setup, interview, stories, compile, export, share."4version: 0.1.05license: MIT6metadata:7 source: https://skillmd.com/skills/leoyeai-openclaw-master-skills/memorist-agent8 openclaw:9 emoji: "📖"10 os: ["darwin", "linux", "windows"]11 optional:12 anyBins:13 - mlx-whisper-transcribe14 - whisper15 install:16 - id: mlx-whisper17 kind: exec18 command: pip319 args: ["install", "mlx-whisper"]20 label: "Install mlx-whisper (Apple Silicon, recommended)"21 platforms: ["darwin"]22 - id: openai-whisper23 kind: brew24 formula: openai-whisper25 bins: ["whisper"]26 label: "Install OpenAI Whisper via Homebrew (Intel Mac / Linux fallback)"27 platforms: ["darwin", "linux"]28allowed-tools:29 - file_read30 - file_write31 - whatsapp_send_message32 - fetch33 - web_search34---3536# Memorist Agent3738Help your parents and grandparents tell their stories before it's too late.3940Memorist Agent conducts adaptive, empathetic interviews across 9 life domains — in English or Chinese. It remembers every name, place, and year the narrator mentions and follows up with targeted questions to draw out richer memories.4142### Why Memorist Agent?4344- **Local-first** — Every story fragment, entity, and chapter lives on your machine at `~/.openclaw/memorist_agent/`. Nothing is uploaded to any server. You own your family's data completely.45- **Private by design** — No accounts, no cloud sync, no third-party databases. The only network calls are the ones you explicitly trigger (sending a WhatsApp question or sharing an export). Delete the folder and it's gone.46- **Easy to use** — Run `/memorist_agent setup`, answer 4 questions, and you're interviewing. Relay mode works immediately with zero configuration. WhatsApp auto-reply takes one extra command. The AI handles question flow, entity tracking, and story writing — you just talk to your family.47- **Bilingual** — Native support for English and Chinese (普通话). The agent mirrors the narrator's language naturally, including dialect phrases and colloquial expressions.48- **Works with any channel** — WhatsApp, Telegram, WeCom, iMessage, or just relay questions in person over tea. The skill adapts to however your family communicates.4950---5152## Quick Start — Your First Interview5354**Step 1** — Set up a narrator:55```56/memorist_agent setup57```5859**Step 2** — Pick "Relay" mode (easiest — no extra config needed). You'll get questions to ask your narrator in person, over the phone, or via any messaging app. Type or paste their answers back.6061**Step 3** — Run the interview:62```63/memorist_agent interview --narrator "Dad"64```6566That's it. After 3–5 questions, the skill saves a story fragment automatically.6768**Want hands-free WhatsApp?** Pick "WhatsApp auto-reply" during setup instead. The narrator chats directly with their own dedicated agent — no copy-pasting needed. Requires WhatsApp gateway setup (see Prerequisites below).6970---7172## What You Need7374- **OpenClaw gateway running**: `openclaw status` should show gateway `running`.75- Everything else is set up automatically on first run.7677**Nice to have (based on your setup):**7879| Feature | What to configure |80|---------|-------------------|81| WhatsApp auto-reply | WhatsApp linked (`openclaw status`), narrator's number in `channels.whatsapp.allowFrom` or `dmPolicy: "open"`, `mkdir -p ~/.openclaw/media` |82| Telegram auto-reply | Telegram bot configured, narrator's numeric user ID in `channels.telegram.allowFrom` |83| WeCom auto-reply | `@sunnoy/wecom` plugin loaded, `channels.wecom.enabled: true` |84| iMessage auto-reply | macOS only. `channels.imessage.enabled: true`, narrator's phone/email in `channels.imessage.allowFrom`, Full Disk Access granted to terminal. Requires `imsg` CLI (`brew install pj4533/homebrew-imsg/imsg`) |85| Voice replies (TTS) | `messages.tts` configured in openclaw config — see `references/media-and-voice.md` |86| Voice note transcription | `pip3 install mlx-whisper` (Apple Silicon) or `brew install openai-whisper`, or run `/memorist_agent setup-stt` |8788File paths use `~/.openclaw/` (`$HOME/.openclaw/` on all platforms — macOS, Linux, Windows WSL).8990---9192## Commands9394| Command | Description |95|---------|-------------|96| `/memorist_agent setup` | Add a narrator and configure their interview channel |97| `/memorist_agent interview [--narrator NAME] [--domain DOMAIN]` | Start or continue an interview session |98| `/memorist_agent spawn [--narrator NAME]` | Enable auto-reply — creates a dedicated agent for this narrator |99| `/memorist_agent despawn [--narrator NAME]` | Disable auto-reply — remove the dedicated agent |100| `/memorist_agent remind [--narrator NAME]` | Send a gentle reminder to continue their story |101| `/memorist_agent stories [--narrator NAME] [--domain DOMAIN]` | Browse collected story fragments |102| `/memorist_agent entities [--narrator NAME]` | Show the entity map: people, places, years |103| `/memorist_agent compile [--narrator NAME]` | Compile fragments into polished memoir chapters |104| `/memorist_agent export [--narrator NAME] [--format md\|json\|txt]` | Export the memoir to a file |105| `/memorist_agent share [--narrator NAME]` | Invite a family co-editor to review |106| `/memorist_agent status` | Show all narrators, progress, and agent status |107| `/memorist_agent setup-stt` | Auto-install voice transcription |108109---110111## Life Story Domains112113| ID | Domain (EN) | Domain (ZH) | Sample Opening Question |114|----|-------------|-------------|------------------------|115| `origins` | Origins & Childhood | 出身与童年 | "Where were you born, and what's your earliest memory of home?" |116| `growing-up` | Growing Up | 成长岁月 | "What was school like for you? Who were your closest friends?" |117| `family-history` | Family History | 家族历史 | "Tell me about your parents — what kind of people were they?" |118| `love` | Love & Partnership | 爱情与伴侣 | "How did you and Mum/Dad first meet?" |119| `work` | Work & Career | 工作与事业 | "What was your first real job? What did you dream of becoming?" |120| `places` | Places & Journeys | 地方与旅途 | "What places have you lived in across your life?" |121| `history` | Historical Moments | 历史时刻 | "You lived through [decade] — what do you remember most?" |122| `milestones` | Family Milestones | 家庭里程碑 | "What family celebrations stand out most in your memory?" |123| `wisdom` | Values & Wisdom | 价值观与智慧 | "What's the most important lesson life has taught you?" |124125---126127## Storage Layout128129All data is stored locally at `~/.openclaw/memorist_agent/`:130131```132~/.openclaw/memorist_agent/133├── owner.json # Skill owner's name134├── narrators.json # Index of all narrators135├── narrators/136│ └── {narrator-id}/137│ ├── profile.json # Narrator metadata & domain progress138│ ├── entities.json # Extracted people, places, years139│ ├── sessions.json # Interview session log140│ ├── fragments/ # Story fragments by domain141│ ├── chapters/ # Compiled memoir chapters142│ ├── exports/ # Exported memoir files143│ └── workspace/ # Agent workspace (if auto-reply enabled)144```145146---147148## /memorist_agent setup149150**Purpose:** Register a narrator and choose how interviews will be conducted.151152**Steps:**1531541. **First-run bootstrap**: Create the data directory if it doesn't exist:155 - `mkdir -p ~/.openclaw/memorist_agent/narrators`156 - If `narrators.json` doesn't exist, create it as `[]`.157 - If this is the first run, ask: **"What's your name? (This is how narrators will know who set this up.)"** Save to `~/.openclaw/memorist_agent/owner.json` as `{ "name": "{name}" }`. Skip if `owner.json` already exists.1581592. Ask the user:160 ```161 Let's set up your narrator. I'll ask a few questions.162163 1. What is their name? (e.g. "Dad", "Grandma Li", "Uncle Chen")164 2. What's their relationship to you? (parent / grandparent / relative / friend)165 3. What language should I interview them in?166 [1] English167 [2] Chinese (普通话)168 [3] Both (start in Chinese, key summaries in English)169 4. How should I conduct interviews?170 [1] Relay — I give you questions, you ask them and bring back answers171 (Works with any channel: in person, phone call, WeChat, etc.)172 [2] WhatsApp auto-reply — they chat directly with a dedicated agent173 (Requires WhatsApp gateway. I'll help you set it up.)174 [3] iMessage auto-reply — they chat via iMessage with a dedicated agent175 (macOS only. Requires iMessage channel configured.)176 [4] Telegram auto-reply — they chat via Telegram with a dedicated agent177 (Requires Telegram bot configured.)178 [5] Live — the narrator is here right now, let's start talking179 ```1801813. **If "WhatsApp auto-reply" is selected:**182 a. Ask for their WhatsApp number (with country code, e.g. `+1234567890`).183 b. **Validate allowlist**: Read the openclaw config and check if the number is in `channels.whatsapp.allowFrom` or if `dmPolicy` is `"open"`. If NOT:184 ```185 ⚠️ {number} is not in your WhatsApp allowlist yet.186 Their replies will be silently dropped without this.187188 I can add it for you — shall I update channels.whatsapp.allowFrom?189 [Yes, add it] / [No, I'll do it manually]190 ```191 If user says yes, add the number to `channels.whatsapp.allowFrom` in the openclaw config file.192 c. **Verify gateway**: Check `openclaw status` output. If WhatsApp is not `linked`:193 ```194 ⚠️ WhatsApp gateway is not connected.195 Run: openclaw status196 If WhatsApp shows "not linked", you'll need to pair it first.197198 For now, I'll set up the narrator in Relay mode. You can switch to199 WhatsApp auto-reply later with /memorist_agent spawn.200 ```201 Fall back to relay mode if gateway is not ready.202 d. **Create media directory**: `mkdir -p ~/.openclaw/media` (gateway rejects media from other paths).2032044. **If "iMessage auto-reply" is selected:**205 a. Ask for their phone number or Apple ID email.206 b. **Check platform**: If not macOS, warn: "iMessage is only available on macOS. Switching to Relay mode."207 c. **Validate allowlist**: Check if the number/email is in `channels.imessage.allowFrom` or if `dmPolicy` is `"open"`. Offer to add if missing (same flow as WhatsApp step 3b).208 d. **Verify iMessage**: Check `openclaw status` — iMessage should show `OK` or `configured`. If not:209 ```210 ⚠️ iMessage channel is not configured.211 Make sure:212 1. channels.imessage.enabled: true in your openclaw config213 2. imsg CLI is installed: brew install pj4533/homebrew-imsg/imsg214 3. Full Disk Access is granted to your terminal app215 (System Settings → Privacy & Security → Full Disk Access)216217 For now, I'll set up in Relay mode. Switch later with /memorist_agent spawn.218 ```219 e. **Create media directory**: `mkdir -p ~/.openclaw/media`.2202215. **If "Telegram auto-reply" is selected:**222 a. Ask for their Telegram user ID (numeric). Explain: "Ask them to message @userinfobot on Telegram to get their numeric ID."223 b. **Validate allowlist**: Check if the ID is in `channels.telegram.allowFrom`. Offer to add if missing.224 c. **Verify Telegram**: Check `openclaw status` — Telegram should show `OK`. Warn and fall back to relay if not configured.2252266. **If "Live" is selected:** Note that the narrator is present — skip channel setup, start interview immediately after setup completes.2272285. Generate a narrator ID: `narrator-{slug(name)}-{timestamp}`.2292306. Create `~/.openclaw/memorist_agent/narrators/{id}/` directory structure (including `fragments/`, `chapters/`, `exports/` subdirs):231232 **profile.json:**233 ```json234 {235 "id": "{narrator-id}",236 "name": "{name}",237 "relationship": "{relationship}",238 "lang": "{en|zh|both}",239 "channel": "{relay|whatsapp|imessage|telegram|live}",240 "whatsapp": "{number or null}",241 "imessage": "{phone or email or null}",242 "telegram": "{numeric user ID or null}",243 "replyFormat": "text",244 "createdAt": "{ISO timestamp}",245 "domains": {246 "origins": { "status": "not-started", "fragmentCount": 0 },247 "growing-up": { "status": "not-started", "fragmentCount": 0 },248 "family-history": { "status": "not-started", "fragmentCount": 0 },249 "love": { "status": "not-started", "fragmentCount": 0 },250 "work": { "status": "not-started", "fragmentCount": 0 },251 "places": { "status": "not-started", "fragmentCount": 0 },252 "history": { "status": "not-started", "fragmentCount": 0 },253 "milestones": { "status": "not-started", "fragmentCount": 0 },254 "wisdom": { "status": "not-started", "fragmentCount": 0 }255 }256 }257 ```258259 **entities.json:** `{ "people": [], "places": [], "years": [], "events": [] }`260261 **sessions.json:** `[]`2622637. Append narrator to `narrators.json`.2642658. **If channel is "whatsapp", "imessage", or "telegram", immediately recommend auto-reply:**266 ```267 Narrator added: {name}268 Language : {lang}269 Channel : WhatsApp ({number})270271 For the best experience, I recommend enabling auto-reply so {name}272 can chat directly without you copy-pasting messages.273274 Enable now? /memorist_agent spawn --narrator "{name}"275 [Skip — I'll use relay mode for now]276 ```277278 **Otherwise (relay or live):**279 ```280 Narrator added: {name}281 Language : {lang}282 Channel : {channel}283 Domains : 9 life story domains ready284285 Start the first interview with:286 /memorist_agent interview --narrator "{name}"287 ```288289---290291## /memorist_agent interview292293**Purpose:** Conduct one interview session covering one memory domain. Generates 1–3 story fragments and updates the entity map.294295**Usage:**296- `/memorist_agent interview` — auto-selects narrator and next domain297- `/memorist_agent interview --narrator "Dad"` — specific narrator298- `/memorist_agent interview --narrator "Dad" --domain origins` — specific domain299- `/memorist_agent interview --narrator "Dad" --resume` — continue last session300301**High-level flow:**3021. Load narrator context (profile, entities, prior fragments)3032. Pick next domain (or resume in-progress one)3043. Generate opening question adapted to language and prior context3054. Send question via configured channel (relay, WhatsApp, or live)3065. Run adaptive follow-up loop (3–5 exchanges per session)3076. Distill exchanges into a first-person story fragment3087. Update entity map and save all data309310**Error handling:**311- If no narrators exist: "No narrators set up yet. Run `/memorist_agent setup` first."312- If all 9 domains are complete: "All domains are complete! Run `/memorist_agent compile` to create the memoir."313- If WhatsApp gateway is down: Fall back to relay mode and warn the user.314315**For detailed step-by-step instructions, read:** `references/interview-workflow.md`316317**Interview principles (read before first session):** `references/interview-principles.md`318319---320321## /memorist_agent remind322323**Purpose:** Send a gentle, warm reminder to continue sharing stories.324325**Steps:**3261. Load narrator profile. Find in-progress or next not-started domain.3272. Generate personalized reminder referencing something they already shared.3283. Send via WhatsApp if configured, otherwise display for relay.329330---331332## /memorist_agent stories333334**Purpose:** Browse collected story fragments.335336**Usage:**337- `/memorist_agent stories` — all fragments for default narrator338- `/memorist_agent stories --narrator "Dad" --domain origins` — filtered339340**Steps:**3411. Load all fragment files for the narrator.3422. Display grouped by domain: title, preview, people/places mentioned, pending follow-ups.3433. Show total fragment count and domain coverage.344345---346347## /memorist_agent entities348349**Purpose:** Show the entity map — all people, places, years, events extracted from stories.350351**Steps:**3521. Load `entities.json` for the narrator.3532. Display grouped by type, with follow-up status (resolved vs pending).3543. Show count of unresolved entities that will be followed up automatically.355356---357358## /memorist_agent compile, export, share359360**Purpose:** Compile fragments into memoir chapters, export to file, share with family.361362**For detailed instructions, read:** `references/compile-export-share.md`363364---365366## /memorist_agent spawn, despawn367368**Purpose:** Enable or disable auto-reply for a narrator. "Spawn" creates a dedicated, isolated agent that chats directly with the narrator — no copy-pasting needed. "Despawn" removes it.369370After spawning, all messages from the narrator's WhatsApp/Telegram route directly to their personal agent. The main session is never touched.371372**Error handling:**373- If gateway is not running: "Gateway is not running. Start it with `openclaw gateway start`, then try again."374- If WhatsApp is not linked: "WhatsApp is not connected. Run `openclaw status` to check."375- If narrator's number is not in allowlist: Offer to add it (same as setup step 3b).376- If spawn fails for any reason: Fall back gracefully — "Auto-reply couldn't be enabled. You can still use relay mode with `/memorist_agent interview`."377378**For detailed instructions, read:** `references/spawn-despawn.md`379380---381382## /memorist_agent status383384**Purpose:** Overview of all narrators and their progress.385386**Steps:**3871. Load `narrators.json` and each narrator's `profile.json`.3882. Display per narrator: name, relationship, language, channel, agent status, domain progress bar, fragment count, last session date.3893. Show available commands.390391```392Memorist Agent — Overview393394Narrators: {N}395───────────────────────────────396{name} ({relationship})397 Language : {lang}398 Channel : {Relay / WhatsApp auto-reply / Live}399 Agent : {active/none}400 Progress : {bar} {N}/9 domains401 Fragments : {count} stories collected402───────────────────────────────403```404405---406407## Common Issues408409| Problem | Cause | Fix |410|---------|-------|-----|411| Narrator's WhatsApp replies don't arrive | Number not in allowlist | Add to `channels.whatsapp.allowFrom` in openclaw config, or set `dmPolicy: "open"` |412| `/memorist_agent spawn` fails | Gateway not running | `openclaw gateway start` or `openclaw gateway restart` |413| Media sends hang (text works) | Gateway WhatsApp connection crashed | `openclaw gateway restart` |414| Voice notes not transcribed | No STT tool installed | Run `/memorist_agent setup-stt` |415| Voice replies don't play properly | Wrong audio format | WhatsApp needs OGG/Opus, not MP3. See `references/media-and-voice.md` |416| TTS produces garbled speech | Wrong voice language | Set `messages.tts.edge.voice` to match narrator's language in openclaw config |417| Interview says "no narrators" | Haven't run setup yet | Run `/memorist_agent setup` first |418| All domains complete | Interviews finished | Run `/memorist_agent compile` to create the memoir |419420---421422## Privacy Architecture423424| Data | Where it lives | Who can access |425|------|---------------|----------------|426| Story fragments | `~/.openclaw/memorist_agent/` | Local machine only |427| Entity map | `~/.openclaw/memorist_agent/` | Local machine only |428| Interview sessions | `~/.openclaw/memorist_agent/` | Local machine only |429| Compiled chapters | `~/.openclaw/memorist_agent/` | Local machine only |430| WhatsApp messages sent | Narrator's WhatsApp | Narrator only |431| Exported files | Path you choose | You control sharing |432433**Claude AI** processes text during active sessions. If privacy-sensitive, use relay mode — type questions manually and record answers yourself.434435---436437## Tool Usage Notes438439- **file_read / file_write**: all narrator data at `~/.openclaw/memorist_agent/`.440- **whatsapp_send_message**: used only when narrator channel is `whatsapp`.441- **fetch**: only called if user runs `/memorist_agent share` with API option.442- **web_search**: not used. This skill is intentionally offline-first.443444**For media format requirements, TTS config, STT setup, and troubleshooting, read:** `references/media-and-voice.md`