Bidu u Konfigurazzjoni
openclaw init
Oħloq proġett ġdid ta' OpenClaw fl-folder kurrenti. Dan iwaqqaf l-istruttura bażika tal-fajls.
Uża isem deskrittiv għall-proġett tiegħek biex iżżomm l-organizzazzjoni.
openclaw config set <ċavetta>
Issettja valur ta' konfigurazzjoni globali jew speċifiku għall-proġett. Utli għal keys tal-API jew settings default.
Uża openclaw config list biex tara l-konfigurazzjonijiet kurrenti kollha.
openclaw login --api-key <ċavetta_api>
Idħol fis-servizzi ta' OpenClaw billi tuża l-API key tiegħek. Essenzjali għal funzjonalitajiet avvanzati.
Żomm l-API key tiegħek sigura u qatt ma taqsamha pubblikament.
openclaw update
Aġġorna l-installazzjoni ta' OpenClaw għall-aħħar verżjoni disponibbli. Dan jiżgura li jkollok l-aħħar karatteristiċi u bug fixes.
Aġġorna regolarment biex tibbenefika minn titjib fil-prestazzjoni u s-sigurtà.
Estrazzjoni Bażika tad-Data
openclaw scrape --selector "h1.title"
Estrai test jew attributi minn element speċifiku fuq paġna web billi tuża selettur CSS.
Għal seletturi kumplessi, ikkunsidra li tuża l-għodod tal-iżviluppatur tal-browser tiegħek.
openclaw get --url --xpath "//div[@id='content']/p[1]"
Niżżel l-ewwel paragrafu ġewwa div b'id 'content' minn URL speċifikata, billi tuża XPath.
XPath huwa aktar flessibbli minn CSS għal xi każijiet ta' użu speċifiċi, speċjalment għal navigazzjoni bbażata fuq it-test.
openclaw extract --file --json-map
Estrai data minn fajl HTML lokali billi tuża fajl ta' mapping JSON definit minn qabel.
Il-fajl tal-mapping jista' jiddefinixxi diversi punti ta' data biex jiġu estratti f'daqqa.
openclaw list --url --items 'div.product' --fields 'title:h2,price:.price,link:a@href'
Estrai lista ta' oġġetti (eż., prodotti) minn paġna, billi tispeċifika s-selettur tal-oġġett u l-oqsma fi ħdan kull oġġett.
Uża @attribut biex estrai l-valuri tal-attributi minflok it-test tal-element.
Navigazzjoni u Crawling
openclaw follow --url --links 'a.next-page, a.item-link'
Segwi links speċifiċi minn paġna tal-bidu. Dan jippermetti navigazzjoni kkontrollata bejn il-paġni.
Tista' tispeċifika seletturi multipli biex issegwi diversi tipi ta' links.
openclaw crawl --start-url --depth 2 --pattern 'eżempju.com/prodotti/*'
Ikkrawlja sit web sa fond speċifikat, u żomm mal-mudell tal-URL definit.
Uża pattern biex tillimita l-crawling għal partijiet speċifiċi tas-sit u tevita li tikkrawlja siti esterni.
openclaw sitemap --url --output
Estrai l-URLs kollha elenkati f'fajl sitemap XML u esportahom f'fajl CSV.
Is-sitemaps huma mod effiċjenti biex tiskopri l-paġni kollha f'sit web kbir.
openclaw paginate --base-url 'https://eżempju.com/lista?paġna=' --range 1-10 --output
Iġġenera serje ta' URLs b'paġinazzjoni numerika u salvahom f'fajl.
Dan huwa utli għal siti li jużaw numri fil-parametri tal-URL għall-paġinazzjoni.
Manipulazzjoni u Esportazzjoni tad-Data
openclaw clean --input --rules
Naddaf data estratt billi tapplika sett ta' regoli definiti f'fajl JSON. Eżempji: tneħħija ta' spazji, konverżjoni tat-tip.
Il-fajl tar-regoli jista' jinkludi operazzjonijiet regex u ta' sostituzzjoni.
openclaw transform --input --script
Trasforma data estratt bl-użu ta' skript JavaScript personalizzat għal loġika kumplessa.
Skripts JavaScript jippermettulek tagħmel kalkoli, kondizzjonijiet, u formattjar avvanzat.
openclaw export --format csv --input --output
Esporta data minn fajl JSON għal format ieħor bħal CSV, Excel, jew SQL.
OpenClaw jappoġġja diversi formati ta' esportazzjoni, agħżel dak li jaqbel l-aħjar għall-bżonnijiet tiegħek.
openclaw merge --files 'parti1.json,parti2.json' --output
Għaqqad fajls multipli ta' data (eż., minn skraps separati) f'fajl wieħed konsolidat.
Dan huwa utli meta tkun qed tiskrapja data f'biċċiet u trid tgħaqqadhom flimkien.
Interazzjoni Avvanzata
openclaw click --url --selector '#btnSubmit'
Issimula klikk fuq element speċifiku fuq paġna web. Utli għal buttuni, links, jew elementi interattivi.
Uża dan għal paġni li jeħtieġu interazzjoni tal-utent biex jiżvelaw kontenut.
openclaw fill --url --form '#loginForm' --data 'username:utent,password:sigriet'
Imla formola fuq paġna web b'data speċifika u possibbilment ibgħatha.
Il-valuri tad-data huma koppji isem_qasam:valur.
openclaw screenshot --url --output --full-page
Ħu screenshot tal-paġna web kollha jew ta' parti minnha. Utli għall-debugging jew dokumentazzjoni.
Uża l-għażla --full-page biex taqbad il-kontenut kollu li jista' jiġi skrolljat.
openclaw wait --url --selector '.dynamic-content' --timeout 15
Stenna li element speċifiku jidher fuq il-paġna (eż., kontenut li jitgħabba b'mod dinamiku) qabel ma tipproċedi.
Żid timeout biex tevita li l-kmand jistenna għal dejjem jekk l-element ma jidhirx.
Skedar u Awtomazzjoni
openclaw schedule --task --cron "0 0 * * *"
Skeda task ta' OpenClaw biex titħaddem f'intervalli speċifiċi billi tuża l-format Cron.
Il-fajl task.json jista' jiddefinixxi serje ta' kmandi ta' OpenClaw jew skript.
openclaw monitor --url --selector '.price' --diff-threshold 0.05
Immonitorja bidliet f'element speċifiku fuq paġna web u attivat notifika jekk tinqabeż limitu ta' differenza.
Dan huwa perfett għall-monitoraġġ tal-prezzijiet jew bidliet fil-kontenut.
openclaw webhook --event 'scrape_complete' --target 'https://api.eżempju.com/notifika'
Ibgħat notifika webhook lil URL speċifikat meta jitlesta avveniment, bħal tlestija ta' scrape.
Uża webhooks biex tintegra OpenClaw ma' sistemi oħra jew servizzi ta' notifika.
openclaw run --script
Mexxi skript ta' awtomazzjoni JavaScript jew Python li jista' jikkontrolla OpenClaw b'mod programmatiku.
Għal awtomazzjoni kumplessa u flussi tax-xogħol personalizzati, l-iskripts huma l-aktar mod flessibbli.