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

claw_get_indexed_elements

[useCache: boolean]

Index Click

claw_click_by_index

index: number

Batch Operations

claw_batch_execute

commands: array

Smart Wait

claw_smart_wait

element/text/urlPattern, timeout

Available Tools

⌨️ Keyboard Operations

claw_press_key

key: string

claw_press_combo

keys: string

claw_type_text

text: string, [delay: number]

claw_key_down

key: string

claw_key_up

key: string

📸 Screenshot & Content Extraction

claw_take_screenshot

[fullPage: boolean]

claw_get_page_content

[type: html|text]

claw_get_text

selector: string

claw_get_html

selector: string

claw_get_attribute

selector, attribute

claw_is_visible

selector: string

claw_is_enabled

selector: string

🖱️ Mouse & Scroll Operations

claw_mouse_move

x, y

claw_mouse_click

[x, y]

claw_mouse_right_click

[x, y]

claw_mouse_double_click

[x, y]

claw_mouse_down

button, x, y

claw_mouse_up

[button]

claw_mouse_wheel

[deltaX, deltaY]

claw_scroll

[x, y]

claw_fast_scroll_down

[speed: number]

claw_fast_scroll_up

[speed: number]

claw_hover_element

selector: string

claw_scroll_to_element

selector: string

📱 Touch & Swipe Operations (Mobile)

claw_swipe_up

[distance: number]

claw_swipe_down

[distance: number]

claw_swipe_left

[distance: number]

claw_swipe_right

[distance: number]

claw_tap

x, y

📑 Tab Management

claw_tab_create

[url, active]

claw_tab_close

[tabId]

claw_tab_list

claw_tab_switch

tabId: number

claw_tab_reload

[tabId]

claw_get_active_tab

claw_attach_all_tabs

📁 Bookmark Management

claw_get_bookmarks

claw_get_bookmark_tree

claw_search_bookmarks

query: string

claw_create_bookmark

title, url, [parentId]

claw_update_bookmark

id, [title, url]

claw_rename_bookmark

id, title

claw_delete_bookmark

id: string

claw_remove_folder

id: string

claw_create_folder

title, [parentId]

claw_move_bookmark

id, parentId

🍪 Storage & Cookies

claw_get_cookies

[domain: string]

claw_set_cookies

cookies: array

claw_get_storage

[type, origin]

claw_set_storage

type, key, value

🧪 JavaScript Execution

claw_evaluate_js

expression: string

⏳ Wait Operations

claw_wait

ms: number

claw_wait_for_element

selector, [timeout]

claw_wait_for_text

text, [timeout]

claw_wait_for_url

urlPattern, [timeout]

claw_wait_for_navigation

[timeout]

claw_smart_wait

element/text/urlPattern, timeout

🔧 Element Operations

claw_click_element

selector: string

claw_fill_input

selector, text

claw_clear_input

selector: string

claw_select_option

selector, value

claw_check

selector: string

claw_uncheck

selector: string

claw_focus_element

selector: string

claw_upload_file

selector, filePath

🧠 Smart Operations (Enhanced)

claw_smart_click

selector/text/x+y, timeout

claw_find_elements

selector, [limit]

claw_wait_and_click

selector, timeout, scrollIntoView

claw_get_page_structure

includeLinks/Buttons/Inputs, maxItems

claw_batch_extract

selectors, options

claw_extract_table

[selector, includeHeader]

claw_extract_list

containerSelector, fields, limit

📊 Task & Log Operations

claw_new_task

[name: string]

claw_complete_task

[success: boolean]

claw_switch_task

taskId: number

claw_list_tasks

claw_get_task_logs

[taskId, limit]

claw_get_action_logs

[limit]

⚙️ Configuration & Status

claw_get_status

claw_get_config

claw_set_mode

mode: local|cloud|auto

claw_health_check

claw_diagnose

[full: boolean]

🌐 Navigation Operations

claw_navigate

url, [newTab]

claw_open_urls

urls, [delayMs]

claw_go_back

claw_go_forward

claw_reload_page

[hard: boolean]

💾 Login Session Management

claw_save_login_session

name, [domain]

claw_restore_login_session

name: string

claw_list_login_sessions

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