# Send Mediator to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mediator",
    "name": "Mediator",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/dylntrnr/mediator",
    "canonicalUrl": "https://clawhub.ai/dylntrnr/mediator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mediator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mediator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/prompts.md",
      "scripts/config-helper.py",
      "scripts/mediator.sh",
      "scripts/process-email.py",
      "scripts/process-imessage.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mediator",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T13:35:24.626Z",
      "expiresAt": "2026-05-07T13:35:24.626Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mediator",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mediator",
        "contentDisposition": "attachment; filename=\"mediator-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mediator"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mediator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mediator",
    "downloadUrl": "https://openagent3.xyz/downloads/mediator",
    "agentUrl": "https://openagent3.xyz/skills/mediator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mediator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mediator/agent.md"
  }
}
```
## Documentation

### Mediator Skill

Emotional firewall for difficult relationships. Intercepts messages from configured contacts, strips out emotional content, presents just the facts, and helps draft measured responses.

### Quick Start

# Initialize config (creates mediator.yaml if missing)
~/clawd/skills/mediator/scripts/mediator.sh init

# Add a contact to mediate
~/clawd/skills/mediator/scripts/mediator.sh add "Ex Partner" \\
  --email "ex@email.com" \\
  --phone "+15551234567" \\
  --channels email,imessage

# Process incoming (usually called by cron/heartbeat)
~/clawd/skills/mediator/scripts/mediator.sh check

# List configured contacts
~/clawd/skills/mediator/scripts/mediator.sh list

# Remove a contact
~/clawd/skills/mediator/scripts/mediator.sh remove "Ex Partner"

### Configuration

Config lives at ~/.clawdbot/mediator.yaml:

mediator:
  # Global settings
  archive_originals: true      # Archive raw messages after processing
  notify_channel: telegram     # Where to send summaries (telegram|slack|imessage)
  
  contacts:
    - name: "Ex Partner"
      email: "ex@email.com"
      phone: "+15551234567"
      channels: [email, imessage]
      mode: intercept          # intercept | assist
      summarize: facts-only    # facts-only | neutral | full
      respond: draft           # draft | auto (dangerous)
      
    - name: "Difficult Client"  
      email: "client@company.com"
      channels: [email]
      mode: assist             # Don't hide originals, just help respond
      summarize: neutral
      respond: draft

### Modes

intercept: Archive/hide original, only show summary. User never sees raw emotional content.
assist: Show original but also provide summary and response suggestions.

### Summarize Options

facts-only: Extract only actionable items, requests, deadlines. No emotion.
neutral: Rewrite the message in neutral tone, preserving all content.
full: Show everything but flag emotional/manipulative language.

### Respond Options

draft: Generate suggested response, wait for approval before sending.
auto: Automatically respond (use with extreme caution).

### Email Flow

Gmail Pub/Sub notification arrives (real-time)
Check if sender matches any configured contact
If match:

Fetch full email content
Process through LLM to extract facts/strip emotion
Archive original (apply "Mediator/Raw" label, mark read)
Send summary to configured notify channel
If response needed, draft one

### iMessage Flow

imsg watch monitors for new messages
Check if sender matches configured contact
If match:

Process message content
Send summary to notify channel
Draft response if requested

### Scripts

mediator.sh - Main CLI wrapper
process-email.py - Email processing logic
process-imessage.py - iMessage processing logic
summarize.py - LLM-based content analysis and summarization

### Heartbeat Check

Add to HEARTBEAT.md:

## Mediator Check
~/clawd/skills/mediator/scripts/mediator.sh check

### Cron (for more frequent checking)

# Check every 5 minutes during business hours
*/5 9-18 * * 1-5 ~/clawd/skills/mediator/scripts/mediator.sh check

### Safety Notes

Never auto-respond to legal, financial, or child-related messages
Original messages are archived, not deleted (recoverable)
All actions logged to ~/.clawdbot/logs/mediator.log
Review and adjust prompts if summaries miss important context

### Example Output

Original email:

I can't BELIEVE you would do this to me AGAIN. After everything I've done for you!!! You NEVER think about anyone but yourself. I need you to pick up the kids at 3pm on Saturday and if you can't even do THAT then I don't know what to say anymore.

Mediator summary:

From: Ex Partner
Channel: Email
Action Required: Yes
Request: Pick up kids at 3pm Saturday
Suggested response:
"Confirmed. I'll pick up the kids at 3pm on Saturday."

See references/prompts.md for the LLM prompts used in processing.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dylntrnr
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T13:35:24.626Z
- Expires at: 2026-05-07T13:35:24.626Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mediator)
- [Send to Agent page](https://openagent3.xyz/skills/mediator/agent)
- [JSON manifest](https://openagent3.xyz/skills/mediator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mediator/agent.md)
- [Download page](https://openagent3.xyz/downloads/mediator)