From 35afab85ad2bb412c98fc2849aaab44a8330fd48 Mon Sep 17 00:00:00 2001 From: codes-res-by-bigbrother666sh Date: Sun, 15 Mar 2026 17:51:38 +0800 Subject: [PATCH 1/5] docs: sync i18n READMEs with latest Chinese version - Add video embed and remove outdated 'demo coming soon' sentence - Rename section heading to 'What do you gain by installing wiseflow?' - Feature 1: add 'no browser extensions' subtitle + Patchright research note - Feature 2/3: add 'Mechanism' / 'Skill' suffix to headings - Add Feature 4: New Media Editor Crew (preset AI Agent) - Add model API cost note in Quick Start - Update directory structure: add 003-act-field-validation.patch and crew/ - Update contact section: new WeChat image + paid knowledge base info - Add Wenyan to open-source dependencies --- README_AR.md | 83 +++++++++++++++++++++++++++++++++++-------------- README_DE.md | 79 ++++++++++++++++++++++++++++++++++------------- README_EN.md | 81 +++++++++++++++++++++++++++++++++++------------- README_FR.md | 79 ++++++++++++++++++++++++++++++++++------------- README_JP.md | 87 +++++++++++++++++++++++++++++++++++++--------------- README_KR.md | 85 +++++++++++++++++++++++++++++++++++--------------- 6 files changed, 358 insertions(+), 136 deletions(-) diff --git a/README_AR.md b/README_AR.md index 230aa3a2..9f639ca3 100644 --- a/README_AR.md +++ b/README_AR.md @@ -22,23 +22,25 @@ ومع ذلك، أظهر لنا التقدم السريع في تقنية الوكلاء (Agents) خلال العام الماضي الإمكانية التقنية لمحاكاة سلوك الإنسان على الإنترنت بالكامل بواسطة نماذج اللغة الكبيرة. وقد عزز ظهور [openclaw](https://github.com/openclaw/openclaw) هذا الاقتناع بشكل أكبر. -والأكثر إثارة للدهشة أنه من خلال تجاربنا واستكشافاتنا المبكرة، اكتشفنا أن دمج قدرات جمع البيانات في wiseflow في openclaw على شكل "إضافات" يحل المشكلتين المذكورتين أعلاه بشكل مثالي. سنقوم بنشر مقاطع فيديو تجريبية حقيقية مثيرة قريباً، إلى جانب إصدار هذه "الإضافات" كمصدر مفتوح. +والأكثر إثارة للدهشة أنه من خلال تجاربنا واستكشافاتنا المبكرة، اكتشفنا أن دمج قدرات جمع البيانات في wiseflow في openclaw على شكل "إضافات" يحل المشكلتين المذكورتين أعلاه بشكل مثالي. + +https://github.com/user-attachments/assets/8d097b3b-f9ab-42eb-98bb-88af5d28b089 تجدر الإشارة إلى أن نظام الإضافات في openclaw يختلف كثيراً عما نفهمه تقليدياً بـ"الإضافات" (المشابهة لإضافات Claude Code). لذلك اضطررنا إلى تقديم مفهوم "add-on". وبشكل دقيق، سيظهر wiseflow 5.x على شكل add-on لـ openclaw. لا يحتوي openclaw الأصلي على بنية "add-on"، لكن عملياً تحتاج فقط إلى بضعة أوامر shell بسيطة لإتمام هذا "التحويل". كما أعددنا نسخة معززة من openclaw جاهزة للاستخدام مع إعدادات مسبقة لسيناريوهات الأعمال الحقيقية: [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business). يمكنك ببساطة استنساخها ووضع إصدار wiseflow في مجلد add-on الخاص بـ openclaw_for_business. -## ✨ الميزات الرئيسية +## ✨ ما الذي ستكسبه بتثبيت wiseflow (أفضل من openclaw الأصلي)؟ -يوفر wiseflow add-on حالياً ثلاثة تحسينات جوهرية لـ openclaw: +### 1. متصفح مضاد للكشف، دون الحاجة لتثبيت أي إضافات للمتصفح -### 1. متصفح مضاد للكشف +يستبدل patch-001 الخاص بـ wiseflow برنامج Playwright المدمج في openclaw بـ [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (نسخة fork غير قابلة للكشف من Playwright)، مما يقلل بشكل كبير من احتمالية اكتشاف المتصفحات الآلية وحجبها من قبل المواقع المستهدفة. وهذا يعني أنه دون الحاجة إلى تثبيت امتداد Chrome Relay، يمكن لمتصفح مُدار وحده تحقيق قدرات اكتساب وتشغيل الويب المماثلة لإعداد relay أو حتى أفضل منه. -يستبدل Playwright المدمج في openclaw بـ [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (نسخة fork غير قابلة للكشف من Playwright)، مما يقلل بشكل كبير من احتمالية اكتشاف المتصفحات الآلية وحجبها من قبل المواقع المستهدفة. وهذا يعني أنه دون الحاجة إلى تثبيت امتداد Chrome Relay، يمكن لمتصفح مُدار وحده تحقيق قدرات اكتساب وتشغيل الويب المماثلة لإعداد relay أو حتى أفضل منه. +📥 *قمنا بتقييم جميع أطر عمل أتمتة المتصفح الرائجة في السوق، بما في ذلك nodriver وbrowser-use وagent-browser من Vercel. يمكننا التأكيد أنه رغم أن جميعها تعمل عبر CDP وتوفر ملفات تعريف مخصصة ومستمرة لـ openclaw، إلا أن Patchright وحده يوفر إزالة كاملة لبصمات CDP. بعبارة أخرى، حتى نهج الاتصال المباشر بـ CDP الأكثر نقاءً لا يزال يحمل توقيعات قابلة للكشف. تم تصميم الأطر الأخرى للاختبار الآلي، وليس لجمع البيانات، بينما تم تصميم Patchright خصيصاً للاستحواذ. ونظراً لأنه في جوهره تصحيح (patch) على Playwright، فإنه يرث تقريباً جميع واجهات برمجة التطبيقات عالية المستوى الخاصة بـ Playwright، مما يجعله متوافقاً بطبيعته مع openclaw دون الحاجة إلى تثبيت أي إضافات أو MCP إضافية.* -### 2. الاسترداد التلقائي لعلامات التبويب +### 2. آلية الاسترداد التلقائي لعلامات التبويب عندما تُغلق أو تُفقد علامة تبويب مستهدفة بشكل غير متوقع أثناء عملية Agent، يقوم النظام تلقائياً بإجراء استرداد علامة التبويب بناءً على لقطات الحالة، مما يضمن عدم انقطاع المهام بسبب فقدان علامة التبويب. -### 3. البحث الذكي +### 3. مهارة البحث الذكي (Smart Search Skill) يحل محل `web_search` المدمج في openclaw بقدرات بحث أكثر قوة. مقارنةً بأداة web search المدمجة الأصلية، يتميز البحث الذكي بثلاث مزايا جوهرية: @@ -46,8 +48,27 @@ - **بحث فوري لأقصى درجات الحداثة**: يوجّه المتصفح مباشرةً إلى الصفحات المستهدفة أو منصات التواصل الاجتماعي الكبرى (ويبو، Twitter/X، Facebook، إلخ) للحصول فوراً على أحدث المنشورات - **مصادر بحث قابلة للتخصيص**: يمكن للمستخدمين تحديد مصادر بحثهم بحرية للحصول على معلومات دقيقة وموجّهة +### 4. New Media Editor Crew (وكيل AI مسبق الإعداد) + +وكيل AI جاهز للاستخدام لإنشاء محتوى وسائل التواصل الاجتماعي الصينية، متخصص في المنصات الرئيسية الصينية مثل Weibo وXiaohongshu وZhihu وBilibili وDouyin. + +**القدرات الرئيسية:** + +- بحث الموضوعات + تحليل الاتجاهات (الوضع A) +- توسيع المسودة + إضافة أدلة من الإنترنت (الوضع B) +- بعد الانتهاء من المقال، استدعاء [Wenyan](https://github.com/caol64/wenyan) تلقائياً لتحويله إلى HTML بتنسيق حساب WeChat العام (7 قوالب مدمجة) +- الدفع المباشر إلى صندوق مسودات حساب WeChat العام (الوضع C، يتطلب `WECHAT_APP_ID`/`WECHAT_APP_SECRET`) +- دعم توليد الصور/الفيديو بالذكاء الاصطناعي ([SiliconFlow](https://www.siliconflow.com/) لتوليد الصور/الفيديو، يتطلب `SILICONFLOW_API_KEY`) + ## 🌟 البدء السريع +> **💡 ��لاحظة حول تكاليف API** +> +> يعتمد wiseflow 5.x على سير عمل Agent الخاص بـ openclaw، مما يتطلب الوصول إلى واجهة برمجة تطبيقات LLM. نوصي بإعداد بيانات اعتماد API مسبقاً: +> +> - **المستخدمون الدوليون (موصى به)**: [SiliconFlow](https://www.siliconflow.com/) — رصيد مجاني متاح بعد التسجيل يغطي تكاليف الاستخدام الأولي +> - **OpenAI / Anthropic ومزودون آخرون**: أي API متوافق يعمل + قم بتنزيل الحزمة المتكاملة (التي تشمل openclaw_for_business وإضافة wiseflow) مباشرةً من [Releases](https://github.com/TeamWiseFlow/wiseflow/releases) لهذا المستودع. 1. تنزيل الأرشيف وفك ضغطه @@ -82,7 +103,7 @@ ### [بديل] التثبيت اليدوي -> ملاحظة: تحتاج أولاً إلى تنزيل ونشر openclaw_for_business من: https://github.com/TeamWiseFlow/openclaw_for_business/releases +> ملاحظة: تحتاج أولاً إلى تنزيل ��نشر openclaw_for_business من: https://github.com/TeamWiseFlow/openclaw_for_business/releases انسخ مجلد `wiseflow` من هذا المستودع (وليس المستودع بأكمله) إلى مجلد `addons/` الخاص بـ openclaw_for_business: @@ -103,25 +124,38 @@ cp -r /tmp/wiseflow/wiseflow /addons/wiseflow
``` -wiseflow/ +wiseflow/ # حزمة addon (انسخها إلى مجلد addons/) ├── addon.json # البيانات الوصفية ├── overrides.sh # pnpm overrides + تعطيل web_search المدمج ├── patches/ │ ├── 001-browser-tab-recovery.patch # رقعة استعادة علامات التبويب -│ └── 002-disable-web-search-env-var.patch # تعطيل web_search المدمج (env var) -├── skills/ +│ ├── 002-disable-web-search-env-var.patch # تعطيل web_search المدمج (env var) +│ └── 003-act-field-validation.patch # رقعة التحقق من حقول ACT +├── skills/ # المهارات العامة (متاحة لجميع الوكلاء) │ ├── browser-guide/SKILL.md # أفضل ممارسات المتصفح (تسجيل الدخول/CAPTCHA/التحميل الكسول، إلخ) │ ├── smart-search/SKILL.md # منشئ URL البحث متعدد المنصات (يحل محل web_search المدمج) │ └── rss-reader/ # قارئ خلاصات RSS/Atom │ ├── SKILL.md │ ├── package.json │ └── scripts/fetch-rss.mjs -├── docs/ # التوثيق التقني -│ ├── anti-detection-research.md -│ └── more_powerful_search_skill/ -└── tests/ # حالات الاختبار والنصوص البرمجية - ├── README.md - └── run-managed-tests.mjs +└── crew/ # وكلاء AI مسبقو الإعداد (قوالب Crew) + └── new-media-editor/ # محرر الوسائط ��لجديدة (إنشاء محتوى وسائل التواصل الاجتماعي الصينية) + ├── IDENTITY.md / SOUL.md / AGENTS.md / TOOLS.md / ... + └── skills/ # مهارات خاصة بـ Crew + ├── siliconflow-img-gen/ # توليد صور AI (SiliconFlow API) + ├── siliconflow-video-gen/ # توليد فيديو AI (SiliconFlow API) + └── wenyan-formatter/ # Markdown → HTML WeChat / إرسال المسودة + +docs/ # التوثيق التقني (جذر المستودع) +├── anti-detection-research.md +└── more_powerful_search_skill/ + +scripts/ # النصوص البرمجية المساعدة (جذر المستودع) +└── generate-patch.sh + +tests/ # حالات الاختبار والنصوص البرمجية (جذر المستودع) +├── README.md +└── run-managed-tests.mjs ```
@@ -136,27 +170,30 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 🌹 بدءاً من اليوم، ساهم بطلبات السحب (PR) في النسخة مفتوحة المصدر من wiseflow (الكود والتوثيق ومشاركة قصص النجاح مرحب بها). عند القبول، سيحصل المساهمون على ترخيص لمدة عام واحد لـ wiseflow Pro! -📥 🎉 📚 - ## 🛡️ الترخيص منذ الإصدار 4.2، قمنا بتحديث ترخيصنا مفتوح المصدر. يرجى الاطلاع على: [LICENSE](LICENSE) -للتعاون التجاري، ير��ى التواصل عبر **البريد الإلكتروني: zm.zhao@foxmail.com** +للتعاون التجاري، يرجى التواصل عبر **البريد الإلكتروني: zm.zhao@foxmail.com** ## 📬 اتصل بنا لأي أسئلة أو اقتراحات، لا تتردد في ترك رسالة عبر [المشكلات](https://github.com/TeamWiseFlow/wiseflow/issues). -لمتطلبات النسخة الاحترافية أو ملاحظات التعاون، يرجى التواصل معنا عبر WeChat: +🎉 يقدم wiseflow & OFB الآن **قاعدة معرفة مدفوعة**، تتضمن دروس تعليمية للتثبيت خطوة بخطوة، ونصائح تطبيقية حصرية، و**مجموعة WeChat VIP**: + +أضف "Keeper" على WeChat Enterprise للاستفسار: + +wiseflow掌柜 -wechat +🌹 المصدر المفتوح يتطلب جهداً كبيراً — شكراً لدعمكم! ## 🤝 wiseflow 5.x مبني على المشاريع مفتوحة المصدر الممتازة التالية: - Patchright (نسخة Python غير قابلة للكشف من مكتبة Playwright للاختبار والأتمتة) https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python - Feedparser (تحليل الخلاصات في Python) https://github.com/kurtmckee/feedparser - SearXNG (محرك بحث وصفي مجاني على الإنترنت يجمع النتائج من خدمات البحث وقواعد البيانات المختلفة) https://github.com/searxng/searxng +- Wenyan (أداة تنسيق ونشر Markdown متعددة المنصات، يستخدمها New Media Editor Crew عبر مهارة wenyan-formatter) https://github.com/caol64/wenyan ## الاستشهاد @@ -169,6 +206,6 @@ https://github.com/TeamWiseFlow/wiseflow ## الشركاء -[siliconflow](https://siliconflow.com/) +[siliconflow](https://siliconflow.com/) diff --git a/README_DE.md b/README_DE.md index b4ae2e32..b77b78c0 100644 --- a/README_DE.md +++ b/README_DE.md @@ -20,23 +20,25 @@ Obwohl wir stets daran gearbeitet haben, die Funktionalität zu verbessern und d Die rasante Entwicklung von Agenten im vergangenen Jahr hat uns jedoch die technische Möglichkeit gezeigt, menschliches Internetverhalten durch große Sprachmodelle vollständig zu simulieren. Das Erscheinen von [openclaw](https://github.com/openclaw/openclaw) hat diese Überzeugung weiter gestärkt. -Noch bemerkenswerter ist, dass wir durch frühe Experimente und Erforschung entdeckt haben, dass die Integration der Erfassungsfähigkeiten von wiseflow als „Plugins" in openclaw die beiden oben genannten Einschränkungen perfekt löst. Wir werden in Kürze aufregende echte Demo-Videos veröffentlichen und diese „Plugins" als Open Source bereitstellen. +Noch bemerkenswerter ist, dass wir durch frühe Experimente und Erforschung entdeckt haben, dass die Integration der Erfassungsfähigkeiten von wiseflow als „Plugins" in openclaw die beiden oben genannten Einschränkungen perfekt löst. + +https://github.com/user-attachments/assets/8d097b3b-f9ab-42eb-98bb-88af5d28b089 Es ist jedoch zu beachten, dass das Plugin-System von openclaw sich erheblich von dem unterscheidet, was wir traditionell unter „Plugins" verstehen (ähnlich den Plugins von Claude Code). Daher mussten wir das Konzept des „Add-ons" einführen. Genau genommen wird wiseflow 5.x als openclaw Add-on erscheinen. Das originale openclaw verfügt nicht über eine „Add-on"-Architektur, aber in der Praxis benötigen Sie nur wenige einfache Shell-Befehle, um diese „Umgestaltung" durchzuführen. Wir haben auch eine sofort einsatzbereite, erweiterte Version von openclaw mit voreingestellten Konfigurationen für reale Geschäftsszenarien vorbereitet: [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business). Sie können es einfach klonen und das wiseflow-Release in den Add-on-Ordner von openclaw_for_business entpacken. -## ✨ Hauptfunktionen +## ✨ Was erhalten Sie durch die Installation von wiseflow (überlegen dem originalen openclaw)? -Das wiseflow Add-on bietet derzeit drei zentrale Verbesserungen für openclaw: +### 1. Anti-Erkennungs-Browser, keine Browser-Erweiterungen erforderlich -### 1. Anti-Erkennungs-Browser +wiseflow's patch-001 ersetzt das in openclaw integrierte Playwright durch [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (ein unerkannter Fork von Playwright) und reduziert damit erheblich die Wahrscheinlichkeit, dass automatisierte Browser von Ziel-Websites erkannt und blockiert werden. Dadurch lassen sich ohne die Installation einer Chrome-Relay-Extension mit einem verwalteten Browser gleichwertige oder sogar überlegene Web-Erfassungs- und Bedienungsfähigkeiten gegenüber einer Relay-Konfiguration erzielen. -Ersetzt das in openclaw integrierte Playwright durch [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (ein unerkannter Fork von Playwright) und reduziert damit erheblich die Wahrscheinlichkeit, dass automatisierte Browser von Ziel-Websites erkannt und blockiert werden. Dadurch lassen sich ohne die Installation einer Chrome-Relay-Extension mit einem verwalteten Browser gleichwertige oder sogar überlegene Web-Erfassungs- und Bedienungsfähigkeiten gegenüber einer Relay-Konfiguration erzielen. +📥 *Wir haben alle derzeit populären Browser-Automatisierungs-Frameworks bewertet, darunter nodriver, browser-use und Vercels agent-browser. Wir können bestätigen, dass zwar alle über CDP arbeiten und beständige openclaw-spezifische Profile bereitstellen, aber nur Patchright eine vollständige Entfernung von CDP-Fingerprints bietet. Mit anderen Worten: Selbst der direkteste CDP-Verbindungsansatz hinterlässt nachweisbare Merkmale. Andere Frameworks sind für automatisierte Tests konzipiert, nicht für Datenerfassung, während Patchright speziell für die Erfassung entwickelt wurde. Da es sich im Wesentlichen um einen Patch auf Playwright handelt, erbt es fast alle High-Level-APIs von Playwright — und ist dadurch nativ mit openclaw kompatibel, ohne dass zusätzliche Erweiterungen oder MCP installiert werden müssen.* -### 2. Automatische Tab-Wiederherstellung +### 2. Automatischer Tab-Wiederherstellungsmechanismus Wenn ein Ziel-Browser-Tab während eines Agent-Vorgangs unerwartet geschlossen oder verloren geht, führt das System automatisch eine snapshot-basierte Tab-Wiederherstellung durch, damit Aufgaben nicht durch Tab-Verlust unterbrochen werden. -### 3. Smart Search +### 3. Smart Search Skill Ersetzt die eingebaute `web_search` von openclaw durch leistungsfähigere Suchfunktionen. Im Vergleich zum ursprünglich integrierten web search tool bietet Smart Search drei zentrale Vorteile: @@ -44,8 +46,27 @@ Ersetzt die eingebaute `web_search` von openclaw durch leistungsfähigere Suchfu - **Echtzeit-Suche für maximale Aktualität**: Steuert den Browser direkt zu Zielseiten oder großen Social-Media-Plattformen (Weibo, Twitter/X, Facebook usw.), um die zuletzt veröffentlichten Inhalte sofort abzurufen - **Benutzerdefinierbare Suchquellen**: Benutzer können ihre Suchquellen frei festlegen, um präzise und zielgerichtete Informationsabfragen zu ermöglichen +### 4. New-Media-Editor Crew (vorkonfigurierter KI-Agent) + +Ein sofort einsatzbereiter KI-Agent zur Erstellung chinesischer Social-Media-Inhalte, spezialisiert auf die wichtigsten chinesischen Plattformen wie Weibo, Xiaohongshu, Zhihu, Bilibili und Douyin. + +**Hauptfähigkeiten:** + +- Themenrecherche + Trendanalyse (Modus A) +- Entwurfserweiterung + Online-Belegung (Modus B) +- Nach der Fertigstellung automatischer Aufruf von [Wenyan](https://github.com/caol64/wenyan) zur Darstellung als WeChat-Public-Account-HTML mit 7 integrierten Themen +- Direktes Pushen in den WeChat-Public-Account-Entwurfsbereich (Modus C, erfordert `WECHAT_APP_ID`/`WECHAT_APP_SECRET`) +- KI-Bild-/Videogenerierung ([SiliconFlow](https://www.siliconflow.com/) Bild/Video-Generierung, erfordert `SILICONFLOW_API_KEY`) + ## 🌟 Schnellstart +> **💡 Hinweis zu API-Kosten** +> +> wiseflow 5.x basiert auf dem Agent-Workflow von openclaw und benötigt LLM-API-Zugang. Wir empfehlen, Ihre API-Zugangsdaten vorab vorzubereiten: +> +> - **Internationale Benutzer (empfohlen)**: [SiliconFlow](https://www.siliconflow.com/) — nach der Registrierung werden kostenlose Credits gutgeschrieben, die die Anfangskosten abdecken +> - **OpenAI / Anthropic und andere Anbieter**: Jede kompatible API ist verwendbar + Laden Sie das integrierte Paket (enthält openclaw_for_business und das wiseflow Addon) direkt aus den [Releases](https://github.com/TeamWiseFlow/wiseflow/releases) dieses Repositories herunter. 1. Das Archiv herunterladen und entpacken @@ -85,25 +106,38 @@ Nach der Installation openclaw_for_business neu starten, um die Änderungen zu a ## Verzeichnisstruktur ``` -wiseflow/ +wiseflow/ # addon-Paket (in addons/-Verzeichnis kopieren) ├── addon.json # Metadaten ├── overrides.sh # pnpm overrides + integrierte web_search deaktivieren ├── patches/ │ ├── 001-browser-tab-recovery.patch # Tab-Wiederherstellungs-Patch -│ └── 002-disable-web-search-env-var.patch # Integrierte web_search deaktivieren (env var) -├── skills/ +│ ├── 002-disable-web-search-env-var.patch # Integrierte web_search deaktivieren (env var) +│ └── 003-act-field-validation.patch # ACT-Feldvalidierungs-Patch +├── skills/ # Globale Skills (für alle Agents verfügbar) │ ├── browser-guide/SKILL.md # Best Practices für den Browser (Login/CAPTCHA/Lazy-Loading etc.) │ ├── smart-search/SKILL.md # Multiplattform-Such-URL-Builder (ersetzt integrierte web_search) │ └── rss-reader/ # RSS/Atom Feed-Reader │ ├── SKILL.md │ ├── package.json │ └── scripts/fetch-rss.mjs -├── docs/ # Technische Dokumentation -│ ├── anti-detection-research.md -│ └── more_powerful_search_skill/ -└── tests/ # Testfälle und Skripte - ├── README.md - └── run-managed-tests.mjs +└── crew/ # Vorkonfigurierte KI-Agents (Crew-Vorlagen) + └── new-media-editor/ # New-Media-Editor (Chinesische Social-Media-Inhaltserstellung) + ├── IDENTITY.md / SOUL.md / AGENTS.md / TOOLS.md / ... + └── skills/ # Crew-spezifische Skills + ├── siliconflow-img-gen/ # KI-Bildgenerierung (SiliconFlow API) + ├── siliconflow-video-gen/ # KI-Videogenerierung (SiliconFlow API) + └── wenyan-formatter/ # Markdown → WeChat HTML / Entwurf pushen + +docs/ # Technische Dokumentation (Repository-Root) +├── anti-detection-research.md +└── more_powerful_search_skill/ + +scripts/ # Hilfsskripte (Repository-Root) +└── generate-patch.sh + +tests/ # Testfälle und Skripte (Repository-Root) +├── README.md +└── run-managed-tests.mjs ``` ## WiseFlow Pro ist jetzt verfügbar! @@ -116,8 +150,6 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 🌹 Ab sofort: Beiträge (PRs) zur Open-Source-Version von wiseflow (Code, Dokumentation und erfolgreiche Fallstudien sind willkommen) — bei Annahme erhalten Mitwirkende eine einjährige Lizenz für wiseflow Pro! -📥 🎉 📚 - ## 🛡️ Lizenz Seit Version 4.2 haben wir unsere Open-Source-Lizenz aktualisiert. Bitte beachten Sie: [LICENSE](LICENSE) @@ -128,15 +160,20 @@ Für kommerzielle Zusammenarbeit kontaktieren Sie bitte **Email: zm.zhao@foxmail Bei Fragen oder Vorschlägen hinterlassen Sie gerne eine Nachricht über [Issues](https://github.com/TeamWiseFlow/wiseflow/issues). -Für Anforderungen oder Feedback zur Pro-Version kontaktieren Sie uns bitte über WeChat: +🎉 wiseflow & OFB bieten jetzt eine **kostenpflichtige Wissensdatenbank** an, einschließlich Schritt-für-Schritt-Installationstutorials, exklusiver Anwendungstipps und einer **VIP-WeChat-Gruppe**: + +Fügen Sie „Keeper" auf WeChat Enterprise für Anfragen hinzu: + +wiseflow掌柜 -wechat +🌹 Open Source erfordert viel Aufwand — vielen Dank für Ihre Unterstützung! ## 🤝 wiseflow 5.x basiert auf folgenden hervorragenden Open-Source-Projekten: - Patchright (Unerkannte Python-Version der Playwright Test- und Automatisierungsbibliothek) https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python - Feedparser (Feeds in Python parsen) https://github.com/kurtmckee/feedparser - SearXNG (eine freie Internet-Metasuchmaschine, die Ergebnisse verschiedener Suchdienste und Datenbanken aggregiert) https://github.com/searxng/searxng +- Wenyan (plattformübergreifendes Markdown-Formatierungs- und Veröffentlichungstool, vom New-Media-Editor-Crew über das wenyan-formatter-Skill verwendet) https://github.com/caol64/wenyan ## Citation @@ -149,4 +186,4 @@ https://github.com/TeamWiseFlow/wiseflow ## Partner -[siliconflow](https://siliconflow.com/) +[siliconflow](https://siliconflow.com/) diff --git a/README_EN.md b/README_EN.md index 7d561172..4a9a644c 100644 --- a/README_EN.md +++ b/README_EN.md @@ -20,23 +20,25 @@ Although we have been dedicated to improving its functionality and expanding its However, the rapid advancement of Agents over the past year has shown us the technical possibility of fully simulating human internet behavior driven by large language models. The emergence of [openclaw](https://github.com/openclaw/openclaw) has further strengthened this belief. -What's even more remarkable is that through our early experiments and exploration, we discovered that integrating wiseflow's acquisition capabilities into openclaw as "plugins" perfectly solves the two limitations mentioned above. We will be releasing exciting real demo videos soon, along with open-sourcing these "plugins". +What's even more remarkable is that through our early experiments and exploration, we discovered that integrating wiseflow's acquisition capabilities into openclaw as "plugins" perfectly solves the two limitations mentioned above. -It should be noted, however, that openclaw's plugin system is quite different from what we traditionally understand as "plugins" (similar to Claude Code's plugins). Therefore, we had to introduce the concept of "add-on". To be precise, wiseflow 5.x will appear in the form of an openclaw add-on. The original openclaw does not have an "add-on" architecture, but in practice, you only need a few simple shell commands to complete this "transformation". We have also prepared a ready-to-use enhanced version of openclaw with a series of preset configurations for real business scenarios: [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business). You can simply clone it and extract the wiseflow release into the add-on folder of openclaw_for_business. +https://github.com/user-attachments/assets/8d097b3b-f9ab-42eb-98bb-88af5d28b089 -## ✨ Key Features +It should be noted that openclaw's plugin system is quite different from what we traditionally understand as "plugins" (similar to Claude Code's plugins). Therefore, we had to introduce the concept of "add-on". To be precise, wiseflow 5.x will appear in the form of an openclaw add-on. The original openclaw does not have an "add-on" architecture, but in practice, you only need a few simple shell commands to complete this "transformation". We have also prepared a ready-to-use enhanced version of openclaw with a series of preset configurations for real business scenarios: [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business). You can simply clone it and extract the wiseflow release into the add-on folder of openclaw_for_business. -The wiseflow add-on currently provides three core enhancements to openclaw: +## ✨ What Do You Gain by Installing wiseflow (Superior to Vanilla openclaw)? -### 1. Anti-Detection Browser +### 1. Anti-Detection Browser, No Browser Extensions Required -Replaces openclaw's built-in Playwright with [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (an undetected fork of Playwright), significantly reducing the likelihood of automated browsers being identified and blocked by target websites. This means that without installing the Chrome relay extension, a managed browser alone can achieve the same — or even better — web acquisition and operation capabilities as a relay setup. +wiseflow's patch-001 replaces openclaw's built-in Playwright with [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (an undetected fork of Playwright), significantly reducing the likelihood of automated browsers being identified and blocked by target websites. This means that without installing the Chrome relay extension, a managed browser alone can achieve the same — or even better — web acquisition and operation capabilities as a relay setup. -### 2. Automatic Tab Recovery +📥 *We evaluated all major browser automation frameworks currently available, including nodriver, browser-use, and Vercel's agent-browser. We can confirm that while they all operate through CDP and provide persistent openclaw-specific profiles, only Patchright delivers complete removal of CDP fingerprints. In other words, even the most direct CDP connection approach still carries detectable signatures. Other frameworks are designed for automated testing, not for data acquisition, whereas Patchright was specifically built for acquisition. Since it is essentially a patch on top of Playwright, it inherits nearly all of Playwright's high-level APIs — making it natively compatible with openclaw without requiring any additional extensions or MCP.* + +### 2. Automatic Tab Recovery Mechanism When a target browser tab is unexpectedly closed or lost during an Agent operation, the system automatically performs snapshot-based tab recovery, ensuring tasks are not interrupted by tab loss. -### 3. Smart Search +### 3. Smart Search Skill Replaces openclaw's built-in `web_search` with more powerful search capabilities. Compared to the original built-in web search tool, Smart Search has three core advantages: @@ -44,8 +46,27 @@ Replaces openclaw's built-in `web_search` with more powerful search capabilities - **Real-time search for maximum timeliness**: Directly drives the browser to target pages or major social media platforms (Weibo, Twitter/X, Facebook, etc.) to search for the latest published content - **User-configurable search sources**: Users can freely specify their search sources for precise, targeted information retrieval +### 4. New Media Editor Crew (Preset AI Agent) + +A ready-to-use Chinese social media content creation AI Agent, focused on major Chinese platforms including Weibo, Xiaohongshu, Zhihu, Bilibili, and Douyin. + +**Key capabilities:** + +- Topic research + trending analysis (Mode A) +- Draft expansion + online fact support (Mode B) +- After article finalization, automatically invokes [Wenyan](https://github.com/caol64/wenyan) to render WeChat public account-style HTML with 7 built-in themes +- Direct push to WeChat public account draft box (Mode C, requires `WECHAT_APP_ID`/`WECHAT_APP_SECRET`) +- AI image/video generation support ([SiliconFlow](https://www.siliconflow.com/) image/video generation, requires `SILICONFLOW_API_KEY`) + ## 🌟 Quick Start +> **💡 API Cost Note** +> +> wiseflow 5.x is powered by openclaw's Agent workflow, which requires LLM API access. We recommend preparing your API credentials first: +> +> - **International users (recommended)**: [SiliconFlow](https://www.siliconflow.com/) — free credits available after registration, covering initial usage costs +> - **OpenAI / Anthropic and other providers**: Any compatible API works + Download the integrated package (which includes openclaw_for_business and the wiseflow addon) directly from this repository's [Releases](https://github.com/TeamWiseFlow/wiseflow/releases). 1. Download and extract the archive @@ -85,25 +106,38 @@ Restart openclaw_for_business after installation to take effect. ## Directory Structure ``` -wiseflow/ +wiseflow/ # addon package (copy to addons/ directory) ├── addon.json # Metadata ├── overrides.sh # pnpm overrides + disable built-in web_search ├── patches/ │ ├── 001-browser-tab-recovery.patch # Tab recovery patch -│ └── 002-disable-web-search-env-var.patch # Disable built-in web_search (env var) -├── skills/ +│ ├── 002-disable-web-search-env-var.patch # Disable built-in web_search (env var) +│ └── 003-act-field-validation.patch # ACT field validation patch +├── skills/ # Global skills (available to all Agents) │ ├── browser-guide/SKILL.md # Browser best practices (login/captcha/lazy-loading, etc.) │ ├── smart-search/SKILL.md # Multi-platform search URL builder (replaces built-in web_search) │ └── rss-reader/ # RSS/Atom Feed reader │ ├── SKILL.md │ ├── package.json │ └── scripts/fetch-rss.mjs -├── docs/ # Technical documentation -│ ├── anti-detection-research.md -│ └── more_powerful_search_skill/ -└── tests/ # Test cases and scripts - ├── README.md - └── run-managed-tests.mjs +└── crew/ # Preset AI Agents (Crew templates) + └── new-media-editor/ # New Media Editor (Chinese social media content creation) + ├── IDENTITY.md / SOUL.md / AGENTS.md / TOOLS.md / ... + └── skills/ # Crew-specific skills + ├── siliconflow-img-gen/ # AI image generation (SiliconFlow API) + ├── siliconflow-video-gen/ # AI video generation (SiliconFlow API) + └── wenyan-formatter/ # Markdown → WeChat HTML / push draft + +docs/ # Technical documentation (repo root) +├── anti-detection-research.md +└── more_powerful_search_skill/ + +scripts/ # Utility scripts (repo root) +└── generate-patch.sh + +tests/ # Test cases and scripts (repo root) +├── README.md +└── run-managed-tests.mjs ``` ## WiseFlow Pro is Now Available! @@ -116,8 +150,6 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 🌹 Starting today, contribute PRs to the wiseflow open-source version (code, documentation, and successful case studies are all welcome). Once accepted, contributors will receive a one-year license for wiseflow Pro! -📥 🎉 📚 - ## 🛡️ License Since version 4.2, we have updated our open-source license. Please refer to: [LICENSE](LICENSE) @@ -128,15 +160,20 @@ For commercial cooperation, please contact **Email: zm.zhao@foxmail.com** For any questions or suggestions, feel free to leave a message via [issue](https://github.com/TeamWiseFlow/wiseflow/issues). -For Pro version requirements or cooperation feedback, please contact the "AI Chief Intelligence Officer" via WeChat: +🎉 wiseflow & OFB now offer a **paid knowledge base**, including step-by-step installation tutorials, exclusive application tips, and a **VIP WeChat group**: + +Feel free to add "Keeper" on WeChat Enterprise for inquiries: + +wiseflow掌柜 -wechat +🌹 Open source takes effort — thank you for your support! ## 🤝 wiseflow 5.x is built on the following excellent open-source projects: - Patchright (Undetected Python version of the Playwright testing and automation library) https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python - Feedparser (Parse feeds in Python) https://github.com/kurtmckee/feedparser - SearXNG (a free internet metasearch engine which aggregates results from various search services and databases) https://github.com/searxng/searxng +- Wenyan (multi-platform Markdown formatting and publishing tool, used by the New Media Editor Crew via the wenyan-formatter skill) https://github.com/caol64/wenyan ## Citation @@ -149,4 +186,4 @@ https://github.com/TeamWiseFlow/wiseflow ## Partners -[siliconflow](https://siliconflow.com/) +[siliconflow](https://siliconflow.com/) diff --git a/README_FR.md b/README_FR.md index e682c921..590f2062 100644 --- a/README_FR.md +++ b/README_FR.md @@ -20,23 +20,25 @@ Bien que nous nous soyons constamment efforcés d'améliorer ses fonctionnalité Cependant, les progrès fulgurants des Agents au cours de l'année écoulée nous ont montré la possibilité technique de simuler entièrement le comportement humain sur Internet grâce aux grands modèles de langage. L'apparition d'[openclaw](https://github.com/openclaw/openclaw) a renforcé davantage cette conviction. -Plus remarquable encore, grâce à nos expériences et explorations préliminaires, nous avons découvert que l'intégration des capacités d'acquisition de wiseflow dans openclaw sous forme de « plugins » résout parfaitement les deux limitations mentionnées ci-dessus. Nous publierons prochainement des vidéos de démonstration passionnantes, tout en rendant ces « plugins » open source. +Plus remarquable encore, grâce à nos expériences et explorations préliminaires, nous avons découvert que l'intégration des capacités d'acquisition de wiseflow dans openclaw sous forme de « plugins » résout parfaitement les deux limitations mentionnées ci-dessus. + +https://github.com/user-attachments/assets/8d097b3b-f9ab-42eb-98bb-88af5d28b089 Il convient de noter que le système de plugins d'openclaw diffère considérablement de ce que nous comprenons traditionnellement par « plugins » (similaires aux plugins de Claude Code). Nous avons donc dû introduire le concept d'« add-on ». Pour être précis, wiseflow 5.x apparaîtra sous la forme d'un add-on openclaw. L'openclaw original ne dispose pas d'une architecture « add-on », mais en pratique, vous n'avez besoin que de quelques commandes shell simples pour effectuer cette « transformation ». Nous avons également préparé une version améliorée d'openclaw prête à l'emploi avec des configurations prédéfinies pour des scénarios commerciaux réels : [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business). Vous pouvez simplement le cloner et extraire la release wiseflow dans le dossier add-on d'openclaw_for_business. -## ✨ Fonctionnalités principales +## ✨ Que gagnez-vous en installant wiseflow (supérieur à l'openclaw original) ? -Le module complémentaire wiseflow apporte actuellement trois améliorations essentielles à openclaw : +### 1. Navigateur anti-détection, sans extensions de navigateur -### 1. Navigateur anti-détection +Le patch-001 de wiseflow remplace le Playwright intégré d'openclaw par [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (un fork non détectable de Playwright), réduisant considérablement le risque que les navigateurs automatisés soient identifiés et bloqués par les sites cibles. Cela permet d'atteindre des capacités d'acquisition et d'opération web équivalentes, voire supérieures à celles d'une configuration relay, en utilisant uniquement un navigateur géré sans installer d'extension Chrome relay. -Remplace le Playwright intégré d'openclaw par [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) (un fork non détectable de Playwright), réduisant considérablement le risque que les navigateurs automatisés soient identifiés et bloqués par les sites cibles. Cela permet d'atteindre des capacités d'acquisition et d'opération web équivalentes, voire supérieures à celles d'une configuration relay, en utilisant uniquement un navigateur géré sans installer d'extension Chrome relay. +📥 *Nous avons évalué tous les principaux frameworks d'automatisation de navigateur disponibles, notamment nodriver, browser-use et agent-browser de Vercel. Nous pouvons confirmer que bien qu'ils fonctionnent tous via CDP et fournissent des profils persistants dédiés à openclaw, seul Patchright assure la suppression complète des empreintes CDP. En d'autres termes, même l'approche de connexion CDP la plus directe laisse des signatures détectables. Les autres frameworks sont conçus pour les tests automatisés, non pour l'acquisition de données, tandis que Patchright a été spécifiquement conçu pour l'acquisition. Étant essentiellement un patch de Playwright, il hérite de presque toutes ses API de haut niveau — le rendant nativement compatible avec openclaw sans nécessiter d'extensions ou de MCP supplémentaires.* -### 2. Récupération automatique des onglets +### 2. Mécanisme de récupération automatique des onglets Lorsqu'un onglet cible est fermé ou perdu de manière inattendue lors d'une opération Agent, le système effectue automatiquement une récupération d'onglet basée sur des snapshots, garantissant que les tâches ne soient pas interrompues par une perte d'onglet. -### 3. Smart Search +### 3. Smart Search Skill Remplace le `web_search` intégré d'openclaw par des capacités de recherche plus puissantes. Comparé à l'outil web search intégré d'origine, Smart Search présente trois avantages clés : @@ -44,8 +46,27 @@ Remplace le `web_search` intégré d'openclaw par des capacités de recherche pl - **Recherche en temps réel pour une actualité maximale** : Pilote directement le navigateur vers les pages cibles ou les grandes plateformes de médias sociaux (Weibo, Twitter/X, Facebook, etc.) pour récupérer immédiatement les contenus publiés récemment - **Sources de recherche personnalisables** : Les utilisateurs peuvent librement spécifier leurs sources de recherche pour une récupération d'informations précise et ciblée +### 4. New Media Editor Crew (Agent IA préconfiguré) + +Un agent IA de création de contenu pour les réseaux sociaux chinois prêt à l'emploi, spécialisé dans les principales plateformes chinoises comme Weibo, Xiaohongshu, Zhihu, Bilibili et Douyin. + +**Capacités principales :** + +- Recherche de sujets + analyse des tendances (Mode A) +- Expansion du brouillon + justification en ligne (Mode B) +- Après finalisation de l'article, appel automatique de [Wenyan](https://github.com/caol64/wenyan) pour le rendre en HTML style compte officiel WeChat, avec 7 thèmes intégrés +- Envoi direct vers la boîte de brouillons du compte officiel WeChat (Mode C, nécessite `WECHAT_APP_ID`/`WECHAT_APP_SECRET`) +- Support de génération d'images/vidéos IA ([SiliconFlow](https://www.siliconflow.com/) génération d'images/vidéos, nécessite `SILICONFLOW_API_KEY`) + ## 🌟 Démarrage rapide +> **💡 Note sur les coûts API** +> +> wiseflow 5.x repose sur le workflow Agent d'openclaw, qui nécessite un accès à l'API LLM. Nous recommandons de préparer vos identifiants API à l'avance : +> +> - **Utilisateurs internationaux (recommandé)** : [SiliconFlow](https://www.siliconflow.com/) — des crédits gratuits sont disponibles après inscription, couvrant les coûts initiaux +> - **OpenAI / Anthropic et autres fournisseurs** : Toute API compatible fonctionne + Téléchargez le package intégré (qui inclut openclaw_for_business et le wiseflow addon) directement depuis les [Releases](https://github.com/TeamWiseFlow/wiseflow/releases) de ce dépôt. 1. Télécharger et extraire l'archive @@ -85,25 +106,38 @@ Redémarrez openclaw_for_business après l'installation pour que les changements ## Structure des répertoires ``` -wiseflow/ +wiseflow/ # package addon (copier dans le répertoire addons/) ├── addon.json # Métadonnées ├── overrides.sh # pnpm overrides + désactiver web_search intégré ├── patches/ │ ├── 001-browser-tab-recovery.patch # Patch de récupération d'onglets -│ └── 002-disable-web-search-env-var.patch # Désactiver web_search intégré (env var) -├── skills/ +│ ├── 002-disable-web-search-env-var.patch # Désactiver web_search intégré (env var) +│ └── 003-act-field-validation.patch # Patch de validation des champs ACT +├── skills/ # Skills globaux (disponibles pour tous les Agents) │ ├── browser-guide/SKILL.md # Bonnes pratiques du navigateur (connexion/CAPTCHA/chargement différé, etc.) │ ├── smart-search/SKILL.md # Constructeur d'URL de recherche multi-plateforme (remplace web_search intégré) │ └── rss-reader/ # Lecteur de flux RSS/Atom │ ├── SKILL.md │ ├── package.json │ └── scripts/fetch-rss.mjs -├── docs/ # Documentation technique -│ ├── anti-detection-research.md -│ └── more_powerful_search_skill/ -└── tests/ # Cas de test et scripts - ├── README.md - └── run-managed-tests.mjs +└── crew/ # Agents IA préconfigurés (modèles Crew) + └── new-media-editor/ # New Media Editor (création de contenu social media chinois) + ├── IDENTITY.md / SOUL.md / AGENTS.md / TOOLS.md / ... + └── skills/ # Skills spécifiques au Crew + ├── siliconflow-img-gen/ # Génération d'images IA (API SiliconFlow) + ├── siliconflow-video-gen/ # Génération de vidéos IA (API SiliconFlow) + └── wenyan-formatter/ # Markdown → HTML WeChat / envoi brouillon + +docs/ # Documentation technique (racine du dépôt) +├── anti-detection-research.md +└── more_powerful_search_skill/ + +scripts/ # Scripts utilitaires (racine du dépôt) +└── generate-patch.sh + +tests/ # Cas de test et scripts (racine du dépôt) +├── README.md +└── run-managed-tests.mjs ``` ## WiseFlow Pro est maintenant disponible ! @@ -116,8 +150,6 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 🌹 Dès aujourd'hui, contribuez des PRs à la version open source de wiseflow (code, documentation et partage de cas d'utilisation réussis sont les bienvenus). Une fois acceptées, les contributeurs recevront une licence d'un an pour wiseflow Pro ! -📥 🎉 📚 - ## 🛡️ Licence Depuis la version 4.2, nous avons mis à jour notre licence open source. Veuillez consulter : [LICENSE](LICENSE) @@ -128,15 +160,20 @@ Pour une coopération commerciale, veuillez contacter **Email : zm.zhao@foxmail. Pour toute question ou suggestion, n'hésitez pas à laisser un message via les [issues](https://github.com/TeamWiseFlow/wiseflow/issues). -Pour les exigences relatives à la version Pro ou les retours de coopération, veuillez nous contacter via WeChat : +🎉 wiseflow & OFB proposent désormais une **base de connaissances payante**, incluant des tutoriels d'installation pas à pas, des astuces d'application exclusives et un **groupe WeChat VIP** : + +N'hésitez pas à ajouter « Keeper » sur WeChat Enterprise pour toute demande : + +wiseflow掌柜 -wechat +🌹 L'open source demande beaucoup d'efforts — merci pour votre soutien ! ## 🤝 wiseflow 5.x est construit sur les excellents projets open source suivants : - Patchright (Version Python indétectable de la bibliothèque de test et d'automatisation Playwright) https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python - Feedparser (Analyse de flux en Python) https://github.com/kurtmckee/feedparser - SearXNG (un métamoteur de recherche internet gratuit qui agrège les résultats de divers services de recherche et bases de données) https://github.com/searxng/searxng +- Wenyan (outil de formatage et de publication Markdown multi-plateforme, utilisé par le New Media Editor Crew via le skill wenyan-formatter) https://github.com/caol64/wenyan ## Citation @@ -149,4 +186,4 @@ https://github.com/TeamWiseFlow/wiseflow ## Partenaires -[siliconflow](https://siliconflow.com/) +[siliconflow](https://siliconflow.com/) diff --git a/README_JP.md b/README_JP.md index d8404871..659e7091 100644 --- a/README_JP.md +++ b/README_JP.md @@ -4,10 +4,10 @@ 🚀 **STEP INTO 5.x** -> 📌 **4.x をお探しですか?** オリジナルの v4.30 以前のコードは [`4.x` ブランチ](https://github.com/TeamWiseFlow/wiseflow/tree/4.x)にあります。 +> 📌 **4.x をお探しですか?** オリジナルの v4.30 以前のコードは [`4.x` ブランチ](https://github.com/TeamWiseFlow/wiseflow/tree/4.x)にありま��。 ``` -「我が生には涯(かぎり)有るも、��には涯無し。涯有るを以て涯無きに随(したが)うは、殆(あやう)きのみ!」—— 『荘子・内篇・養生主第三』 +「我が生には涯(かぎり)有るも、知には涯無し。涯有るを以て涯無きに随(したが)うは、殆(あやう)きのみ!」—— 『荘子・内篇・養生主第三』 ``` wiseflow 4.x(およびそれ以前のバージョン)は、一連の精密なワークフローによって特定のシナリオで強力なデータ取得能力を実現しましたが、依然として多くの制限がありました: @@ -18,25 +18,27 @@ wiseflow 4.x(およびそれ以前のバージョン)は、一連の精密 私たちは機能の改善と範囲の拡大に取り組んできましたが、現実の世界は複雑であり、インターネットも同様です。ルールを網羅することは不可能であるため、固定のワークフローではすべてのシナリオに対応できません。これは wiseflow の問題ではなく、従来のソフトウェアの問題です! -しかし、この一年で Agent 技術が飛躍的に進歩し、大規模言語モデルによって人間のインターネット行動を完全にシミュレートすることが技術的に可能であることが示されました。[openclaw](https://github.com/openclaw/openclaw) の登場は、この確信をさらに強めました。 +しかし、この一年で Agent 技術が飛���的に進歩し、大規模言語モデルによって人間のインターネット行動を完全にシミュレートすることが技術的に可能であることが示されました。[openclaw](https://github.com/openclaw/openclaw) の登場は、この確信をさらに強めました。 -さらに驚くべきことに、初期の実験と探索を通じて、wiseflow のデータ取得能力を「プラグイン」として openclaw に統合することで、上記の2つの制限を完全に解決できることを発見しました。今後、エキサイティングな実際のデモ動画を順次公開するとともに、これらの「プラグイン」をオープンソースとしてリリースします。 +さらに驚くべきことに、初期の実験と探索を通じて、wiseflow のデータ取得能力を「プラグイン」として openclaw に統合することで、上記の2つの制限を完全に解決できることを発見しました。 -ただし、openclaw のプラグインシステムは、従来の「プラグイン」(Claude Code のプラグインのようなもの)とは異なるため、「add-on」という概念を新たに導入する必要がありました。正確に言えば、wiseflow 5.x は openclaw の add-on として提供されます。オリジナルの openclaw には「add-on」アーキテクチャがありませんが、実際にはいくつかの簡単なシェルコマンドでこの「改造」を完了できます。また、実際のビジネスシーンに向けたプリセット設定を含む、すぐに使える openclaw 強化版 [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business) も用意しています。クローンして、wiseflow のリリースを openclaw_for_business の add-on フォルダに配置するだけで使用できます。 +https://github.com/user-attachments/assets/8d097b3b-f9ab-42eb-98bb-88af5d28b089 -## ✨ 主要機能 +ただし、openclaw のプラグインシステムは、従来の「プラグイン」(Claude Code のプラグインのようなもの)とは異なるため、「add-on」という概念を新たに導入する必要がありました。正確に言えば、wiseflow 5.x は openclaw の add-on として提供されます。オリジナルの openclaw には「add-on」アーキテクチャがありませんが、実際にはいくつかの簡単なシェルコマンドでこの「改造」を完了できます。また、実際のビジネスシーンに向���たプリセット設定を含む、すぐに使える openclaw 強化版 [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business) も用意しています。クローンして、wiseflow のリリースを openclaw_for_business の add-on フォルダに配置するだけで使用できます。 -wiseflow add-on は現在、openclaw に以下の3つのコア機能強化を提供しています: +## ✨ wiseflow をインストールすることで何が得られますか(オリジナル openclaw より優れている点)? -### 1. アンチ検出ブラウザ +### 1. アンチ検出ブラウザ、ブラウザ拡張機能インストール不要 -openclaw に内蔵された Playwright を [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)(Playwright の検出回避フォーク)に置き換え、自動化ブラウザがターゲットサイトに検出・ブロックされる可能性を大幅に低減します。これにより、Chrome Relay Extension をインストールすることなく、マネージドブラウザだけで Relay と同等、あるいはそれ以上のウェブ取得・操作能力を実現できます。 +wiseflow の patch-001 は、openclaw に内蔵された Playwright を [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)(Playwright の検出回避フォーク)に置き換え、自動化ブラウザがターゲットサイトに検出・ブロックされる可能性を大幅に低減します。これにより、Chrome Relay Extension をインストールすることなく、マネージドブラウザだけで Relay と同等、あるいはそれ以上のウェブ取得・操作能力を実現できます。 -### 2. タブ自動復元 +📥 *私たちは現在市場で人気のあるブラウザ自動化フレームワーク(nodriver、browser-use、Vercel の agent-browser など)を総合的に評価しました。すべてが CDP を通じて動作し、openclaw 専用の永続化プロファイルを提供するという基本原理は同じですが、CDP プローブの完全な除去を提供しているのは Patchright だけです。つまり、最も純粋な CDP 直接接続アプローチを使用しても、特徴的なフィンガープリントは残り、検出される可能性があります。他のフレームワークはデータ取得ではなく自動テストを目的として設計されていますが、Patchright はもともとデータ取得を目的として設計されており、本質的には Playwright のパッチであり、ほぼすべての Playwright の上位 API を継承しています。これにより openclaw とのネイティブな互換性が実現し、追加のプラグインや MCP をインストールする必要がありません。* + +### 2. タブ自動復元メカニズム Agent の操作中にターゲットタブが予期せず閉じられたり失われたりした場合、スナップショットベースのタブ復元を自動的に実行し、タブの消失によるタスクの中断を防ぎます。 -### 3. スマート検索 +### 3. スマート検索 Skill openclaw に内蔵された `web_search` をより強力な検索機能に置き換えます。オリジナルの内蔵 web search tool と比較して、スマート検索には3つの主要な優位性があります: @@ -44,8 +46,27 @@ openclaw に内蔵された `web_search` をより強力な検索機能に置き - **リアルタイム検索、最高の鮮度**:ブラウザを直接ターゲットページや主要なソーシャルメディアプラットフォーム(Weibo、Twitter/X、Facebook など)に誘導し、最新公開コンテンツを即座に取得 - **検索ソースのカスタマイズ**:ユーザーが自由に検索ソースを指定でき、必要な情報を精確に取得 +### 4. 新媒体小編 Crew(プリセット AI エージェント) + +すぐに使える中国語ソーシャルメディアコンテンツ制作 AI エージェントで、微博、小紅書、知乎、B ステーション、抖音などの中国の主要プラットフォームに特化しています。 + +**主な機能:** + +- テーマリサーチ + トレンド分析(モード A) +- 下書き拡充 + オンライン根拠追加(モード B) +- 記事確定後、[文颜(Wenyan)](https://github.com/caol64/wenyan) を自動呼び出して WeChat 公式アカウント形式の HTML にレンダリング(7 種類の内蔵テーマ対応) +- WeChat 公式アカウントの下書きに直接プッシュ(モード C、`WECHAT_APP_ID`/`WECHAT_APP_SECRET` の設定が必要) +- AI 画像/動画生成サポート([SiliconFlow](https://www.siliconflow.com/) 画像/動画生成、`SILICONFLOW_API_KEY` の設定が必要) + ## 🌟 クイックスタート +> **💡 API コストのご説明** +> +> wiseflow 5.x は openclaw の Agent ワークフローをベースにしており、LLM API アクセスが必要です。事前に API 資格情報を準備することをお勧めします: +> +> - **海外ユーザー(推奨)**:[SiliconFlow](https://www.siliconflow.com/) — 登録後に無料クレジットが付与され、初期使用コストをカバーできます +> - **OpenAI / Anthropic その他のプロバイダー**:互換性のある任意の API が使用可能です + 本リポジトリの [Releases](https://github.com/TeamWiseFlow/wiseflow/releases) から openclaw_for_business と wiseflow addon を含む統合パッケージをダウンロードしてください。 1. アーカイブをダウンロードして解凍する @@ -85,25 +106,38 @@ cp -r /tmp/wiseflow/wiseflow /addons/wiseflow ## ディレクトリ構造 ``` -wiseflow/ +wiseflow/ # addon パッケージ(addons/ ディレクトリに配置) ├── addon.json # メタデータ ├── overrides.sh # pnpm overrides + 内蔵 web_search を無効化 ├── patches/ │ ├── 001-browser-tab-recovery.patch # タブ復元パッチ -│ └── 002-disable-web-search-env-var.patch # 内蔵 web_search の無効化(env var) -├── skills/ +│ ├── 002-disable-web-search-env-var.patch # 内蔵 web_search の無効化(env var) +│ └── 003-act-field-validation.patch # ACT フィールド検証パッチ +├── skills/ # グローバルスキル(全エージェント利用可能) │ ├── browser-guide/SKILL.md # ブラウザのベストプラクティス(ログイン/CAPTCHA/遅延ロードなど) │ ├── smart-search/SKILL.md # マルチプラットフォーム検索URL構築(内蔵 web_search の代替) │ └── rss-reader/ # RSS/Atom フィードリーダー │ ├── SKILL.md │ ├── package.json │ └── scripts/fetch-rss.mjs -├── docs/ # 技術ドキュメント -│ ├── anti-detection-research.md -│ └── more_powerful_search_skill/ -└── tests/ # テストケースとスクリプト - ├── README.md - └── run-managed-tests.mjs +└── crew/ # プリセット AI エージェント(Crew テンプレート) + └── new-media-editor/ # 新媒体小編(中国語ソーシャルメディアコンテンツ制作) + ├── IDENTITY.md / SOUL.md / AGENTS.md / TOOLS.md / ... + └── skills/ # Crew 専属スキル + ├── siliconflow-img-gen/ # AI 画像生成(SiliconFlow API) + ├── siliconflow-video-gen/ # AI 動画生成(SiliconFlow API) + └── wenyan-formatter/ # Markdown → WeChat HTML / 下書きプッシュ + +docs/ # 技術ドキュメント(リポジトリルート) +├── anti-detection-research.md +└── more_powerful_search_skill/ + +scripts/ # ユーティリティスクリプト(リポジトリルート) +└── generate-patch.sh + +tests/ # テストケースとスクリプト(リポジトリルート) +├── README.md +└── run-managed-tests.mjs ``` ## WiseFlow Pro 版がリリースされました! @@ -116,8 +150,6 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 🌹 本日より、wiseflow オープンソース版への PR 貢献(コード、ドキュメント、成功事例の共有すべて歓迎)が採用された場合、コントリビューターには wiseflow Pro 版の1年間ライセンスが贈呈されます! -📥 🎉 📚 - ## 🛡️ ライセンス バージョン 4.2 以降、オープンソースライセンスを更新しました。詳細はこちら:[LICENSE](LICENSE) @@ -128,15 +160,20 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 ご質問やご提案がございましたら、[issue](https://github.com/TeamWiseFlow/wiseflow/issues) からお気軽にメッセージをお寄せください。 -Pro 版に関するご要望や提携のフィードバックは、WeChat でお問い合わせください: +🎉 wiseflow && OFB では現在**有料ナレッジベース**を提供しています。内容には、ゼロからの手順インストールチュートリアル、各種独自の活用ノウハウ、および **VIP WeChat グループ**が含まれます: + +ご相談は「掌柜的」企業 WeChat をご追加ください: + +wiseflow掌柜 -wechat +🌹 オープンソース維持のご支援に感謝します! ## 🤝 wiseflow 5.x は以下の優秀なオープンソースプロジェクトを基盤としています: - Patchright(Playwright テスト・自動化ライブラリの検出回避 Python 版)https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python - Feedparser(Python でフィードを解析)https://github.com/kurtmckee/feedparser - SearXNG(様々な検索サービスやデータベースから結果を集約する無料のインターネットメタ検索エンジン)https://github.com/searxng/searxng +- 文颜(Wenyan)(多プラットフォーム Markdown フォーマットと投稿ツール、新媒体小編 Crew が wenyan-formatter スキル経由で使用)https://github.com/caol64/wenyan ## Citation @@ -149,4 +186,4 @@ https://github.com/TeamWiseFlow/wiseflow ## パートナー -[siliconflow](https://siliconflow.com/) +[siliconflow](https://siliconflow.com/) diff --git a/README_KR.md b/README_KR.md index e0dd5b38..611e8952 100644 --- a/README_KR.md +++ b/README_KR.md @@ -18,34 +18,55 @@ wiseflow 4.x(이전 버전 포함)는 일련의 정밀한 워크플로우를 통 기능 개선과 범위 확장에 꾸준히 노력해 왔지만, 현실 세계는 복잡하고 인터넷도 마찬가지입니다. 규칙을 완전히 망라하는 것은 불가능하므로, 고정된 워크플로우로는 모든 시나리오에 대응할 수 없습니다. 이것은 wiseflow의 문제가 아니라 전통적인 소프트웨어의 문제입니다! -그러나 지난 1년간 Agent 기술의 비약적인 발전은 대규모 언어 모델로 인간의 인터넷 행동을 ��전히 시뮬레이션하는 것이 기술적으로 가능하다는 것을 보여주었습니다. [openclaw](https://github.com/openclaw/openclaw)의 등장은 이러한 확신을 더욱 굳건히 했습니다. +그러나 지난 1년간 Agent 기술의 비약적인 발전은 대규모 언어 모델로 인간의 인터넷 행동을 완전히 시뮬레이션하는 것이 기술적으로 가능하다는 것을 보여주었습니다. [openclaw](https://github.com/openclaw/openclaw)의 등장은 이러한 확신을 더욱 굳건히 했습니다. -더욱 놀라운 것은, 초기 실험과 탐색을 통해 wiseflow의 데이터 수집 능력을 "플러그인" 형태로 openclaw에 통합하면 위에서 언급한 두 가지 한계를 완벽하게 해결할 수 있다는 것을 발견했습니다. 앞으로 흥미진진한 실제 데모 영상을 순차적으로 공개하고, 이 "플러그인"들을 오픈소스로 릴리스할 예정입니다. +더욱 놀라운 것은, 초기 실험과 탐색을 통해 wiseflow의 데이터 수집 능력을 "플러그인" 형태로 openclaw에 통합하면 위에서 언급한 두 가지 한계를 완벽하게 해결할 수 있다는 것을 발견했습니다. + +https://github.com/user-attachments/assets/8d097b3b-f9ab-42eb-98bb-88af5d28b089 다만, openclaw의 플러그인 시스템은 우리가 전통적으로 이해하는 "플러그인"(Claude Code의 플러그인과 유사한 것)과는 다르기 때문에, "add-on"이라는 개념을 별도로 도입해야 했습니다. 정확히 말하면, wiseflow 5.x는 openclaw add-on 형태로 제공됩니다. 원래 openclaw에는 "add-on" 아키텍처가 없지만, 실제로는 몇 가지 간단한 셸 명령어만으로 이 "개조"를 완료할 수 있습니다. 또한 실제 비즈니스 시나리오를 위한 프리셋 설정이 포함된 즉시 사용 가능한 openclaw 강화 버전인 [openclaw_for_business](https://github.com/TeamWiseFlow/openclaw_for_business)도 준비했습니다. 클론한 후 wiseflow 릴리스를 openclaw_for_business의 add-on 폴더에 배치하면 됩니다. -## ✨ 주요 기능 +## ✨ wiseflow를 설치하면 무엇을 얻을 수 있나요(원본 openclaw보다 우수한 점)? -wiseflow add-on은 현재 openclaw에 다음 세 가지 핵심 기능을 제공합니다: +### 1. 탐지 방지 브라우저, 브라우저 확장 프로그램 설치 불필요 -### 1. 탐지 방지 브라우저 +wiseflow의 patch-001은 openclaw 내장 Playwright를 [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)(Playwright의 탐지 방지 포크)로 교체하여, 자동화 브라우저가 대상 웹사이트에 감지·차단될 가능성을 크게 줄입니다. 이를 통해 Chrome Relay Extension 설치 없이, 관리형 브라우저만으로도 Relay와 동등하거나 더 뛰어난 웹 수집 및 조작 능력을 달성할 수 있습니다. -openclaw 내장 Playwright를 [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)(Playwright의 탐지 방지 포크)로 교체하여, 자동화 브라우저가 대상 웹사이트에 감지·차단될 가능성을 크게 줄입니다. 이를 통해 Chrome Relay Extension 설치 없이, 관리형 브라우저만으로도 Relay와 동등하거나 더 뛰어난 웹 수집 및 조작 능력을 달성할 수 있습니다. +📥 *저희는 nodriver, browser-use, Vercel의 agent-browser 등 현재 시장에서 인기 있는 모든 브라우저 자동화 프레임워크를 종합적으로 평가했습니다. 모두 CDP를 통해 동작하고 openclaw 전용 지속적 프로필을 제공한다는 기본 원리는 같지만, CDP 프로브를 완전히 제거하는 것은 Patchright뿐입니다. 즉, 가장 순수한 CDP 직접 연결 방식을 사용하더라도 여전히 검출 가능한 특징이 남아 있습니다. 다른 프레임워크는 데이터 수집이 아닌 자동화 테스트를 목적으로 설계되었지만, Patchright는 처음부터 데이터 수집을 목적으로 설계되었습니다. 본질적으로 Playwright의 패치이기 때문에 거의 모든 Playwright 상위 API를 그대로 계승하며, 이로 인해 openclaw와 기본적으로 호환되어 추가 플러그인이나 MCP를 설치할 필요가 없습니다.* -### 2. 자동 탭 복구 +### 2. 자동 탭 복구 메커니즘 Agent 작업 중 대상 탭이 예기치 않게 닫히거나 사라질 경우, 스냅샷 기반 탭 복구를 자동으로 수행하여 탭 소실로 인한 작업 중단을 방지합니다. -### 3. 스마트 검색 +### 3. 스마트 검색 Skill openclaw 내장 `web_search`를 더욱 강력한 검색 기능으로 대체합니다. 원버전 내장 web search tool 대비 스마트 검색의 세 가지 핵심 강점: - **완전 무료, API 키 불필요**: 서드파티 검색 API에 의존하지 않아 비용 제로 -- **실시간 검색, 최고의 시의성**: 브라우저를 직접 대상 페이지나 주요 소셜 미디어 플랫폼(Weibo, Twitter/X, Facebook 등)으로 이동하여 최신 게시물을 즉시 검색 +- **실시간 검색, 최고의 시의성**: 브라우저를 직접 대상 페이지나 주요 소셜 미디어 플랫폼(Weibo, Twitter/X, Facebook 등)으로 ��동하여 최신 게시물을 즉시 검색 - **검색 출처 사용자 정의 가능**: 사용자가 검색 출처를 자유롭게 지정하여 필요한 정보를 정확하게 취득 +### 4. 새 미디어 편집자 Crew(사전 설정 AI 에이전트) + +즉시 사용 가능한 중국어 소셜 미디어 콘텐츠 제작 AI 에이전트로, 웨이보, 샤오홍슈, 즈후, 빌리빌리, 더우인 등 중국 주요 플랫폼에 특화되어 있습니다. + +**주요 기능:** + +- 주제 리서치 + 트렌드 분석(Mode A) +- 초안 확장 + 온라인 근거 추가(Mode B) +- 기사 완성 후 [文颜(Wenyan)](https://github.com/caol64/wenyan)을 자동으로 호출하여 위챗 공식 계정 스타일 HTML로 렌더링(내장 테마 7개 지원) +- 위챗 공식 계정 임시 보관함에 직접 발행(Mode C, `WECHAT_APP_ID`/`WECHAT_APP_SECRET` 설정 필요) +- AI 이미지/영상 생성 지원([SiliconFlow](https://www.siliconflow.com/) 이미지/영상 생성, `SILICONFLOW_API_KEY` 설정 필요) + ## 🌟 빠른 시작 +> **💡 API 비용 안내** +> +> wiseflow 5.x는 openclaw의 Agent 워크플로우를 기반으로 하며, LLM API 접근이 필요합니다. 사전에 API 자격 증명을 준비하시기 바랍니다: +> +> - **해외 사용자(권장)**:[SiliconFlow](https://www.siliconflow.com/) — 등록 후 무료 크레딧 지급, 초기 사용 비용 충당 가능 +> - **OpenAI / Anthropic 및 기타 제공업체**:호환 가능한 모든 API 사용 가능 + 본 저장소의 [Releases](https://github.com/TeamWiseFlow/wiseflow/releases)에서 openclaw_for_business와 wiseflow addon이 포함된 통합 패키지를 다운로드하세요. 1. 압축 파일을 다운로드하고 압축을 해제합니다 @@ -57,7 +78,7 @@ openclaw 내장 `web_search`를 더욱 강력한 검색 기능으로 대체합 ./scripts/dev.sh gateway ``` - **프로덕션 모드**(시스템 서비스로 설치, 장기 운영용): + **프로덕션 모드**(시스템 서비��로 설치, 장기 운영용): ```bash ./scripts/reinstall-daemon.sh ``` @@ -85,25 +106,38 @@ cp -r /tmp/wiseflow/wiseflow /addons/wiseflow ## 디렉토리 구조 ``` -wiseflow/ +wiseflow/ # addon 패키지(addons/ 디렉토리에 복사) ├── addon.json # 메타데이터 ├── overrides.sh # pnpm overrides + 내장 web_search 비활성화 ├── patches/ │ ├── 001-browser-tab-recovery.patch # 탭 복구 패치 -│ └── 002-disable-web-search-env-var.patch # 내장 web_search 비활성화 (env var) -├── skills/ +│ ├── 002-disable-web-search-env-var.patch # 내장 web_search 비활성화 (env var) +│ └── 003-act-field-validation.patch # ACT 필드 유효성 검사 패치 +├── skills/ # 글로벌 스킬(모든 에이전트 사용 가능) │ ├── browser-guide/SKILL.md # 브라우저 모범 사례 (로그인/캡차/지연 로딩 등) │ ├── smart-search/SKILL.md # 다중 플랫폼 검색 URL 빌더 (내장 web_search 대체) │ └── rss-reader/ # RSS/Atom 피드 리더 │ ├── SKILL.md │ ├── package.json │ └── scripts/fetch-rss.mjs -├── docs/ # 기술 문서 -│ ├── anti-detection-research.md -│ └── more_powerful_search_skill/ -└── tests/ # 테스트 케이스 및 스크립트 - ├── README.md - └── run-managed-tests.mjs +└── crew/ # 사전 설정 AI 에이전트(Crew 템플릿) + └── new-media-editor/ # 새 미디어 편집자(중국어 소셜 미디어 콘텐츠 제작) + ├── IDENTITY.md / SOUL.md / AGENTS.md / TOOLS.md / ... + └── skills/ # Crew 전용 스킬 + ├── siliconflow-img-gen/ # AI 이미지 생성(SiliconFlow API) + ├── siliconflow-video-gen/ # AI 영상 생성(SiliconFlow API) + └── wenyan-formatter/ # Markdown → 위챗 HTML / 임시 보관함 발행 + +docs/ # 기술 문서(저장소 루트) +├── anti-detection-research.md +└── more_powerful_search_skill/ + +scripts/ # 유틸리티 스크립트(저장소 루트) +└── generate-patch.sh + +tests/ # 테스트 케이스 및 스크립트(저장소 루트) +├── README.md +└── run-managed-tests.mjs ``` ## WiseFlow Pro 버전 출시! @@ -116,8 +150,6 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 🌹 오늘부터 wiseflow 오픈소스 버전에 PR 기여(코드, 문서, 성공 사례 공유 모두 환영)가 채택되면, 기여자에게 wiseflow Pro 버전 1년 사용권이 증정됩니다! -📥 🎉 📚 - ## 🛡️ 라이선스 버전 4.2부터 오픈소스 라이선스를 업데이트했습니다. 자세한 내용은: [LICENSE](LICENSE) @@ -128,15 +160,20 @@ https://github.com/user-attachments/assets/57f8569c-e20a-4564-a669-1200d56c5725 질문이나 제안이 있으시면 [issue](https://github.com/TeamWiseFlow/wiseflow/issues)를 통해 메시지를 남겨주세요. -Pro 버전 관련 요구사항이나 협력 피드백은 WeChat으로 연락해 주세요: +🎉 wiseflow && OFB에서 현재 **유료 지식 베이스**를 제공하고 있습니다. 내용에는 단계별 설치 튜토리얼, 각종 독점 활용 팁, **VIP 위챗 그룹**이 포함됩니다: + +"掌柜的" 기업 위챗을 추가하여 문의하세요: + +wiseflow掌柜 -wechat +🌹 오픈소스 유지에 응원해 주셔서 감사합니다! ## 🤝 wiseflow 5.x는 다음의 우수한 오픈소스 프로젝트를 기반으로 합니다: - Patchright (Playwright 테스트 및 자동화 라이브러리의 탐지 우회 Python 버전) https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python - Feedparser (Python으로 피드 파싱) https://github.com/kurtmckee/feedparser - SearXNG (다양한 검색 서비스와 데이터베이스에서 결과를 집계하는 무료 인터넷 메타 검색 엔진) https://github.com/searxng/searxng +- Wenyan (다중 플랫폼 Markdown 서식 및 게시 도구, 새 미디어 편집자 Crew가 wenyan-formatter 스킬을 통해 사용) https://github.com/caol64/wenyan ## Citation @@ -149,4 +186,4 @@ https://github.com/TeamWiseFlow/wiseflow ## 파트너 -[siliconflow](https://siliconflow.com/) +[siliconflow](https://siliconflow.com/) From e56b5efaab3f6dcc70370f63ea68580f1353ef29 Mon Sep 17 00:00:00 2001 From: codes-res-by-bigbrother666sh Date: Sun, 15 Mar 2026 21:30:40 +0800 Subject: [PATCH 2/5] chore: update openclaw to v2026.3.13, patches apply cleanly --- openclaw.version | 4 +- .../patches/001-browser-tab-recovery.patch | 78 +++++++++++-------- .../patches/003-act-field-validation.patch | 64 ++------------- 3 files changed, 54 insertions(+), 92 deletions(-) diff --git a/openclaw.version b/openclaw.version index f09406c1..adfba625 100644 --- a/openclaw.version +++ b/openclaw.version @@ -7,5 +7,5 @@ # git clone https://github.com/openclaw/openclaw openclaw # git -C openclaw checkout $OPENCLAW_COMMIT # -OPENCLAW_VERSION=2026.3.12 -OPENCLAW_COMMIT=70d7a0854c54c489eaefd56bb406ad885f2b3ea2 +OPENCLAW_VERSION=2026.3.13 +OPENCLAW_COMMIT=61d171ab0b2fe4abc9afe89c518586274b4b76c2 diff --git a/wiseflow/patches/001-browser-tab-recovery.patch b/wiseflow/patches/001-browser-tab-recovery.patch index 9482237f..7796b8c7 100644 --- a/wiseflow/patches/001-browser-tab-recovery.patch +++ b/wiseflow/patches/001-browser-tab-recovery.patch @@ -1,8 +1,8 @@ diff --git a/src/agents/tools/browser-tool.actions.ts b/src/agents/tools/browser-tool.actions.ts -index 673585d16..ca0631bd7 100644 +index a4b6cb456..8fd27500c 100644 --- a/src/agents/tools/browser-tool.actions.ts +++ b/src/agents/tools/browser-tool.actions.ts -@@ -62,27 +62,36 @@ function isChromeStaleTargetError(profile: string | undefined, err: unknown): bo +@@ -81,27 +81,35 @@ function isChromeStaleTargetError(profile: string | undefined, err: unknown): bo return msg.includes("404:") && msg.includes("tab not found"); } @@ -16,23 +16,9 @@ index 673585d16..ca0631bd7 100644 - const retryRequest = { ...request }; - delete retryRequest.targetId; - return retryRequest as Parameters[1]; -+ +function isTabResolutionError(err: unknown): boolean { + const msg = String(err).toLowerCase(); + return msg.includes("tab not found") || msg.includes("ambiguous target id prefix"); -+} -+ -+function pickFallbackTargetId(tabs: unknown[]): string | undefined { -+ const list = tabs.filter((tab): tab is { targetId?: unknown; type?: unknown } => { -+ return Boolean(tab && typeof tab === "object"); -+ }); -+ const pages = list.filter((tab) => { -+ const type = typeof tab.type === "string" ? tab.type : "page"; -+ return type === "page"; -+ }); -+ const primary = pages[0] ?? list[0]; -+ const raw = primary?.targetId; -+ return typeof raw === "string" && raw.trim() ? raw.trim() : undefined; } -function canRetryChromeActWithoutTargetId(request: Parameters[1]): boolean { @@ -44,6 +30,19 @@ index 673585d16..ca0631bd7 100644 - ? typedRequest.action - : ""; - return kind === "hover" || kind === "scrollIntoView" || kind === "wait"; ++function pickFallbackTargetId(tabs: unknown[]): string | undefined { ++ const list = tabs.filter((tab): tab is { targetId?: unknown; type?: unknown } => { ++ return Boolean(tab && typeof tab === "object"); ++ }); ++ const pages = list.filter((tab) => { ++ const type = typeof tab.type === "string" ? tab.type : "page"; ++ return type === "page"; ++ }); ++ const primary = pages[0] ?? list[0]; ++ const raw = primary?.targetId; ++ return typeof raw === "string" && raw.trim() ? raw.trim() : undefined; ++} ++ +async function listTabsForRecovery(params: { + baseUrl?: string; + profile?: string; @@ -58,7 +57,7 @@ index 673585d16..ca0631bd7 100644 } export async function executeTabsAction(params: { -@@ -163,17 +172,37 @@ export async function executeSnapshotAction(params: { +@@ -182,17 +190,37 @@ export async function executeSnapshotAction(params: { labels, mode, }; @@ -107,7 +106,7 @@ index 673585d16..ca0631bd7 100644 if (snapshot.format === "ai") { const extractedText = snapshot.snapshot ?? ""; const wrappedSnapshot = wrapExternalContent(extractedText, { -@@ -308,46 +337,37 @@ export async function executeActAction(params: { +@@ -303,46 +331,37 @@ export async function executeActAction(params: { }); return jsonResult(result); } catch (err) { @@ -168,23 +167,23 @@ index 673585d16..ca0631bd7 100644 + } throw new Error( - "No Chrome tabs are attached via the OpenClaw Browser Relay extension. Click the toolbar icon on the tab you want to control (badge ON), then retry.", -+ `Chrome tab not found (stale targetId?). Run action=tabs profile="chrome" and use one of the returned targetIds.`, ++ `Chrome tab not found (stale targetId?). Run action=tabs profile="chrome-relay" and use one of the returned targetIds.`, { cause: err }, ); } - throw new Error( -- `Chrome tab not found (stale targetId?). Run action=tabs profile="chrome" and use one of the returned targetIds.`, +- `Chrome tab not found (stale targetId?). Run action=tabs profile="chrome-relay" and use one of the returned targetIds.`, - { cause: err }, - ); } throw err; } diff --git a/src/agents/tools/browser-tool.test.ts b/src/agents/tools/browser-tool.test.ts -index 81996afb4..e272ce81b 100644 +index adaaea782..9cd664527 100644 --- a/src/agents/tools/browser-tool.test.ts +++ b/src/agents/tools/browser-tool.test.ts -@@ -260,6 +260,48 @@ describe("browser tool snapshot maxChars", () => { - expect(Object.hasOwn(opts ?? {}, "maxChars")).toBe(false); +@@ -287,6 +287,48 @@ describe("browser tool snapshot maxChars", () => { + expect(opts?.mode).toBeUndefined(); }); + it("recovers snapshot when target tab disappears", async () => { @@ -229,14 +228,14 @@ index 81996afb4..e272ce81b 100644 + }); + }); + - it("routes to node proxy when target=node", async () => { - mockSingleBrowserProxyNode(); - const tool = createBrowserTool(); -@@ -617,11 +659,18 @@ describe("browser tool external content wrapping", () => { + it("defaults to host when using profile=chrome-relay (even in sandboxed sessions)", async () => { + setResolvedBrowserProfiles({ + "chrome-relay": { +@@ -745,16 +787,23 @@ describe("browser tool external content wrapping", () => { describe("browser tool act stale target recovery", () => { registerBrowserToolAfterEachReset(); -- it("retries safe chrome act once without targetId when exactly one tab remains", async () => { +- it("retries safe chrome-relay act once without targetId when exactly one tab remains", async () => { + it("recovers act by retrying with fallback tab targetId when tab is stale", async () => { browserActionsMocks.browserAct .mockRejectedValueOnce(new Error("404: tab not found")) @@ -254,18 +253,31 @@ index 81996afb4..e272ce81b 100644 const tool = createBrowserTool(); const result = await tool.execute?.("call-1", { -@@ -644,29 +693,43 @@ describe("browser tool act stale target recovery", () => { + action: "act", +- profile: "chrome-relay", ++ profile: "chrome", + request: { + kind: "hover", + targetId: "stale-tab", +@@ -767,34 +816,48 @@ describe("browser tool act stale target recovery", () => { + 1, + undefined, + expect.objectContaining({ targetId: "stale-tab", kind: "hover", ref: "btn-1" }), +- expect.objectContaining({ profile: "chrome-relay" }), ++ expect.objectContaining({ profile: "chrome" }), + ); expect(browserActionsMocks.browserAct).toHaveBeenNthCalledWith( 2, undefined, - expect.not.objectContaining({ targetId: expect.anything() }), +- expect.objectContaining({ profile: "chrome-relay" }), + expect.objectContaining({ targetId: "recovered-tab" }), - expect.objectContaining({ profile: "chrome" }), ++ expect.objectContaining({ profile: "chrome" }), ); expect(result?.details).toMatchObject({ ok: true }); }); -- it("does not retry mutating chrome act requests without targetId", async () => { +- it("does not retry mutating chrome-relay act requests without targetId", async () => { - browserActionsMocks.browserAct.mockRejectedValueOnce(new Error("404: tab not found")); - browserClientMocks.browserTabs.mockResolvedValueOnce([{ targetId: "only-tab" }]); + it("recovers act when target tab disappears (non-chrome profile)", async () => { @@ -285,14 +297,14 @@ index 81996afb4..e272ce81b 100644 - await expect( - tool.execute?.("call-1", { - action: "act", -- profile: "chrome", +- profile: "chrome-relay", - request: { - kind: "click", - targetId: "stale-tab", - ref: "btn-1", - }, - }), -- ).rejects.toThrow(/Run action=tabs profile="chrome"/i); +- ).rejects.toThrow(/Run action=tabs profile="chrome-relay"/i); + const result = await tool.execute?.("call-1", { + action: "act", + request: { kind: "click", ref: "e1", targetId: "stale-tab" }, diff --git a/wiseflow/patches/003-act-field-validation.patch b/wiseflow/patches/003-act-field-validation.patch index 9d1d67cd..13d76d08 100644 --- a/wiseflow/patches/003-act-field-validation.patch +++ b/wiseflow/patches/003-act-field-validation.patch @@ -1,8 +1,8 @@ diff --git a/src/agents/tools/browser-tool.actions.ts b/src/agents/tools/browser-tool.actions.ts -index 673585d16..52274bf46 100644 +index 8fd27500c..af0f67d3d 100644 --- a/src/agents/tools/browser-tool.actions.ts +++ b/src/agents/tools/browser-tool.actions.ts -@@ -54,6 +54,41 @@ function formatTabsToolResult(tabs: unknown[]): AgentToolResult { +@@ -73,6 +73,41 @@ function formatConsoleToolResult(result: { }; } @@ -42,9 +42,9 @@ index 673585d16..52274bf46 100644 +} + function isChromeStaleTargetError(profile: string | undefined, err: unknown): boolean { - if (profile !== "chrome") { + if (profile !== "chrome-relay" && profile !== "chrome") { return false; -@@ -295,6 +330,7 @@ export async function executeActAction(params: { +@@ -318,6 +353,7 @@ export async function executeActAction(params: { proxyRequest: BrowserProxyRequest | null; }): Promise> { const { request, baseUrl, profile, proxyRequest } = params; @@ -53,11 +53,11 @@ index 673585d16..52274bf46 100644 const result = proxyRequest ? await proxyRequest({ diff --git a/src/agents/tools/browser-tool.test.ts b/src/agents/tools/browser-tool.test.ts -index 81996afb4..713ac26f3 100644 +index 9cd664527..84cd5d043 100644 --- a/src/agents/tools/browser-tool.test.ts +++ b/src/agents/tools/browser-tool.test.ts -@@ -670,3 +670,113 @@ describe("browser tool act stale target recovery", () => { - expect(browserActionsMocks.browserAct).toHaveBeenCalledTimes(1); +@@ -861,3 +861,113 @@ describe("browser tool act stale target recovery", () => { + expect(result?.details).toMatchObject({ ok: true, targetId: "new-tab" }); }); }); + @@ -170,53 +170,3 @@ index 81996afb4..713ac26f3 100644 + expect(browserActionsMocks.browserAct).toHaveBeenCalledTimes(1); + }); +}); -diff --git a/src/agents/tools/browser-tool.ts b/src/agents/tools/browser-tool.ts -index 200013ff1..b292cff3c 100644 ---- a/src/agents/tools/browser-tool.ts -+++ b/src/agents/tools/browser-tool.ts -@@ -298,6 +298,9 @@ export function createBrowserTool(opts?: { - "When using refs from snapshot (e.g. e12), keep the same tab: prefer passing targetId from the snapshot response into subsequent actions (act/click/type/etc).", - 'For stable, self-resolving refs across calls, use snapshot with refs="aria" (Playwright aria-ref ids). Default refs="role" are role+name-based.', - "Use snapshot+act for UI automation. Avoid act:wait by default; use only in exceptional cases when no reliable UI state exists.", -+ 'act kind=click/type/hover/scrollIntoView requires ref (from a fresh snapshot); kind=press requires key (e.g. "Enter"); kind=fill requires fields (array of {ref,value} objects). Always call snapshot immediately before act — never reuse refs from a prior snapshot call.', -+ "Tab hygiene: after completing a task, close every tab you opened with action=close targetId= to avoid accumulating unused tabs.", -+ "Login heuristic: do NOT assume a social network or public site requires login just because it is social media — many platforms allow viewing and searching without an account, and the browser may already hold the user's session. Only prompt the user for login when an explicit login wall (sign-in form, OAuth redirect, 'log in to continue' gate) appears or the task provably cannot proceed without authentication.", - `target selects browser location (sandbox|host|node). Default: ${targetDefault}.`, - hostHint, - ].join(" "), -@@ -416,6 +419,9 @@ export function createBrowserTool(opts?: { - return await executeTabsAction({ baseUrl, profile, proxyRequest }); - case "open": { - const targetUrl = readTargetUrlParam(params); -+ // Remind the LLM to close this tab once the task is complete. -+ const closeHint = -+ "Tab opened. Close it when done: action=close targetId=."; - if (proxyRequest) { - const result = await proxyRequest({ - method: "POST", -@@ -423,7 +429,11 @@ export function createBrowserTool(opts?: { - profile, - body: { url: targetUrl }, - }); -- return jsonResult(result); -+ const base = jsonResult(result); -+ return { -+ ...base, -+ content: [...base.content, { type: "text" as const, text: closeHint }], -+ }; - } - const opened = await browserOpenTab(baseUrl, targetUrl, { profile }); - trackSessionBrowserTab({ -@@ -432,7 +442,11 @@ export function createBrowserTool(opts?: { - baseUrl, - profile, - }); -- return jsonResult(opened); -+ const base = jsonResult(opened); -+ return { -+ ...base, -+ content: [...base.content, { type: "text" as const, text: closeHint }], -+ }; - } - case "focus": { - const targetId = readStringParam(params, "targetId", { From ff2f5fdd3fa2c41b3327b63dc1b5c74234b9639c Mon Sep 17 00:00:00 2001 From: codes-res-by-bigbrother666sh Date: Mon, 16 Mar 2026 19:59:37 +0800 Subject: [PATCH 3/5] =?UTF-8?q?feat(addon):=20=E8=B7=9F=E8=BF=9B=20OFB=20v?= =?UTF-8?q?0.3.0=20=E6=A0=BC=E5=BC=8F=EF=BC=8C=E5=A3=B0=E6=98=8E=20externa?= =?UTF-8?q?l=5Fcrews?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - addon.json 版本升至 0.3.0,新增 external_crews 数组声明 new-media-editor (OFB v0.3.0 用 internal_crews/external_crews 替代旧 crew-type 字段) - 新增 crew/new-media-editor/DECLARED_SKILLS(外部 crew 最佳实践) - .gitignore 新增 apply-addons.sh(本地开发参考文件) --- .gitignore | 1 + wiseflow/addon.json | 7 ++++--- wiseflow/crew/new-media-editor/DECLARED_SKILLS | 13 +++++++++++++ 3 files changed, 18 insertions(+), 3 deletions(-) create mode 100644 wiseflow/crew/new-media-editor/DECLARED_SKILLS diff --git a/.gitignore b/.gitignore index 680262e0..c80945d1 100644 --- a/.gitignore +++ b/.gitignore @@ -26,3 +26,4 @@ tests/openclaw_for_business/ tests/openclaw/ openclaw/ openclaw_for_business/ +apply-addons.sh diff --git a/wiseflow/addon.json b/wiseflow/addon.json index 70a8cd61..8dc23ad8 100644 --- a/wiseflow/addon.json +++ b/wiseflow/addon.json @@ -1,6 +1,7 @@ { "name": "wiseflow", - "version": "0.2.0", - "description": "浏览器反检测 + Tab Recovery + 互联网搜索增强(smart-search / rss-reader skills + 禁用内置 web_search)", - "auto-activate": false + "version": "0.3.0", + "description": "浏览器反检测 + Tab Recovery + 互联网搜索增强(smart-search / rss-reader skills + 禁用内置 web_search)+ 新媒体小编 Crew 模板", + "auto-activate": false, + "external_crews": ["new-media-editor"] } diff --git a/wiseflow/crew/new-media-editor/DECLARED_SKILLS b/wiseflow/crew/new-media-editor/DECLARED_SKILLS new file mode 100644 index 00000000..b36ae363 --- /dev/null +++ b/wiseflow/crew/new-media-editor/DECLARED_SKILLS @@ -0,0 +1,13 @@ +# DECLARED_SKILLS — 声明式技能列表(external crew 专用) +# 格式:每行一个技能名称;# 开头为注释;支持空行 +# 注意:不声明 self-improving,对外 crew 不允许自我升级 + +# 浏览器与网络搜索(来自 wiseflow addon 全局技能) +smart-search +rss-reader +browser-guide + +# 内容创作工具(crew 模板专属技能) +siliconflow-img-gen +siliconflow-video-gen +wenyan-formatter From 48a40df5ddce514d7327c50b5f0abc7b140abad7 Mon Sep 17 00:00:00 2001 From: codes-res-by-bigbrother666sh Date: Mon, 16 Mar 2026 20:03:06 +0800 Subject: [PATCH 4/5] =?UTF-8?q?fix(addon):=20new-media-editor=20=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=20internal=20crew=EF=BC=8C=E7=A7=BB=E9=99=A4=20DECLAR?= =?UTF-8?q?ED=5FSKILLS?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- wiseflow/addon.json | 2 +- wiseflow/crew/new-media-editor/DECLARED_SKILLS | 13 ------------- 2 files changed, 1 insertion(+), 14 deletions(-) delete mode 100644 wiseflow/crew/new-media-editor/DECLARED_SKILLS diff --git a/wiseflow/addon.json b/wiseflow/addon.json index 8dc23ad8..ce64242d 100644 --- a/wiseflow/addon.json +++ b/wiseflow/addon.json @@ -3,5 +3,5 @@ "version": "0.3.0", "description": "浏览器反检测 + Tab Recovery + 互联网搜索增强(smart-search / rss-reader skills + 禁用内置 web_search)+ 新媒体小编 Crew 模板", "auto-activate": false, - "external_crews": ["new-media-editor"] + "internal_crews": ["new-media-editor"] } diff --git a/wiseflow/crew/new-media-editor/DECLARED_SKILLS b/wiseflow/crew/new-media-editor/DECLARED_SKILLS deleted file mode 100644 index b36ae363..00000000 --- a/wiseflow/crew/new-media-editor/DECLARED_SKILLS +++ /dev/null @@ -1,13 +0,0 @@ -# DECLARED_SKILLS — 声明式技能列表(external crew 专用) -# 格式:每行一个技能名称;# 开头为注释;支持空行 -# 注意:不声明 self-improving,对外 crew 不允许自我升级 - -# 浏览器与网络搜索(来自 wiseflow addon 全局技能) -smart-search -rss-reader -browser-guide - -# 内容创作工具(crew 模板专属技能) -siliconflow-img-gen -siliconflow-video-gen -wenyan-formatter From fbf727ae05c176658ede362b6b8ebc0fa96b8b0f Mon Sep 17 00:00:00 2001 From: codes-res-by-bigbrother666sh Date: Mon, 16 Mar 2026 20:12:35 +0800 Subject: [PATCH 5/5] =?UTF-8?q?fix(ci):=20=E7=94=A8=20fetch=20=20?= =?UTF-8?q?=E6=9B=BF=E4=BB=A3=20--branch=20v$VERSION=20=E5=85=8B=E9=9A=86?= =?UTF-8?q?=20openclaw?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit tag 格式为 v2026.3.13-1,与 OPENCLAW_VERSION=2026.3.13 不一致导致 --branch v2026.3.13 报错。改为直接 fetch commit hash,不依赖 tag 名。 --- .github/workflows/ci.yml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 93356a38..c5b9bcea 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -41,9 +41,10 @@ jobs: - name: Clone openclaw at pinned commit run: | - git clone --branch v${{ steps.pin.outputs.version }} --depth=1 \ - https://github.com/openclaw/openclaw.git openclaw - git -C openclaw checkout ${{ steps.pin.outputs.commit }} + git init openclaw + git -C openclaw remote add origin https://github.com/openclaw/openclaw.git + git -C openclaw fetch --depth=1 origin ${{ steps.pin.outputs.commit }} + git -C openclaw checkout FETCH_HEAD - name: Clone openclaw_for_business run: git clone --depth=1 https://github.com/TeamWiseFlow/openclaw_for_business.git openclaw_for_business