Ultimate Reference

Mwongozo wa Haraka wa OpenClaw CLI

Zana Yako Kuu ya AI kwa Uchimbaji Data wa Wavuti na Otomatiki

1. Uanzishaji na Usanidi

openclaw init
Copied!

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
Copied!

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
Copied!

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
Copied!

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"
Copied!

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"
Copied!

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
Copied!

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']"
Copied!

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
Copied!

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
Copied!

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"}'
Copied!

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"
Copied!

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'
Copied!

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"}'
Copied!

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
Copied!

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
Copied!

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
Copied!

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 * * *"
Copied!

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
Copied!

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"
Copied!

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
Copied!

Huonyesha orodha ya amri zote zinazopatikana za OpenClaw CLI na maelezo yao mafupi.

Tumia `openclaw help ` kwa maelezo maalum, chaguo, na mifano ya amri fulani.

openclaw version
Copied!

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
Copied!

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
Copied!

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.

Maswali Yanayoulizwa Mara Kwa Mara (FAQs)

OpenClaw ni nini?

OpenClaw ni zana ya hali ya juu ya AI CLI inayotumika kwa uchimbaji wa data wa wavuti na otomatiki. Inawawezesha watumiaji kukusanya na kuchakata data kutoka kwenye tovuti kwa ufanisi na haraka, ikitumia uwezo wa akili bandia.

Ninawezaje kuanza kutumia OpenClaw?

Anza kwa kusakinisha OpenClaw CLI kwenye mfumo wako. Kisha, tumia amri ya `openclaw init` kuunda mradi mpya. Baadaye, unaweza kutumia amri za `scrape` au `crawl` kuanza uchimbaji data kutoka kwenye tovuti.

Je, OpenClaw inasaidia tovuti zinazotumia JavaScript?

Ndiyo, OpenClaw inasaidia uchimbaji wa data kutoka tovuti zinazotumia JavaScript sana kupitia amri ya `openclaw js-render`. Amri hii huruhusu JavaScript kutekelezwa kikamilifu kabla ya uchimbaji, ikihakikisha maudhui yote yanapatikana.

Je, ninaweza kuhifadhi data iliyochimbwa kwenye hifadhidata?

Ndiyo, OpenClaw inatoa amri ya `openclaw store` ambayo inakuwezesha kuhifadhi data iliyochimbwa moja kwa moja kwenye hifadhidata mbalimbali kama PostgreSQL, MySQL, au MongoDB, kurahisisha mchakato wa uhifadhi wa data.