perplexity-pro-openclaw

# Perplexity PRO for OpenClaw

This skill enables OpenClaw to search Perplexity PRO with persistent authenticated sessions, bypassing Cloudflare protection through undetectable browser automation.

## What This Skill Does

- ✅ Bypasses Cloudflare bot detection (Xvfb + stealth Chrome)
- ✅ Maintains persistent Perplexity PRO sessions across reboots
- ✅ Provides VNC access for manual OAuth authentication
- ✅ Creates automated search capability for OpenClaw agents

## Prerequisites

- Ubuntu Server (headless or with display)
- OpenClaw installed and configured
- Google Chrome (NOT Snap version)
- Xvfb package
- x11vnc for remote access

## Interactive Setup Steps

During installation, the agent will guide you through:

### Step 1: Chrome Installation
The agent will help you remove Snap Chromium and install proper Google Chrome:
```bash
sudo snap remove chromium
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
```

### Step 2: Browser Launcher Setup
The agent creates `start-stealth-browser.sh` with anti-bot settings:
- Xvfb virtual display (bypasses headless detection)
- Persistent profile in `~/.openclaw/browser-profile/`
- Stealth flags to mask automation

### Step 3: VNC Configuration
The agent sets up x11vnc for remote browser access:
```bash
sudo apt-get install -y x11vnc
x11vnc -storepasswd openclaw /tmp/vncpass
```

**⚠️ Security Note:** Default VNC password is "openclaw" - change this in production!

### Step 4: Manual Authentication (Required)
**You must authenticate manually through VNC:**

1. Connect via VNC (macOS: `open vnc://your-server:5900`, Windows: RealVNC Viewer)
2. Open Perplexity.ai in the browser
3. Click "Sign in with Google"
4. Enter your email and password directly
5. Complete 2FA if enabled

**Important:** App Passwords do NOT work for web authentication. Use your actual Google password.

## How to Use

After setup, the agent can search Perplexity:

```bash
# V...

# Perplexity PRO for OpenClaw

🔍 **Undetectable Perplexity PRO integration for OpenClaw with persistent sessions**

This skill enables OpenClaw agents to search Perplexity PRO while bypassing Cloudflare protection through stealth browser automation.

## ⚠️ What the Agent Will Ask You To Do

**Before installing, understand that this skill requires:**

1. **System modifications:** Installing Google Chrome, Xvfb, x11vnc
2. **Manual OAuth authentication:** You must log into Perplexity via VNC (cannot be automated)
3. **VNC access:** Remote desktop to the server for authentication
4. **Time investment:** ~15-20 minutes for initial setup

If you're not comfortable with these steps, do not proceed with installation.

## Quick Start

```bash
# Install the skill
clawdhub install perplexity-pro-openclaw

# Or manually clone
git clone https://github.com/Hantok/Perplexity-PRO-to-OpenClaw.git
```

## Detailed Installation

### Step 1: Install Google Chrome

**⚠️ Remove Snap Chromium first (it doesn't work with this setup):**

```bash
sudo snap remove chromium

# Download and install proper Chrome
cd /tmp
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get install -f -y

# Verify
google-chrome --version
```

### Step 2: Install Dependencies

```bash
sudo apt-get update
sudo apt-get install -y Xvfb x11vnc
```

### Step 3: Configure Browser Launcher

The skill creates `~/.openclaw/workspace/start-stealth-browser.sh`:

```bash
#!/bin/bash
# Kill existing instances
pkill -f "Xvfb :99" 2>/dev/null
pkill -f "google-chrome.*remote-debugging-port=18800" 2>/dev/null
sleep 1

# Create persistent profile (NOT in /tmp!)
mkdir -p ~/.openclaw/browser-profile

# Start Xvfb virtual display
export DISPLAY=:99
Xvfb :99 -screen 0 1920x1080x24 -ac +extension GLX +render -noreset &
sleep 2

# Start Chrome with anti-bot flags
google-chrome \
    --no-sandbox \
    --disable-setuid-sandbox \
    --disable-dev-s...