VibeSurf skill for OpenClaw (Claw). Control browsers, search the web, extract data, and automate workflows through VibeSurf.
- Browser Control - Navigate websites, click elements, fill forms
- Web Search - AI-powered search with summarized results
- Data Extraction - Extract structured data, tables, lists from pages
- Content Fetching - Get webpage content as markdown
- Screenshots - Capture webpage visuals
- Workflows - Execute pre-built automation workflows
- App Integrations - Gmail, GitHub, Slack via Composio
- File Management - Upload and download files
- Configuration - Manage LLM profiles, MCP servers, schedules
You must have VibeSurf running before using this skill.
# Install VibeSurf
uv tool install vibesurf
# Start VibeSurf server
vibesurf# Pull and run VibeSurf container
docker pull ghcr.io/vibesurf-ai/vibesurf:latest
docker run --name vibesurf -d --restart unless-stopped \
-p 9335:9335 \
-p 6080:6080 \
-p 5901:5901 \
-v ./data:/data \
-e IN_DOCKER=true \
-e VIBESURF_BACKEND_PORT=9335 \
-e VIBESURF_WORKSPACE=/data/vibesurf_workspace \
-e RESOLUTION=1440x900x24 \
--shm-size=4g \
--cap-add=SYS_ADMIN \
ghcr.io/vibesurf-ai/vibesurf:latestVibeSurf will be available at http://127.0.0.1:9335 by default.
If VibeSurf is running on a different host/port:
# Linux/macOS
export VIBESURF_ENDPOINT=http://127.0.0.1:9335
# Windows PowerShell
$env:VIBESURF_ENDPOINT="http://127.0.0.1:9335"Install the VibeSurf skill using ClawHub:
npx clawhub@latest install vibesurfOr manually copy the skill folder to your OpenClaw skills directory:
# Linux/macOS
cp -r vibesurf ~/.openclaw/skills/
# Windows
xcopy /E /I vibesurf %USERPROFILE%\.openclaw\skills\vibesurfIf you already have vibesurf installed and want to update to the latest version:
npx clawhub update vibesurfTo force update (overwrite local modifications):
npx clawhub update vibesurf --forceAfter installation and starting VibeSurf, you can:
Search for latest AI news
Fetch content from https://example.com
Take a screenshot of https://google.com
Upload file /path/to/document.pdf
This skill uses progressive disclosure - the main SKILL.md contains quick reference tables, and detailed guides are in the references/ folder:
| Task | Reference File |
|---|---|
| Web Search | references/search.md |
| Browser Control | references/browser.md |
| Data Extraction | references/extraction.md |
| File Upload/Download | references/file.md |
| LLM Configuration | references/config-llm.md |
| And more... | See references/ folder |
- search.md - AI web search
- fetch.md - Fetch URL content
- crawl.md - Extract article content
- summary.md - Page summarization
- extraction.md - Structured data extraction
- screenshot.md - Page screenshots
- browser.md - Direct browser control
- browser-use.md - AI browser automation
- integrations.md - External app integrations
- workflows.md - Pre-built workflows
- website-api.md - Social media platform APIs
- file.md - File upload/download
- config-llm.md - LLM profile configuration
- config-mcp.md - MCP server configuration
- config-composio.md - Composio toolkit configuration
- config-schedule.md - Workflow scheduling
- config-vibesurf.md - VibeSurf API key and workflows
- User Request → OpenClaw reads
SKILL.md - Decision Table → Match request to reference file
- Load Reference → Read detailed guide from
references/ - Execute → Call VibeSurf API endpoints
All operations go through VibeSurf's HTTP API:
POST $VIBESURF_ENDPOINT/api/tool/execute
See individual reference files for specific endpoints and parameters.
curl $VIBESURF_ENDPOINT/healthIf this fails, start VibeSurf first:
vibesurfMake sure the skill is installed in the correct location:
- Global:
~/.openclaw/skills/vibesurf/ - Workspace:
<project>/.openclaw/skills/vibesurf/
Contributions welcome! This is a markdown-based skill - edit the SKILL.md and reference files directly.
MIT License
- VibeSurf - Browser automation framework
- Claude-Surf - Claude Code plugin for VibeSurf