1. Uanzishaji na Usanidi
openclaw init
Huunda mradi mpya wa OpenClaw katika saraka ya sasa, ukisanidi faili muhimu za mradi.
Tumia amri hii kuanza mradi wowote mpya wa uchimbaji data na uhakikishe muundo sahihi wa mradi.
openclaw config set api_key
Huweka ufunguo wa API wa OpenClaw kwa uthibitishaji na ufikiaji wa huduma za hali ya juu za wingu.
Hifadhi ufunguo wako wa API kwa usalama na usiwahi kuushiriki hadharani. Tumia vigezo vya mazingira kwa uzalishaji.
openclaw update
Husasisha OpenClaw kwa toleo la hivi karibuni, ikihakikisha una vipengele na marekebisho mapya zaidi.
Sasisha OpenClaw mara kwa mara ili kufurahia utendaji bora, usalama ulioboreshwa, na vipengele vipya.
openclaw auth login
Hukuwezesha kuingia kwenye akaunti yako ya OpenClaw kwa kutumia kitambulisho chako cha mtumiaji kwa ajili ya huduma za wingu.
Ingia ili kufikia miradi iliyohifadhiwa wingu, kusimamia kazi zilizopangwa, na kushirikiana na timu yako.
2. Uchimbaji wa Data Msingi
openclaw scrape url --selector "CSS_SELECTOR"
Huchimba maandishi au sifa kutoka kwa kipengele kimoja cha HTML kwa kutumia kiteuzi maalum cha CSS kutoka URL iliyotolewa.
Tumia kiteuzi sahihi cha CSS ili kulenga kipengele unachotaka kwa usahihi. Kwa mfano, `h1.title` au `div#content`.
openclaw extract url --pattern "REGEX_PATTERN"
Huchimba data inayolingana na muundo maalum wa Regex kutoka kwa maudhui ya ukurasa wa wavuti.
Regex ni nzuri kwa kuchimba nambari za simu, barua pepe, nambari za bidhaa, au tarehe kutoka kwa maandishi yasiyo na muundo.
openclaw get links url
Huchimba viungo vyote (hrefs) kutoka kwa ukurasa maalum wa wavuti na kuzionyesha kama orodha.
Ongeza `--filter "domain.com"` ili kupunguza viungo kwa kikoa maalum au `--unique` kupata viungo vya kipekee pekee.
openclaw text url --xpath "//DIV[@CLASS='CONTENT']"
Huchimba maandishi kutoka kwa kipengele cha HTML kwa kutumia njia ya XPath, ikitoa kubadilika zaidi kuliko CSS selectors.
XPath inatoa kubadilika zaidi kwa kulenga vipengele kulingana na mahusiano yao au sifa maalum katika miundo tata ya HTML.
3. Uchimbaji wa Data wa Juu
openclaw crawl url --depth 2 --output data.json
Huchunguza kurasa nyingi za wavuti kuanzia URL maalum na kina kilichobainishwa, ikihifadhi matokeo katika faili ya JSON.
Tumia `--ignore-robots` kwa tovuti ambazo hazijali faili za robots.txt (tumia kwa tahadhari na heshima kwa sheria za tovuti).
openclaw paginate url --next-selector "a.next" --limit 5
Huchimba data kutoka kurasa zenye pagination, ikifuata kiungo cha 'ukurasa unaofuata' hadi kikomo maalum cha kurasa.
Hakikisha `next-selector` inalenga kiungo sahihi cha ukurasa unaofuata. Tumia `openclaw debug` kuthibitisha.
openclaw form submit url --data '{"field":"value"}'
Hutuma fomu ya wavuti na data maalum ya JSON au faili, ikirudisha jibu la ukurasa au matokeo.
Tumia `--method post` au `--method get` kulingana na jinsi fomu inavyopaswa kutumwa. Angalia 'network' tab katika dev tools.
openclaw js-render url --wait 5s --selector "div#dynamic-content"
Hupakua ukurasa, inasubiri JavaScript itekeleze kwa muda maalum, kisha huchimba kutoka kwa DOM iliyotolewa.
Ni muhimu kwa tovuti zinazotumia sana JavaScript au Single Page Applications (SPAs) ambazo hupakia maudhui baada ya mzigo wa awali.
4. Uchakataji na Hifadhi ya Data
openclaw process data.json --filter 'price > 100'
Huchuja data kutoka faili ya JSON kulingana na masharti yaliyotolewa, ikirudisha data iliyochujwa.
Unaweza kutumia misemo changamano ya kulinganisha na `AND`/`OR` kwa uchujaji wa hali ya juu, mfano: `'category == "Electronics" AND price < 500'`.
openclaw transform data.json --map '{"old_key":"new_key", "price": "bei_ya_bidhaa"}'
Hubadilisha muundo wa data katika faili ya JSON kwa kubadili majina ya funguo, kurekebisha thamani, au kuunda funguo mpya.
Tumia `--template "jinja_template.j2"` kwa mabadiliko tata zaidi ya data, kama vile kuunganisha au kuunda muundo mpya.
openclaw export data.json --format csv --output products.csv
Husafirisha data kutoka faili ya JSON kwenda kwa umbizo tofauti kama CSV, Excel, au XML kwa matumizi rahisi.
Jaribu umbizo tofauti kulingana na mahitaji ya programu yako inayofuata au zana za uchambuzi wa data.
openclaw store data.json --db postgres --table items
Huhifadhi data iliyochimbwa moja kwa moja kwenye hifadhidata maalum (k.m., PostgreSQL, MySQL, MongoDB).
Sanidi vigezo vya muunganisho wa hifadhidata (kama vile host, user, password) katika faili yako ya `openclaw.config` au vigezo vya mazingira.
5. Usimamizi wa Miradi na Uendeshaji
openclaw project create
Huunda mradi mpya wa OpenClaw katika wingu, ukifungua rasilimali za usimamizi wa timu na ushirikiano.
Tumia majina ya miradi yenye maelezo mafupi ili kurahisisha utambuzi na usimamizi wa miradi mbalimbali.
openclaw schedule task "scrape_daily.json" --cron "0 0 * * *"
Hupanga kazi ya uchimbaji data (iliyofafanuliwa katika faili ya JSON) kutekelezwa kiotomatiki kwa ratiba maalum ya Cron.
Kazi za ratiba ni bora kwa kukusanya data mara kwa mara, mfano, kila siku, kila wiki, au kila saa, kwa ufuatiliaji wa bei au habari.
openclaw monitor job
Hufuatilia hali na maendeleo ya kazi ya uchimbaji data inayoendelea, ikionyesha logi na takwimu.
Tumia `--live` kufuatilia logi za kazi kwa wakati halisi, kusaidia utatuzi wa matatizo ya haraka.
openclaw deploy script "my_scraper.py"
Hupeleka hati maalum ya Python au JavaScript kwenye mazingira ya wingu ya OpenClaw kwa utekelezaji uliodhibitiwa.
Hakikisha hati zako zimejaribiwa vizuri na zina utunzaji wa makosa kabla ya kupeleka kwenye mazingira ya uzalishaji.
6. Msaada na Utatuzi wa Matatizo
openclaw help
Huonyesha orodha ya amri zote zinazopatikana za OpenClaw CLI na maelezo yao mafupi.
Tumia `openclaw help
openclaw version
Huonyesha toleo la sasa la OpenClaw CLI lililosakinishwa kwenye mfumo wako.
Toa toleo hili unaporipoti hitilafu au maswali ya usaidizi kwa timu ya OpenClaw ili kusaidia utambuzi.
openclaw log view --level error
Huonyesha logi za OpenClaw, zikisaidia kutambua na kutatua matatizo au kuona ujumbe wa onyo.
Tumia `--tail` kuona logi mpya zaidi pekee au `--follow` kufuata logi mpya zinapoonekana.
openclaw debug url --verbose
Huchunguza ukurasa wa wavuti, ikionyesha maelezo ya kina ya mchakato wa uchimbaji, ikisaidia kutatua matatizo.
Hali ya `verbose` hutoa maelezo ya ziada ya jinsi OpenClaw inavyochambua ukurasa, ikiwemo miundo ya DOM na majibu ya mtandao.