autoclaw-browser（自动爪浏览器）

AutoClaw Browser Automation Skill

Skill Overview

AutoClaw is a browser automation skill that provides comprehensive control over Chrome browser through MCP (Message Communication Protocol) communication with the browser extension.

Prerequisites

Before starting MCP service, ensure the following files exist in the correct directory:

• options.js - Browser extension options page script
• background.js - Extension background script handling WebSocket connections

File Location

%USERPROFILE%\.openclaw\skills\claw-browser\autoclaw-plugin\

🚀 v6.0.0 New Optimization Tools

Simplified DOM Retrieval

Index Click

Batch Operations

Smart Wait

Available Tools

⌨️ Keyboard Operations

📸 Screenshot & Content Extraction

🖱️ Mouse & Scroll Operations

📱 Touch & Swipe Operations (Mobile)

📑 Tab Management

📁 Bookmark Management

🍪 Storage & Cookies

🧪 JavaScript Execution

⏳ Wait Operations

🔧 Element Operations

🧠 Smart Operations (Enhanced)

📊 Task & Log Operations

⚙️ Configuration & Status

🌐 Navigation Operations

💾 Login Session Management

Configuration

• MCP Port: 30000 (default, customizable)
• Extension WebSocket: ws://127.0.0.1:{port}/extension
• Built-in Token: autoclaw_builtin_Q0hpK2oV4F9tlwbYX3RELxiJNGDvayr8OPqZzkfs
• Custom Token: Supported (leave empty to use built-in)

Installation Steps

1. Start MCP Server

cd %USERPROFILE%\.openclaw\skills\autoclaw_wboke\mcp
npm install  # First time only
npm start

2. Install Chrome Extension

1. Open chrome://extensions
2. Enable "Developer mode"
3. Click "Load unpacked"
4. Select autoclaw-plugin/ directory

3. Configure Extension

1. Click extension icon → Settings
2. Set port (default: 30000)
3. Enter custom Token (optional, leave empty for built-in)
4. Click "Save Settings" to authorize
5. Click "Attach All Tabs"

v6.0.0 Performance Optimization

Project Structure

autoclaw_wboke/
├── SKILL.md                    # This documentation
├── README.md                   # Main documentation
├── mcp/                       # MCP Server
│   ├── package.json
│   ├── dist/server.js         # Compiled server (v5.2.0) ⭐
│   └── node_modules/
├── autoclaw-plugin/           # Chrome Extension
│   ├── manifest.json
│   ├── background.js          # Background script (v6.0.0) ⭐
│   ├── popup.js               # Popup UI
│   └── options.js             # Settings UI
└── scripts/                   # Automation script templates
    ├── 抖音点赞.json
    ├── 批量截图.json
    └── 自动搜索.json

Log Management

• Log Directory: ~/.autoclaw/logs/
• Retention: 30 days (auto-cleanup on server start)
• Max Tasks: 100

Communication Protocol

• MCP service runs on customizable port (default: 30000)
• Browser extension communicates via WebSocket
• Message format: JSON

Troubleshooting

Extension Not Connected

1. Verify MCP server is running
2. Click extension icon → Settings → Test Connection
3. Ensure authorization is not expired

"No Attached Tab" Error

1. Click "Attach All Tabs" in extension popup
2. Or manually click each tab to attach

Authorization Expired

1. Click extension icon → Settings
2. Click "Save Settings" to re-authorize

Performance Issues

• v6.0.0 has optimized resource usage
• Try restarting MCP service if issues persist

Usage Example

// Connect to MCP service
const WebSocket = require('ws');
const ws = new WebSocket('ws://localhost:30000');

ws.on('open', function() {
    // Navigate to webpage
    ws.send(JSON.stringify({
        action: 'navigate',
        url: 'https://www.example.com'
    }));
    
    // Get simplified DOM (recommended)
    ws.send(JSON.stringify({
        name: 'claw_get_indexed_elements',
        arguments: { useCache: true }
    }));
});

Error Handling

• Connection Failure: Check if MCP service is running and port is available
• Extension Not Loaded: Verify manifest.json exists and is properly formatted
• Dependency Errors: Re-run npm install to install dependencies