linkedin-monitor

# LinkedIn Monitor

Reliable LinkedIn inbox monitoring for Clawdbot.

## Features

- **Hourly monitoring** — Checks inbox every hour, 24/7
- **Deterministic state** — No duplicate notifications, ever
- **Progressive autonomy** — Start supervised, graduate to autonomous
- **Health checks** — Alerts when auth expires or things break
- **Your voice** — Drafts replies using your communication style

## Quick Start

```bash
# 1. Setup (interactive)
linkedin-monitor setup

# 2. Verify health
linkedin-monitor health

# 3. Run manually (test)
linkedin-monitor check

# 4. Enable cron (hourly)
linkedin-monitor enable
```

## Autonomy Levels

| Level | Name | Behavior |
|-------|------|----------|
| 0 | Monitor Only | Alerts to new messages only |
| 1 | Draft + Approve | Drafts replies, waits for approval |
| 2 | Auto-Reply Simple | Auto-handles acknowledgments, scheduling |
| 3 | Full Autonomous | Replies as you, books meetings, networks |

**Default: Level 1** — Change with `linkedin-monitor config autonomyLevel 2`

## Commands

```bash
linkedin-monitor setup      # Interactive setup wizard
linkedin-monitor health     # Check auth status
linkedin-monitor check      # Run one check cycle
linkedin-monitor enable     # Enable hourly cron
linkedin-monitor disable    # Disable cron
linkedin-monitor status     # Show current state
linkedin-monitor config     # View/edit configuration
linkedin-monitor logs       # View recent activity
linkedin-monitor reset      # Clear state (start fresh)
```

## Configuration

Location: `~/.clawdbot/linkedin-monitor/config.json`

```json
{
  "autonomyLevel": 1,
  "alertChannel": "discord",
  "alertChannelId": "YOUR_CHANNEL_ID",
  "calendarLink": "cal.com/yourname",
  "communicationStyleFile": "USER.md",
  "timezone": "America/New_York",
  "schedule": "0 * * * *",
  "morningDigest": {
    "enabled": true,
    "hour": 9,
    "timezone": "Asia/Bangkok"
  },
  "safetyLimits": {
    "maxMessagesPerDay": 50,
    "escalationKeywords": ["angry", "legal",...

# LinkedIn Monitor for Clawdbot

**Bulletproof LinkedIn inbox monitoring with zero duplicate notifications.**

Get notified when someone messages you on LinkedIn. Drafts replies in your voice. Never miss a lead.

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Clawdbot](https://img.shields.io/badge/clawdbot-skill-orange.svg)

---

## Features

- 🔔 **Hourly monitoring** — Checks your inbox every hour, 24/7
- 🚫 **No duplicates** — Each message reported exactly once (file-based state)
- ✍️ **Draft replies** — AI drafts responses in your communication style
- 🛡️ **Approval required** — Nothing sent without your OK
- 🌐 **Browser-based** — Works with your normal LinkedIn login
- ⚡ **Watchdog included** — Alerts you if monitoring stops working

---

## Quick Install

```bash
# 1. Install the skill
clawdhub install linkedin-monitor

# 2. Run setup
linkedin-monitor setup

# 3. Verify everything works
linkedin-monitor health

# 4. Enable hourly monitoring
linkedin-monitor enable
```

---

## Requirements

- [Clawdbot](https://github.com/clawdbot/clawdbot) installed and running
- A browser profile logged into LinkedIn
- A channel for alerts (Discord, Telegram, Slack, WhatsApp, or any Clawdbot channel)

---

## Setup Guide

### Step 1: Create a Browser Profile

LinkedIn Monitor uses Clawdbot's browser tool to check your inbox. You need a browser profile that's logged into LinkedIn.

**Option A: Use the default "clawd" profile**
```bash
# Start the clawd browser
clawdbot browser start --profile clawd

# This opens a Chrome window. Log into LinkedIn manually.
# Keep this browser open — it needs to stay running.
```

**Option B: Create a custom profile**
```bash
# Create a profile named "linkedin"
clawdbot browser start --profile linkedin

# Log into LinkedIn, then keep it open
```

> **Tip:** Put the browser on a second desktop/workspace so it doesn't interfere with your main browsing.

### Step 2: Run Setup

```bash
linkedin-monitor setup
```

This will ask y...