ClawSide

Supercharge browsing with local AI

• 🔒 Completely local, privacy protected
• 🚀 Practical tools, double your efficiency
• 🦞 Agent-friendly, supports any OpenAI Compatible API (OpenClaw, Ollama, Hermes Agent, etc.)

Architecture

Chrome Page
  ├─ Floating bubble (content script) → small inline popup with result
  └─ Side panel (extension icon) → full-featured standalone panel
       ↓ HTTP (chrome-extension → 127.0.0.1:{port})
       Local LLM/Agent Gateway → LLM

Four interaction modes:

1. Floating bubble: Select text → bubble appears → click icon → result in popup
2. Radial menu: Long press on bubble → radial menu with translate/summarize/ask
3. Global page translation: Click translate in radial menu → translate entire page with loading placeholders
4. Full side panel: Click extension icon → full Translate/Summarize/Ask/History interface

Prerequisites (any OpenAI Compatible Gateway)

ClawSide connects to any local LLM/Agent that provides an OpenAI-compatible HTTP endpoint (e.g., OpenClaw, Ollama, Hermes Agent).

Configure Your Gateway

Enable the HTTP Gateway in your LLM/Agent configuration. Example for OpenClaw:

Add to ~/.openclaw/openclaw.json:

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": { "enabled": true }
      }
    }
  }
}

Restart your gateway:

openclaw gateway restart

For other gateways (Ollama, Hermes, etc.), refer to their documentation to enable the HTTP endpoint.

Quick Start

1. Open Chrome → chrome://extensions/
2. Enable Developer mode → Load unpacked → select extension/
3. Select text on any page → floating bubble appears → click an icon
4. Or click extension icon → Open side panel (full features)

Features

Floating Bubble (Quick)

Select text on any page → floating bubble appears → click an icon:

• 🌐 Translate — translated text in popup
• 📄 Summarize — page summary in popup (auto-triggers if no existing result)
• 💬 Ask — answer in popup

Radial Menu

Long press/right-click on bubble → radial menu with tool buttons:

• 🌐 Translate
• 📄 Summarize
• 💬 Ask

Clicking a tool opens the side panel to the corresponding tab.

Global Page Translation

Click 🌐 Translate in radial menu to translate all paragraphs on the current page:

• Shows loading placeholder for each paragraph
• Batch translates 10 paragraphs at a time
• Shows error icon if translation times out
• Click again to hide (without re-requesting LLM)
• Click again to re-show the previous translations

Full Side Panel

Click the ClawSide extension icon in toolbar:

• 🌐 Translate — translate selected text, choose target language
• 📄 Summarize — summarize current page, click ask icon to jump to Ask with context
• 💬 Ask — ask custom questions, Ctrl+Enter to send, chat history preserved per tab+URL
• 📜 History — view all past interactions, expand to see details

Popup Ask Transfer

In popup ask (floating bubble 💬), after having a conversation:

• Click the open-external icon (top-right) to transfer chat history to side panel's Ask tab
• Conversation continues seamlessly in the full side panel
• Chat history is saved per tab+URL in local storage

Ask from Summarize

In summarize result header, click the ask icon to:

• Jump to Ask tab
• Load summarize result as conversation context
• Auto-scroll to input box

Settings

Click ⚙️ in side panel:

• Gateway Port (default: 18789)
• Auth Token (if your gateway requires it)
• Language preference
• Tool prompt customization
• Appearance (system/light/dark)

Troubleshooting

"Failed to fetch" / Network error

• Is your gateway running? curl http://127.0.0.1:{port}/
• Is HTTP endpoint enabled in your gateway config?
• Restart gateway after changing config

401 Unauthorized

• Enter your gateway token in ⚙️ settings

403 Forbidden

• Make sure your gateway is configured to allow requests from your browser's IP address and origin

More Troubleshooting Tips

• ClawSide Troubleshooting

Requirements

• Chrome 114+ (side panel API)
• Any local LLM/Agent with OpenAI-compatible HTTP endpoint

License

MIT