🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί browser-file-upload
πŸ¦€ ClawHub

browser-file-upload

by @weixizi

Automates uploading files to web pages via agent-browser CLI, supporting flexible path formats and interactions with file input elements or dialogs.

Versionv1.0.0
Downloads743
#legal#automation
TERMINAL
clawhub install browser-file-upload

πŸ“– About This Skill

name: browser-file-upload description: Browser automation skill for uploading files to web pages with flexible path specification. Use when Codex needs to: (1) Upload files to web forms, (2) Automate file selection dialogs, (3) Interact with file input elements via agent-browser CLI. Supports absolute paths, relative paths, environment variables, and workspace-relative paths.

Browser File Upload

Automates file uploads to web pages using agent-browser CLI.

Quick Start

Upload a file to a web page:

# Basic upload (auto-detects file input)
agent-browser open 
agent-browser find text 选择文仢 click
agent-browser upload "#filePicker" 
Or use the Python script

python scripts/upload_file.py

Usage Patterns

Upload to Specific Selector

When you know the file input selector:

agent-browser open https://example.com/upload
agent-browser click "#fileInput"
agent-browser upload "#fileInput" C:\path\to\file.xlsx

Upload by Text Search

When file input has visible label text:

agent-browser open https://example.com/upload
agent-browser find text "δΈŠδΌ ζ–‡δ»Ά" click
agent-browser upload "[type=file]" C:\path\to\file.xlsx

Using Python Script

For reusable upload logic with flexible path specification:

python scripts/upload_file.py   [selector] [wait_ms]

Arguments:

  • url - Target page URL
  • file-path - Path to file (supports multiple formats, see below)
  • selector - Optional CSS selector for file input
  • wait_ms - Optional wait time after page load (default: 2000)

    • File Path Formats

    The Python script supports multiple path formats:

    | Format | Example | Description | |--------|---------|-------------| | Absolute | C:\Users\name\file.xlsx | Full path | | Relative | ./data/file.xlsx | Relative to current directory | | Workspace | workspace/file.xlsx | Relative to OPENCLAW_WORKSPACE | | Env Var | ${HOME}/file.xlsx | Environment variable | | Windows Env | %USERPROFILE%\file.xlsx | Windows environment variable |

    Path Examples

    # Absolute path
python scripts/upload_file.py https://example.com C:\Users\ι™ˆ\Documents\data.xlsx
    Relative path (from workspace)
    
python scripts/upload_file.py https://example.com ./test.xlsx
    Workspace-relative
    
python scripts/upload_file.py https://example.com workspace/data/test.xlsx
    With environment variable
    
python scripts/upload_file.py https://example.com ${HOME}/downloads/file.xlsx

    Common Selectors

    | Selector | Description | |----------|-------------| | #filePicker | Common id for file inputs | | [type=file] | Any file input element | | input[type=file] | Explicit file input | | .upload-zone | Drop zone containers |

    Troubleshooting

    File input not found:

  • Run agent-browser snapshot to inspect page elements
  • Look for [type=file] or file-related buttons
  • Try clicking the upload zone first

    • Upload fails:

  • Ensure file path is absolute
  • Check file exists: test-path
  • Try agent-browser find text 选择文仢 click first

    • Page not loaded:

  • Add agent-browser wait 2000 after open
  • Use agent-browser wait --load networkidle for slow pages

    • Related Commands

    # Inspect page elements
agent-browser snapshot
    Take screenshot
    
agent-browser screenshot
    Find elements by text
    
agent-browser find text "上传"
    Click element
    
agent-browser click 
    Upload file
    
agent-browser upload

    Example: Upload Excel to UU Tool

    # Method 1: Direct agent-browser commands
agent-browser open https://uutool.cn/excel/
agent-browser wait 2000
agent-browser find text 选择文仢 click
agent-browser upload "#filePicker" C:\Users\ι™ˆ\.openclaw\workspace\test.xlsx
    Method 2: Using Python script with absolute path
    
python scripts/upload_file.py https://uutool.cn/excel/ C:\Users\ι™ˆ\.openclaw\workspace\test.xlsx
    Method 3: Using Python script with workspace-relative path
    
python scripts/upload_file.py https://uutool.cn/excel/ workspace/test.xlsx
    Method 4: Using Python script with custom selector and wait time
    
python scripts/upload_file.py https://uutool.cn/excel/ workspace/test.xlsx "#filePicker" 3000

    πŸ’‘ Examples

    Upload a file to a web page:

    # Basic upload (auto-detects file input)
agent-browser open 
agent-browser find text 选择文仢 click
agent-browser upload "#filePicker" 
    Or use the Python script
    
python scripts/upload_file.py

    πŸ“‹ Tips & Best Practices

    File input not found:

  • Run agent-browser snapshot to inspect page elements
  • Look for [type=file] or file-related buttons
  • Try clicking the upload zone first

    • Upload fails:

  • Ensure file path is absolute
  • Check file exists: test-path
  • Try agent-browser find text 选择文仢 click first

    • Page not loaded:

  • Add agent-browser wait 2000 after open
  • Use agent-browser wait --load networkidle for slow pages