webclaw-oss

webclaw-oss

Deterministic browser RPA driven by natural-language recipes (Chinese first).

This repository is the open-source fork of webclaw for the DeepSeek Harness community (dsh-plugin topic).

Core

Piece	Role
runtime/	Rust webclaw-lite CLI — parse Chinese recipes, drive local Chrome via CDP, HITL for captcha/slider
packages/webclaw/	npm @lonk1989/webclaw — Host tools + Skill that spawn lite

Same recipe → same business path. Prefer fixing the recipe over inventing CSS selectors.

Non-goals (v1)

• Not a Playwright / Stagehand / element-tool MCP
• Does not register exclusive ctx.browserUse
• No enterprise corp-session skill cloud
• Desktop Tauri UI is not part of the OSS v1 publish surface
• English recipe keywords are planned later

Quick start

1. Install the DSH plugin (recommended)

dsh plugin --profile web add @lonk1989/webclaw

On Windows and macOS (Apple Silicon), the plugin auto-downloads webclaw-lite from GitHub Releases on first boot / tool call (SHA256 verified → %LOCALAPPDATA%\webclaw\bin\webclaw-lite.exe or ~/.webclaw/bin/webclaw-lite). No separate hand install. If macOS Gatekeeper blocks the binary: xattr -d com.apple.quarantine ~/.webclaw/bin/webclaw-lite.

Mount with an insert: patch (a bare - id: only updates an existing row):

- insert:
    - id: webclaw
      name: '@lonk1989/webclaw'
      config:
        registerSkill: true
        recipesRel: recipes

pnpm dsh web --patch examples/cordis.patch.yml

Ask the agent to run a recipe such as:

打开https://example.com，等待2，采集

When you paste a full multi-step recipe, the agent should call one webclaw_run with the entire body (not probe step-by-step).

Accounts / SSO: put the real login URL in DSH 设置 → 网站账号 (Feishu SSO e.g. …/login?sso=lark&… — password optional). Never put passwords in chat. Recipes say 登录EHR系统, never 输入密码=…. Prefab 参数…= are placeholders—confirm or「用默认」; if the user already gave fields, just run. Private forks seed URLs via config.systems (see packages/webclaw/README.md).

2. Local dev (optional)

Build lite from source when hacking the Rust CLI:

cd runtime
cargo build --release --bin webclaw-lite
# then set config.binaryPath to ../target/release/webclaw-lite.exe

Plugin package:

cd packages/webclaw
npm install
npm run build

See examples/cordis.patch.yml and packages/webclaw/cordis.patch.yml.

vs official browser-use

	Playwright / CDP MCP	webclaw
Abstraction	Element / snapshot tools	Fixed Chinese recipe
Targeting	CSS / a11y	Visible text
HITL	DIY	Built-in need_human
Window	Often headless	Visible Chrome by default

Layout

runtime/                 # Rust crate (lite-first, desktop feature opt-in)
packages/webclaw/        # @lonk1989/webclaw
examples/                # sample recipes + cordis overlay
skills/webclaw-lite/     # CLI Skill docs (source of truth also copied into plugin assets)

License

MIT. Forked from the former vision-coord-client / webclaw product tree; tenant-specific defaults (CDN, corp auth, Feishu) were removed for OSS.