🚀 OpenClaw-RPA

English | 中文

The “RPA Compiler” for AI Agents.

Record once → Replay as deterministic Python. Stop the “LLM Tax” on repetitive tasks.

---

💡 Why OpenClaw-RPA?

https://github.com/user-attachments/assets/e3ed5b34-1ddb-43a6-af42-2d1a907d3564

Current AI Web、Computer、Workflow Agents are amazing but fundamentally flawed for production:

• The “LLM Tax”: Why pay for tokens every time your agent clicks a “Download” button it has clicked 100 times before?
• Latency: Waiting for an LLM to “reason” through a fixed UI is painfully slow.
• Fragility: High-temperature models can hallucinate and break stable workflows.

OpenClaw-RPA bridges the gap. Use the intelligence of LLMs to discover and record a workflow once, then compile it into a standalone, high-speed Playwright script that runs with ZERO token cost forever.

---

✨ Key Features

• ⚡ Zero-Token Replay: Compile Agent reasoning into pure Python. Save 100% of inference costs on daily repetitive tasks.Like: Instantly replay your recorded sequence in a live browser window.
• 🔑 Session Persistence (#rpa-login): Manually solve 2FA, QR codes, or SMS once. The tool auto-injects cookies into all future headless runs. Bypass login walls forever.
• 🌐 HTTP API Recording: Mix REST GET/POST calls with browser steps in a single, replayable script.
• 📄 Native Office Automation: Build-in excel_write and word_write. No Microsoft Office installation required. Works on macOS, Linux, and Windows without Office; also fits Linux/Docker deployments.
• 🔗 Seamless Integration: Designed as a powerful skill for the OpenClaw ecosystem but generates standard Python/Playwright code.

Platforms (runtime)

macOS, Linux, and Windows — Recording and replay use Python 3, Playwright, and pure-Python libraries (httpx, openpyxl, python-docx); all of them support Windows. Use python / py -3 from PowerShell or Command Prompt the same way you would python3 on Unix. Paths such as ~/Desktop are resolved with Path.expanduser() / os.path.expanduser() (on Windows this maps under your user profile, e.g. Desktop). Automated CI has focused on macOS and Linux; if you hit a Windows-only edge case, open an issue on GitHub.

---

🎥 Show, Don’t Tell

What you can automate

You (plain language)
      │
      ▼
  #RPA / #rpa-api          ← trigger
      │
      ▼
 AI drives real Chrome     ← record-step (screenshot proof every step)
      │
      ▼
 `#end`                     ← synthesize
      │
      ▼
 rpa/.py             ← standalone Playwright Python script
      │
      ▼
 python3 rpa/.py     ← replay — no model, no AI, runs anywhere

Why not just let the AI click the browser every time (Computer Use)?

What openclaw-rpa does instead: use AI to record and verify once, then replay with a local script — no model call, no token burn, no hallucination risk, runs in seconds.

Case videos

1. E-Commerce Demo — browser recording

Sauce Demo (saucedemo.com): sign in → sort by price → add two most expensive → sign out.
Shows the full flow from trigger through recording to a generated script.

https://github.com/user-attachments/assets/965fbecc-a0fc-4795-9f63-a5ef126f97f8

Recording (saucedemo-readme.mp4) — steps in the video

1. Send #rpa / #RPA / #automation robot — see SKILL.md and SKILL.en-US.md — Trigger detection.
2. Task name examples: match an existing script like onlineShoppingV1 (see registry.json).

Task prompt (Sauce segment)

1. Open www.saucedemo.com, sign in standard_user / secret_sauce.
2. Sort price high → low.
3. Add the two most expensive items to the cart.
4. Log out.

Real-world variant — Amazon Best Sellers data extraction (rpa/amazonbestseller.py)

Same flow on a live production site: scrape the first 40 products (title, price, rating, review count, URL) from Amazon search results and append a timestamped Word table to the Desktop. The data_groups DOM analysis layer auto-detects product card containers and field selectors from the real page — no hardcoded selectors, no guessing.

📖 Full tutorial →

2. Yahoo Finance (NVDA news) — browser recording

Yahoo Finance (finance.yahoo.com): search a symbol → open the quote page → switch to the News tab → capture the top headlines to a text file on the Desktop. This case shows the same end-to-end path as the Sauce demo—trigger, record, synthesize a Playwright script—for a finance/news workflow.

https://github.com/user-attachments/assets/8da98e97-415c-4a60-b412-9a30ea87551a

Recording — steps in the video

1. Send #rpa / #RPA / #automation robot — see SKILL.md and SKILL.en-US.md — Trigger detection.
2. Task name example: align with a registered script such as YahooNew (see registry.json → yahoonew.py).

Task prompt (Yahoo Finance segment)

1. Open https://finance.yahoo.com/, search for NVDA, and go to the quote page (e.g. https://finance.yahoo.com/quote/NVDA/).
2. In the row of tabs under the stock price (same row as Summary), click News for this symbol—the tab next to Summary. Wait until the news list has loaded.
3. Save the top 5 news headlines (title text only) to YahooNews.txt on the Desktop.

3. Quotes API + news page + local brief (browser + API + file)

Yahoo Finance (browser) + market data (HTTP API): save daily price data for a stock to the Desktop → open the symbol page → switch to News → save headline titles to a text file. This flow adds a data API step on top of normal browsing. How to wire URLs, keys, and record-step JSON is in API notes below (full api_call section).

Recording — steps in the video

1. Send #rpa-api — dedicated trigger for flows with HTTP API calls (see SKILL.en-US.md — Trigger detection).
2. Task name example: align with registry.json or create a new name such as NVDABrief.

Task prompt (quotes + news + local brief)

#rpa-api
###
Fetch NVDA daily OHLCV and save to the Desktop as nvda_time_series_daily.json
API docs  https://www.alphavantage.co/documentation/#daily
API key   UXZ3BOXOH817CQWS
###
Open Sina Finance https://finance.sina.com.cn/, search for NVDA, wait for the new page,
click "Company News" in the left menu, wait for the new page, save the top 5 news headlines to nvda_news.txt on the Desktop.
Merge nvda_time_series_daily.json and nvda_news.txt into a single brief file called nvda.txt.

Or paste the API doc parameter block directly:

#rpa-api
###
API Parameters
❚ Required: function → TIME_SERIES_DAILY
❚ Required: symbol   → NVDA
❚ Required: apikey
Example: https://www.alphavantage.co/query?function=TIME_SERIES_DAILY&symbol=IBM&apikey=demo
apikey  UXZ3BOXOH817CQWS
###
Open Sina Finance https://finance.sina.com.cn/, search for NVDA, click "Company News" on the left, save the top 5 headlines to nvda_news.txt on the Desktop.
Merge nvda_time_series_daily.json and nvda_news.txt into nvda.txt.

4. Airbnb Competitor Price Tracker (Browser + Vision + Word) 🆕

[!TIP] Featured case — Real Computer-Use agent in production. Zero-code RPA robot: open browser → visual recognition → extract prices & ratings → append to a Word report. Airbnb is a heavily dynamic SPA; traditional crawlers fail here. This case introduces vision mode — the AI reads the screen like a human, powered by Qwen3-VL (Alibaba open-source, ultra-low token cost, local-deploy friendly). Record once → auto-generate a Python script → all future runs execute the script directly: zero Token cost, zero hallucinations, deterministic results.

📖 Full step-by-step tutorial (EN) → · 中文 →

5. OpenClaw + Feishu/Lark: #rpa-list, #rpa-run, and scheduled run

Screen recording of a typical chat with OpenClaw-bot on Feishu/Lark:

• #rpa-list — list registered RPA tasks you can run;
• #rpa-run:onlineShoppingV1 — run a saved script from a new chat;
• A line like 「One minute later run #rpa-run:onlineShoppingV1」 — schedule or remind to run later via OpenClaw + IM (exact behavior depends on your setup; execution still goes through rpa_manager.py run).

https://github.com/user-attachments/assets/08ccbdc6-508b-457a-87d6-49ac77e9a89e

6. Auto-login (Cookie reuse) — record post-login pages without re-entering credentials

Scenario: Sites like e-commerce platforms that require SMS OTP, CAPTCHA sliders, or QR-code login. Log in once manually, save the session, and every subsequent recording or replay injects the cookies automatically — skipping the login flow entirely.

Case: Sauce Demo — sort products by price high → low

👉 Full tutorial: articles/autologin-tutorial.en-US.md

Command quick reference:

#rpa-login        Open browser; you log in manually (password / OTP / slider)
#rpa-login-done                   Export cookies and close browser
#rpa-autologin     Inject saved cookies on record or replay
#rpa-autologin-list               List all saved login sessions

---

7. AP reconciliation — GET API + local Excel + Word tables

Finance / AP: mock GET pulls open payables lines; no ERP submit/close; match against a local invoice workbook; save a Word (.docx) report with tables.

• Full write-up (EN): articles/scenario-ap-reconciliation.en-US.md
• Full write-up (中文): articles/scenario-ap-reconciliation.md
• Recording: #rpa-api or #RPA; capability F (Excel + Word) or G if a browser is needed; api_call + excel_write; add docx tables in a small post-record-end patch if needed (see article).

Full protocol: SKILL.en-US.md (ONBOARDING, RECORDING). See what recorded RPAs exist: #rpa-list. Run one: #rpa-run:{task} (new chat) or run:{task} / python3 rpa_manager.py run (same chat).

---

With AI assistance, record typical website and local file workflows into a repeatable Playwright Python script. Replay without the LLM on every run—saves compute and keeps steps deterministic (vs. ad-hoc model calls).

---

Quick install (OpenClaw)

Option 1 — OpenClaw CLI (recommended):

openclaw skills install openclaw-rpa

Option 2 — Manual (git clone):

Put the skill here: ~/.openclaw/workspace/skills/openclaw-rpa

mkdir -p ~/.openclaw/workspace/skills
git clone https://github.com/laziobird/openclaw-rpa.git ~/.openclaw/workspace/skills/openclaw-rpa
cd ~/.openclaw/workspace/skills/openclaw-rpa

chmod +x scripts/install.sh && ./scripts/install.sh
python3 scripts/bootstrap_config.py
python3 scripts/set_locale.py zh-CN    # or: en-US

python3 rpa_manager.py env-check

If your flow uses Excel / Word (capability B–G in SKILL.en-US.md / SKILL.zh-CN.md), use the same python3 for e.g. python3 rpa_manager.py deps-check D; the skill guides deps-install in chat when something is missing.

SSH clone: [email protected]:laziobird/openclaw-rpa.git

After install, start a new OpenClaw chat (or reload skills) so the agent reads SKILL.md.

Triggers — pick one to start:

#RPA                   # browser-only flow
#rpa-api               # flow that includes an HTTP API call
#rpa-login        # save a login session (cookies)
#rpa-list              # list all recorded tasks
#rpa-run:   # replay a recorded task

Full protocol and capability codes (A–G): SKILL.en-US.md.

---

Advanced

Manual install, gateway Python, locale config, paths, and publishing: articles/advanced-setup.md

---

CLI quick start

python3 rpa_manager.py env-check
python3 rpa_manager.py list
python3 rpa_manager.py run wikipedia

Recorder: record-start → record-step → record-end (see rpa_manager.py docstring).

---

Sample scripts (rpa/)

All scripts below are registered in registry.json and can be listed with #rpa-list or run with #rpa-run: / python3 rpa_manager.py run .

---

API recording (api_call)

The recorder supports api_call steps (GET/POST via httpx, response optionally saved to Desktop).

Full guide — key embedding strategy, env field, examples: articles/api-call-guide.md

---

Caveats

• Compliance: Follow each site’s terms of service and policies. This repo does not endorse evading safeguards or scraping where it isn’t allowed.
• High-friction sites (e.g. LinkedIn): Even with auto sign-in or session reuse, you may still hit 2FA, device checks, CAPTCHAs, and risk blocks that require human steps.

---

Author Contact

Contact (open-source questions or commercial inquiries):

• WeChat: nizhanali
• Gmail: [email protected]

---

Apache License 2.0 · Copyright © 2026 openclaw-rpa contributors