openclaw-rpa — ロケールルーター（最初にお読みください）

GitHub: https://github.com/laziobird/openclaw-rpa — ソースコード、README、インストール、rpa/ 配下のサンプルスクリプト。

このスキルが行うこと

openclaw-rpa は LLMベースのRPAエージェントフレームワーク です。タスクをプレーンテキストで説明するだけで、AIが 実際のブラウザ、あなたのコンピュータ、またはAPIサービス経由で ステップバイステップで実行し、各ステップでスクリーンショット証拠を記録してから、すべてを スタンドアロンのPlaywright Pythonスクリプト にコンパイルします。リプレイ実行ではそのスクリプトを直接実行します — モデル呼び出しなし、トークン消費なし、ハルシネーション（幻想）リスクなし — AIに毎回クリックさせるより高速で安価です。

なぜこれが重要か

1. 計算コストと費用を節約 — 大規模モデル に 毎回 ブラウザを操作させると、重いセッションごとに 米ドルの1桁から10桁 のコスト（トークン、ツール、長いコンテキスト）がかかる可能性があります。1回記録すれば、繰り返し作業は モデルを呼び出しません — リプレイは はるかに高速 で、これらのステップのLLMコストは ほぼゼロ です。
2. 1回検証して、毎回同じ方法で実行 — 記録中に フローが機能することを確認 してから、リプレイで 保存されたステップを決定論的に実行 します。毎回実行するたびにAIに「もう一度やって」と求めることを避け、これは 一貫性を損ない ハルシネーションリスクを高めます。

自動化できる内容 （1回記録、何度もリプレイ — 各サイトの利用規約とローカル法を遵守してください）:

カテゴリ	例
ブラウザ	ログイン、ナビゲーション、クリック、フォーム入力、テキスト抽出、テーブルのソート/フィルタリング
HTTP API	任意のRESTエンドポイントへの GET / POST、JSONの保存、スクリプトへの APIキー直接埋め込み（#rpa-api）
Excel (.xlsx)	ワークブックの作成/更新、複数シート、ヘッダー、ペイン固定、JSONまたは別ファイルからの動的行
Word (.docx)	段落とテーブル付きのレポート生成 — Microsoft Office不要
自動ログイン	#rpa-login でクッキーを1回保存、記録とリプレイのたびに自動注入 — OTP / CAPTCHA / QRコードフローをスキップ
混合フロー	1つの記録されたタスク内での上記の任意の組み合わせ（例：API + Excel + Word、またはブラウザ + ログイン + 抽出）

---

🚀 実際のユースケース — すでに記録済み、実行可能

これらのスクリプトは registry.json に登録されています。再記録やトークン消費なしで、即座に実行できます。

#rpa-list                          ← 登録済みタスク一覧を表示
#rpa-run:amazonbestseller          ← 1つを直接実行
python3 rpa_manager.py run <name>  ← またはCLIで実行

#	ケース	内容	実行名
🛒	Amazon Best Sellers Scraper	トップ40商品（タイトル、価格、評価、レビュー、URL）をスクレイピング → Wordテーブル	amazonbestseller
🏨	Airbnb Competitor Price Tracker	ブラウザを開く → ビジョン認識 → 価格と評価を抽出 → Wordレポート	airbnb民宿比价分析v11
🏦	AP Reconciliation (EN)	Mock GET未決済科目 → Excelマッチング → Wordテーブルレポート	reconciliationV2
🔑	Auto-login: Ctrip Hotel	クッキーを1回保存 → 以降OTPをスキップ → ホテル情報を抽出 → Wordドキュメント	携程酒店V3
📈	Yahoo Finance News	NVDA を検索 → ニュースタブ → トップ5ヘッドラインをデスクトップに保存	YahooNew
🎬	Douban Movie	映画を検索 → 詳細ページ → タイトル、評価、あらすじ → デスクトップファイル	获取豆瓣电影数据
🌐	Alpha Vantage API	NVDA の TIME_SERIES_DAILY → nvda_time_series_daily.json（ブラウザなし）	apiV3
🛍️	Sauce Demo Shopping	サインイン → 価格でソート → 最も高い2つを追加 → ログアウト	onlineShoppingV1

📖 全ケースギャラリーと動画 → README.md

---

使用時機

やりたいこと	送信内容
新しいフローの記録を開始	#automation robot、#RPA、#rpa、または Playwright automation について言及
保存されたタスクを確認 実行可能なもの	#rpa-list
保存されたタスクを実行（例：新しいチャット）	#rpa-run:{タスク名}
このチャットで実行	run:{タスク名}（zh-CN: #run:{タスク名})

クイックスタート（インストール後）

#rpa-list
#rpa-run:your-task-name

フルプロトコル、ステートマシン、2行のサインアップ（タスク名 + 機能 A–G/N）、deps-check / deps-install、record-step JSON、段階的調査、および セレクタの強度（複合CSS — コンテナ + タグ/属性/:has(); 単純な h3 は避ける）は以下のロケールファイルに記載されています。

出力

生成されたファイルは 通常のPython（rpa/*.py） — python3 でスタンドアロン実行可能、編集可能、リプレイ時にOpenClawの依存関係なし。

スコープ

ブラウザ — goto、click、fill、select_option、scroll、wait、snapshot、extract_text、dom_inspect。
HTTP API — api_call（httpx GET/POST、キー埋め込み、save_response_to）; ブラウザページから独立。
ローカルファイル — merge_files（デスクトップファイルを連結）; extract_text はディスクに書き込み; 記録後、フォルダ/ファイル操作については rpa/*.py にパッチを適用。
Excel / Word — excel_write（openpyxl、複数シート、JSONまたは別ファイルからの動的行）; word_write（python-docx、段落 + テーブル）; Microsoftアプリは不要。
計算ロジック — python_snippet は任意のPythonを生成スクリプトに注入; 記録時に実行および検証。
スコープ外 — 大規模ETL、データベース、重いOS自動化。

推奨サイト

適合性が高い — 予測可能な構造、そのままで良好に動作:

カテゴリ	例
金融/データ	Yahoo Finance、investing.com
Eコマース	Sauce Demo（saucedemo.com）、AliExpress、eBay
ニュース/メディア	BBC News、Reuters、Hacker News、Redditリストページ
リファレンス	Wikipedia、GitHubパブリックリポジトリ/イシュページ

非推奨 — 破損または手動介入の可能性が高い:

状況	理由	回避策
ログインゲートされたフロー（パスワード / SMS OTP / スライダー / QRコード）	認証情報と2FAは手動で処理する必要があります	#rpa-login を使用して手動でログイン → クッキーが自動保存 → #rpa-autologin が今後の記録とリプレイのたびにそれらを注入、ログインフロー全体をスキップ

ヒント: 新しいサイトでは、フル フローを構築する前に goto + snapshot で開始してページ構造が読み取り可能であることを確認してください。

必須: 正しいインストラクションファイルを読み込む

1. このスキルディレクトリ内の config.json を読み込みます。存在しない場合は、config.example.json を読み込みます（同じ構造; デフォルト locale は en-US）。

2. "locale" フィールドを読み込みます。許可される値: zh-CN と en-US（リポジトリデフォルトは config.example.json: en-US）。

3. すぐに読み込みツールを使用 して、完全な スキルボディを読み込みます:

   • zh-CN → SKILL.zh-CN.md
   • en-US → SKILL.en-US.md

4. そのファイルのみに従い、ステートマシン、トリガー、record-step JSON、オンボーディングテキスト、およびユーザー向け返答に使用。

5. アクティブロケールの言語でユーザーに返答:

   • zh-CN → エージェントメッセージは簡体字中国語（ユーザーはまだ英語で入力可能）。
   • en-US → エージェントメッセージは英語（ユーザーはまだ中国語で入力可能）。

言語の変更

• 必要に応じて config.example.json → config.json をコピー（python3 scripts/bootstrap_config.py）してから "locale" を編集、または
• 実行: python3 scripts/set_locale.py en-US / python3 scripts/set_locale.py zh-CN（欠けている場合、サンプルから config.json を作成）。

ロケール変更後、エージェントは新しいターンまたはセッションで一致する SKILL.*.md を 再読み込み する必要があります。このディレクトリの README.md を参照して、完全なワークフローを確認してください。

ClawHub / ディスカバリー

• SKILL.md（このファイル）: 短いルーター + 使用時機 + ClawHub のようなリスティング向け クイックスタート。
• SKILL.zh-CN.md / SKILL.en-US.md: フル オンボーディング、記録、RUN/LIST、およびタイムアウト防止ルール。
• シナリオドキュメント: Amazon Best Sellers · Airbnb Price Tracker · AP Reconciliation EN · AP Reconciliation CN · Auto-login。

相対パス

読み込みファイルが playwright-templates.md、synthesis-prompt.md、または rpa_manager.py を参照する場合、パスを このスキルディレクトリに相対的に解決 します（SKILL.md の親）。