OpenClaw Chrome Assistant

About

# OpenClaw Chrome Assistant (v0.26)

[English]
A simple and lightweight Chrome extension designed to make communicating with your OpenClaw agent seamless while browsing. Whether you need to summarize a page, save a snippet, or just ask a quick question, OpenClaw Assistant is always just a click away.

[繁體中文]
這是一個簡單輕量的 Chrome 擴充功能，旨在讓您在瀏覽網頁時能與 OpenClaw 助理進行無縫溝通。無論是需要摘要網頁、記錄片段，還是隨手提問，OpenClaw 助理隨時待命。

Github: 
https://github.com/kctony/OpenClaw-Chrome-Assistant
---

## Features / 功能 (v0.26)

1.  **Draggable Floating Icon / 可拖動圖示 (🦞)**:
    - Click to open dialog. / 點擊開啟對話框。
    - Drag to reposition (auto-saved). / 拖動改變位置（自動記憶）。
    - Hover for Quick Options menu (with 500ms delay for better UX). / 滑鼠懸停顯示快速選單（500ms 延遲優化體驗）。
2.  **Smart Context Modes / 智慧情境模式**:
    - **Page Mode**: Summarize current page via right-click or hover menu. / 摘要當前網頁。
    - **Selection Mode**: Save or analyze selected text. / 記錄或分析選取文字。
    - **Image Mode**: Explain images with a simple right-click. / 解釋圖片內容。
3.  **UI/UX Improvements / 介面優化**:
    - **Dark Mode**: Professional dark theme for comfortable night use. / 專業暗色模式。
    - **Autogrow Input**: Textarea grows as you type. / 自動長高輸入框。
    - **Fullscreen Mode (⛶)**: Toggle to cover entire page. / 全螢幕切換按鈕。
    - **Auto-Fade**: Dialog fades to 0.1 opacity after 3s of inactivity (adjustable). / 閒置 3 秒自動淡化。
4.  **Enhanced Settings / 設定增強**:
    - **Emoji Sync**: Toolbar icon matches custom floating icon. / 工具列圖示同步自訂 Emoji。
    - **Gateway Auto-complete**: Automatically appends `/v1/chat/completions`. / 自動補全 Gateway URL。
    - **Bilingual Support**: Supports Traditional Chinese and English. / 支援繁體中文與英文。
    - **Custom Prompts**: Manage multiple quick action prompts for each mode. / 每種模式可自訂多個快速指令。

## Recent Changes / 近期變更

### v0.26 (2026-02-22)
- **Rebranding**: Complete rename from "Lobster" to "OpenClaw" across all code, CSS, and user-facing text.
- **Permission Cleanup**: Removed unused `scripting` and `offscreen` permissions (compliance with Chrome Web Store policies).
- **Storage Keys**: Unified storage namespace to `openclaw_*`.
- **CSS Classes**: All CSS IDs and classes renamed from `lobster-*` to `openclaw-*`.

### v0.21
- Initial release with core features.

## Installation / 安裝說明

1.  Open Chrome and go to `chrome://extensions/`. / 打開 Chrome 瀏覽器，進入 `chrome://extensions/`。
2.  Enable **Developer mode**. / 開啟右上角的「開發人員模式」。
3.  Click **Load unpacked**. / 點擊「載入未封裝項目」。
4.  Select project directory. / 選擇 `/srv/chrome/chrome-extension-lobster/`。

## Configuration / 設定說明

1.  After installation, click OpenClaw icon in the toolbar and select **Options**. / 安裝後，點擊工具列圖示進入「設定」。
2.  **Token**: Required (Your OpenClaw Token). / 必填 (OpenClaw Token)。
3.  **Gateway URL**: e.g., `http://localhost:18789`. / 填入基礎位址即可。
4.  **Custom Icon**: Enter an Emoji (e.g., 🤖, ⚡) to change the floating icon. / 可輸入 Emoji 更改圖示。

## Permissions / 權限說明

This extension uses minimal permissions:
- `storage`: Save your settings and custom icons.
- `contextMenus`: Add right-click menu items for quick actions.
- `activeTab`: Get page URL and content for context-aware actions.
- `host_permissions: <all_urls>`: Communicate with any OpenClaw gateway instance.

## Usage / 使用方法

- **Chat**: Click floating 🦞 icon to open dialog. / 點擊右下角圖示開啟對話框。
- **Quick Action**: Hover over icon and select a prompt. / 滑鼠懸停在圖示上使用快速指令。
- **Right-click**: Use context menus on any page, text, or image. / 在網頁/文字/圖片上右鍵選擇功能。

## Development / 開發

**Location**: `/srv/chrome/chrome-extension-lobster/`

**Build ZIP**:
```bash
cd /srv/chrome
zip -r chrome-extension-lobster-v0.26.zip chrome-extension-lobster/
```

**Spec**: `/srv/workspace/brain/01-Projects/Chrome-Lobster-Assistant/2026-02-20_spec.md`

---

*Last updated: 2026-02-22*