Phpstorm Openclaw Chat

README

# OpenClaw Chat — PhpStorm Plugin

Bring your own AI into JetBrains IDEs. Works with **OpenClaw**, OpenAI, or any OpenAI-compatible API.

## Features

- 💬 **Streaming Chat** — token-by-token responses
- 🖼️ **Image Support** — paste screenshots, send to vision models
- ⚙️ **Configurable API** — point it at your own endpoint
- 🎨 **Code Highlighting** — syntax-colored code blocks in responses
- 📝 **Markdown Rendering** — rich text with headings, lists, links
- 📤 **Context Actions** — right-click code → "Send to OpenClaw Chat"

## Requirements

- JetBrains IDE **2024.3+** (PhpStorm, IntelliJ IDEA, WebStorm, etc.)
- Java 17+ (bundled with PhpStorm, no extra install needed)

## Quick Install

### Option 1: Open & Build in PhpStorm (easiest)

1. **Clone** the repo:
   ```bash
   git clone https://github.com/campiGit/phpstorm-openclaw-chat.git
   ```
2. **Open** the folder in PhpStorm: `File → Open → select the cloned folder`
3. PhpStorm auto-detects the Gradle project — click **"Load Gradle Project"**
4. Wait for Gradle to download dependencies (first time takes ~2 min)
5. Open the **Gradle** tool window (`View → Tool Windows → Gradle`)
6. Run: `Tasks → intellijPlatform → buildPlugin`
7. Plugin ZIP appears in `build/distributions/`
8. **Install:** `Settings → Plugins → ⚙️ → Install Plugin from Disk…` → select the ZIP
9. **Restart** PhpStorm

### Option 2: Command Line

```bash
# Prerequisites: JDK 17+ and Gradle 8+
cd phpstorm-openclaw-chat
./gradlew buildPlugin
# ZIP is in build/distributions/
```

> If `gradlew` isn't present, first run: `gradle wrapper`

## Setup

1. Open **Settings → Tools → OpenClaw Chat**
2. Enter your **API Endpoint URL** (e.g. `https://api.openai.com/v1/chat/completions`)
3. Enter your **API Key**
4. Set your preferred **Model**
5. Open the chat: **View → Tool Windows → OpenClaw Chat**

## Usage

| Action | How |
|--------|-----|
| Send message | Type + **Ctrl+Enter** or click **Send** |
| New line | **Enter** (sends on Ctrl+Enter) |
| Paste image | **Ctrl+V** (image on clipboard) |
| Drag & drop image | Drop an image file onto the chat |
| Send code | Select code → Right-click → **Send to OpenClaw Chat** |
| Copy AI response | Click the 📋 icon on assistant messages |
| New conversation | Click the 🔄 button |

## Datenschutz & Sicherheit

**Das Plugin sendet KEINE Daten an Dritte.** Die gesamte Kommunikation läuft ausschließlich zwischen deiner IDE und dem von dir konfigurierten API-Endpoint. Es gibt:

- ❌ Keine Telemetrie
- ❌ Kein Tracking / Analytics  
- ❌ Keine Crash-Reports an externe Server
- ❌ Keine Update-Checks (die Verbindung zu einer fremden Infrastruktur herstellen)
- ❌ Keine versteckten Netzwerk-Verbindungen

**Datenfluss:** `Deine IDE → Dein API-Endpoint` (und zurück). Mehr nicht.

Der Chatverlauf wird nur lokal im IDE-Konfigurationsverzeichnis gespeichert (`openclaw-chat.xml`).
Der API-Key wird in derselben lokalen Datei abgelegt.

Geeignet für den Einsatz in deutschen Unternehmen mit DSGVO-Anforderungen — vorausgesetzt, der verwendete API-Endpoint ist selbst DSGVO-konform (z.B. eigener Server in Deutschland oder EU).

## Troubleshooting

**"Please configure API settings first"** → Go to `Settings → Tools → OpenClaw Chat` and fill in the API fields.

**No response / timeout** → Check that your API endpoint URL is correct and reachable. The plugin expects an OpenAI-compatible `/v1/chat/completions` endpoint.

**Build fails in PhpStorm** → Make sure PhpStorm is using JDK 17+: `File → Project Structure → SDK`.

## Development

```bash
# Run in sandbox IDE for testing
./gradlew runIde

# Run tests
./gradlew test
```