OpenClaw Docker 补丁镜像 2.0：给你的 AI Agent 装上六种“新感官”

# 停旧容器并移除（如果有的话，没有可以略过这一步）
docker compose down
# 启动新容器
docker compose up -d --force-recreate
# 看启动日志
docker compose logs -f --tail=200

fd --version  
magick -version  
yt-dlp --version  
sqlite3 --version

# TOOLS.md - Local Notes

Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup.

## 🛠 Optimal Tool Selection Matrix (Docker Environment)

To ensure stability and efficiency in this Docker environment, follow these tool preferences.

### 1. Web Scraping & Browser Automation

- Primary: **Playwright (Node.js, playwright-core)**.
    
- Reason: Docker has no desktop browser session, so the "Chrome extension relay / attach tab" workflow is unreliable by default.
    
- Standard script location: `/home/node/.openclaw/workspace/` (place fetch/automation scripts here).
    
- Rule: **Always launch the browser through Playwright**. Do NOT rely on an external GUI browser or the Chrome extension relay unless explicitly configured.
    

Implementation notes (current image):

- Playwright core:
    
    - Module: `/app/node_modules/playwright-core`
        
    - CLI: `node /app/node_modules/playwright-core/cli.js …`
        
- Browser binaries:
    
    - Default cache root (aligned with upstream Dockerfile): `/home/node/.cache/ms-playwright`
        
    - Chromium lives under a versioned directory such as:
        
        - `/home/node/.cache/ms-playwright/chromium-1208/chrome-linux64/chrome`
            
    - Do **not** assume `/usr/bin/chromium` or `/usr/bin/chromium-browser` exists.
        
- When you need JS rendering, cookies, or anti-bot handling, **Playwright is the default**. Typical pattern:
    

const { chromium } = require('/app/node_modules/playwright-core');  
const browser = await chromium.launch({ headless: true, args: ['--no-sandbox'] });

---

### 2. Media & Document Processing

- Video/Audio: **ffmpeg** Use for compression, format conversion, trimming, extracting audio, and metadata inspection.
    
- Images: **ImageMagick** Prefer `magick` (provided as a compatibility alias) for complex operations; `convert` also works.
    
- PDF (fast extraction): **poppler-utils** Prefer `pdftotext` for fast text extraction. If text extraction fails or layout is complex, use `pdftoppm` to render pages to images.
    
- PDF (layout/table precision, Python): **pdfplumber** (via Python venv) Use when you need accurate table extraction or layout-aware parsing.
    
- Document conversion: **pandoc** Use for converting between Markdown/HTML/DOCX and other formats (PDF output is optional and not required).
    
- Excel/CSV: **xlsx2csv** Convert Excel files to CSV for easier downstream parsing.
    

---

### 3. High-Performance System Tools

- Content search: **ripgrep (`rg`)** Use for searching text content in workspace, logs, and knowledge bases.
    
- File name search: **fd** Debian provides `fdfind`, but `fd` is available as a compatibility alias (`/usr/local/bin/fd`). Prefer `fd` in scripts for portability.
    
- JSON processing: **jq** ALWAYS use `jq` for JSON slicing/filtering. Do not parse JSON with regex.
    
- Interactive selection: **fzf** Use with `fd` and `rg` when you need to pick from many files/paths.
    

---

### 4. Data Sync & Database

- Cloud/Remote sync: **rclone** Use for S3 / OneDrive / Google Drive / WebDAV sync, backups, and migrations.
    
- Database (transparent and auditable): **sqlite3 CLI** This is the primary database interface. Keep SQL explicit so logs are auditable.
    
- Vector search (SQLite extension): **sqlite-vec** OpenClaw’s built-in memory already uses sqlite-vec via the Node integration. If you create your own SQLite databases for custom search, load the same extension explicitly:
    
    - Current extension path (from `openclaw memory status`): `/app/node_modules/.pnpm/[email protected]/node_modules/sqlite-vec-linux-x64/vec0.so`
        
    - Typical usage pattern:
        

sqlite3 knowledge.db \  
  ".load '/app/node_modules/.pnpm/[email protected]/node_modules/sqlite-vec-linux-x64/vec0.so'" \  
  "SELECT 1;"

- If a shorter path is added later (e.g. a symlink `/usr/local/lib/vec0.so`), update this section accordingly.
    

Rules:

- Prefer sqlite3 CLI over language bindings (Node/Python drivers) when you need transparency and simple deployments.
    
- Keep `.load` paths absolute and explicit so behavior is reproducible across restarts and rebuilds.
    

---

### 5. Python (Anki & Knowledge Workflows)

Python packages are installed in a dedicated venv at `/opt/venv`.

Environment (current image):

- `VENV_PATH=/opt/venv`
    
- `PATH` has been set so that `"$VENV_PATH/bin"` comes before system paths.
    

This means:

- `python` / `pip` → venv (`/opt/venv/bin/python`, `/opt/venv/bin/pip`)
    
- `python3` / `pip3` → system Python (`/usr/bin/python3`)
    

Critical rules:

- For all automation and helper scripts, **use `python` / `pip` (venv)**, not `python3` / `pip3`, unless you explicitly want system Python.
    
- Do NOT install extra packages with system `pip` unless there is a very specific reason.
    

Installed Python packages (venv):

- Anki & knowledge: `genanki`, `python-frontmatter`, `feedparser`
    
- Web parsing: `httpx`, `beautifulsoup4` (`bs4`), `lxml`, `pyyaml`
    
- Data & charts: `pandas`, `matplotlib`
    
- Images: `Pillow`
    
- TTS/audio: `edge-tts`, `pydub`
    
- PDF precision: `pdfplumber`
    
- Utilities: `qrcode`, `loguru`
    

Practical rules:

- If you write a Python helper script, run it with:
    

python /home/node/.openclaw/workspace/your_script.py ...

- If you need to install additional Python packages later, do it explicitly via:
    

pip install <pkg>

This uses the venv `pip` and keeps everything inside `/opt/venv`.

---

## 🔧 Fixed Environment Paths (DO NOT GUESS)

- Workspace root: `/home/node/.openclaw/workspace`
    
- Venv root: `/opt/venv`
    
- Venv Python: `/opt/venv/bin/python`
    
- Playwright core: `/app/node_modules/playwright-core`
    
- Playwright browsers root: `/home/node/.cache/ms-playwright`
    
- SQLite-vec (current used by memory): `/app/node_modules/.pnpm/[email protected]/node_modules/sqlite-vec-linux-x64/vec0.so`