OpenClaw Skill

Autoclaw Browser

Install

$npx clawhub@latest install autoclaw-browser
View on GitHubv6.1.2
All-time installs5
Active installs5
Stars0

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

ToolDescriptionParameters
claw_get_indexed_elementsGet page simplified DOM (indexed interactive elements), data reduced by 90%+[useCache: boolean]

Index Click

ToolDescriptionParameters
claw_click_by_indexClick element by index, more stable than CSS selectorindex: number

Batch Operations

ToolDescriptionParameters
claw_batch_executeBatch execute multiple CDP commands, reduce network round tripscommands: array

Smart Wait

ToolDescriptionParameters
claw_smart_waitSmart wait: support wait for element/text/URLelement/text/urlPattern, timeout

Available Tools

⌨️ Keyboard Operations

ToolDescriptionParameters
claw_press_keyPress single keykey: string
claw_press_comboPress key combination (e.g., Ctrl+C)keys: string
claw_type_textType text with optional delaytext: string, [delay: number]
claw_key_downKey downkey: string
claw_key_upKey upkey: string

πŸ“Έ Screenshot & Content Extraction

ToolDescriptionParameters
claw_take_screenshotCapture screenshot of current page[fullPage: boolean]
claw_get_page_contentGet page HTML or text content[type: html|text]
claw_get_textGet text content of elementselector: string
claw_get_htmlGet HTML content of elementselector: string
claw_get_attributeGet element attribute valueselector, attribute
claw_is_visibleCheck if element is visibleselector: string
claw_is_enabledCheck if element is enabledselector: string

πŸ–±οΈ Mouse & Scroll Operations

ToolDescriptionParameters
claw_mouse_moveMove mouse to coordinatesx, y
claw_mouse_clickLeft click at coordinates[x, y]
claw_mouse_right_clickRight click at coordinates[x, y]
claw_mouse_double_clickDouble click at coordinates[x, y]
claw_mouse_downMouse button downbutton, x, y
claw_mouse_upMouse button up[button]
claw_mouse_wheelMouse wheel scroll[deltaX, deltaY]
claw_scrollScroll page[x, y]
claw_fast_scroll_downFast scroll down one screen[speed: number]
claw_fast_scroll_upFast scroll up one screen[speed: number]
claw_hover_elementHover over elementselector: string
claw_scroll_to_elementScroll element to viewport centerselector: string

πŸ“± Touch & Swipe Operations (Mobile)

ToolDescriptionParameters
claw_swipe_upSwipe up gesture (Douyin/TikTok)[distance: number]
claw_swipe_downSwipe down gesture[distance: number]
claw_swipe_leftSwipe left gesture[distance: number]
claw_swipe_rightSwipe right gesture[distance: number]
claw_tapTap at specific positionx, y

πŸ“‘ Tab Management

ToolDescriptionParameters
claw_tab_createCreate new browser tab[url, active]
claw_tab_closeClose browser tab[tabId]
claw_tab_listList all open tabs-
claw_tab_switchSwitch to specific tabtabId: number
claw_tab_reloadReload tab content[tabId]
claw_get_active_tabGet active tab information-
claw_attach_all_tabsAttach all tabs for control-

πŸ“ Bookmark Management

ToolDescriptionParameters
claw_get_bookmarksGet all bookmarks (flat list)-
claw_get_bookmark_treeGet full bookmark tree structure-
claw_search_bookmarksSearch bookmarks by keywordquery: string
claw_create_bookmarkCreate new bookmarktitle, url, [parentId]
claw_update_bookmarkUpdate bookmark title or URLid, [title, url]
claw_rename_bookmarkRename bookmark or folderid, title
claw_delete_bookmarkDelete single bookmarkid: string
claw_remove_folderRecursively delete bookmark folderid: string
claw_create_folderCreate new bookmark foldertitle, [parentId]
claw_move_bookmarkMove bookmark to another folderid, parentId

πŸͺ Storage & Cookies

ToolDescriptionParameters
claw_get_cookiesGet cookies for domain[domain: string]
claw_set_cookiesSet cookiescookies: array
claw_get_storageGet localStorage/sessionStorage[type, origin]
claw_set_storageSet storage valuetype, key, value

πŸ§ͺ JavaScript Execution

ToolDescriptionParameters
claw_evaluate_jsExecute JavaScript code in pageexpression: string

⏳ Wait Operations

ToolDescriptionParameters
claw_waitWait specified millisecondsms: number
claw_wait_for_elementWait for element to appearselector, [timeout]
claw_wait_for_textWait for text to appeartext, [timeout]
claw_wait_for_urlWait for URL pattern matchurlPattern, [timeout]
claw_wait_for_navigationWait for navigation completion[timeout]
claw_smart_waitSmart wait (NEW)element/text/urlPattern, timeout

πŸ”§ Element Operations

ToolDescriptionParameters
claw_click_elementClick page element (CSS selector)selector: string
claw_fill_inputFill input field with textselector, text
claw_clear_inputClear input fieldselector: string
claw_select_optionSelect dropdown optionselector, value
claw_checkCheck checkboxselector: string
claw_uncheckUncheck checkboxselector: string
claw_focus_elementFocus on elementselector: string
claw_upload_fileUpload file to inputselector, filePath

🧠 Smart Operations (Enhanced)

ToolDescriptionParameters
claw_smart_clickSmart click: try selector→text→coordinatesselector/text/x+y, timeout
claw_find_elementsQuery all matching elements on pageselector, [limit]
claw_wait_and_clickWait for element then clickselector, timeout, scrollIntoView
claw_get_page_structureGet page key structure summaryincludeLinks/Buttons/Inputs, maxItems
claw_batch_extractBatch extract multiple selector contentsselectors, options
claw_extract_tableExtract HTML table to JSON[selector, includeHeader]
claw_extract_listExtract list-type datacontainerSelector, fields, limit

πŸ“Š Task & Log Operations

ToolDescriptionParameters
claw_new_taskCreate new task[name: string]
claw_complete_taskComplete task[success: boolean]
claw_switch_taskSwitch to specified tasktaskId: number
claw_list_tasksList all tasks-
claw_get_task_logsGet specified task logs[taskId, limit]
claw_get_action_logsGet current task action logs[limit]

βš™οΈ Configuration & Status

ToolDescriptionParameters
claw_get_statusGet current system status-
claw_get_configGet full configuration-
claw_set_modeSet operation modemode: local|cloud|auto
claw_health_checkPerform health check-
claw_diagnoseSystem diagnostics[full: boolean]

🌐 Navigation Operations

ToolDescriptionParameters
claw_navigateOpen URLurl, [newTab]
claw_open_urlsBatch open multiple URLsurls, [delayMs]
claw_go_backGo back one page-
claw_go_forwardGo forward one page-
claw_reload_pageReload page[hard: boolean]

πŸ’Ύ Login Session Management

ToolDescriptionParameters
claw_save_login_sessionSave current page login statename, [domain]
claw_restore_login_sessionRestore saved login statename: string
claw_list_login_sessionsList all saved 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

bash
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

OptimizationBeforeAfterEffect
CDP DomainEnable all 4 domains each timeEnable only 2 base domains, others on-demandResource ↓30%
Connection PollCheck every 5 secondsCheck every 30 secondsCPU/Network ↓40%
Popup PollRefresh every 3 secondsRefresh every 10 secondsBattery/Resource ↓
DOM CacheNoneReuse within 15 secondsRepeat requests ↓50%

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

js
// 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

Created by

@addogiavara-tech
View on ClawHub

Persistent memory

Give your OpenClaw agent a memory layer

Mem0 remembers users and context across sessions so you send fewer tokens and get better answers.

Try Mem0Mem0 + OpenClaw guide