OpenClaw: бұл не, оны қалай орнатуға және Telegram-ға қосуға болады

OpenClaw өткен қыста таспамда пайда болды: жоба бір аптада атауын екі рет өзгертіп, GitHub-та жүздеген мың жұлдыз жинады. Содан бері жұрт «openclaw installation» және «openclaw telegram» деп жиі іздей бастады.

Төменде ресми құжаттаманы қарап шығамын: бұл не, Claude Code-тан айырмашылығы қандай, Windows, macOS немесе Linux жүйесіне қалай орнатуға, модельді қалай таңдауға және Telegram ботын қалай қосуға болады. Қауіпсіздікке де бөлек тоқталамын, өйткені OpenClaw-ға қатысты бірнеше кеңінен талқыланған оқиға болды.

Қызметпен жұмыс істеуді Ailoot құжаттамасынан үйреніңіз.

OpenClaw деген не? Қарапайым тілмен#

OpenClaw AI моделін Telegram ботыңызбен байланыстырады. Қажетті құралдар мен рұқсаттар бапталса, хабарламаларды қорытындылап не еске салуды жоспарлай алады. Шлюз процесі мен жергілікті конфигурация компьютеріңізде не серверіңізде жұмыс істейді. Бұл барлық әңгімені жергілікті етпейді: бұлттық модель таңдалса, сұрау мен тиісті контекст сол провайдерге беріледі. Ailoot арқылы қосылсаңыз, сұрау Ailoot арқылы таңдалған модель провайдеріне өтеді. Жергілікті модельдік өңдеу үшін жергілікті модель және бұлттық fallback-тың болмауы қажет; Telegram хабарламалары бәрібір Telegram арқылы өтеді, ал қосылған құралдар өзге желі қызметтеріне хабарласа алады.

Жобаны OpenClaw ашық бастапқы код қауымдастығы әзірлейді. GitHub репозиторийі 2025 жылғы 24 қарашада ашылды, ал 2026 жылғы 22 тамыздағы жағдай бойынша онда 387 мың жұлдыз және 81 мың форк бар — биылғы ең жылдам өскен ашық жобалардың бірі. Жоба TypeScript тілінде жазылған.

Жобаның атау тарихы қызық, ескі мақалаларды оқығанда шатаспау үшін оны білген жөн. Бастапқыда ол WhatsApp шлюзі Warelay деп аталды. Кейін Clawdbot болды. 2026 жылғы қаңтарда Anthropic тауар белгісіне байланысты атауды өзгертуді сұрап, жоба бірнеше күн Moltbot атанды. 2026 жылғы 30 қаңтарда соңғы атауы — OpenClaw берілді. Сондықтан «Clawdbot» немесе «Moltbot» туралы нұсқауларды кездестірсеңіз, ол — сол жоба; мақалалар атауы өзгермей тұрып жазылған.

Жобаның тұмары — Molty атты омар, ал «түлеу» (сауытын ауыстыру) атау өзгерістерінің ресми метафорасына айналды.

OpenClaw Claude Code пен Hermes Agent-тен несімен ерекшеленеді?#

Сырттай қарағанда бәрі «AI агенттері» сияқты көрінетіндіктен, осы айырмашылық туралы менен жиі сұрайды. Міне, салыстыру кестесі:

Мұны былай түсінуге болады. Мен Claude Code-ты әзірлеуге қолданамын: қуатты модель керек болып, кодпен жұмыс істегенде ол мықты. OpenClaw мен Hermes басқа мақсатқа арналған: үнемі жұмыс істейтін, Telegram-да болатын, кешегі әңгімені есте сақтайтын және тапсырмаларды кесте бойынша орындайтын агент. OpenClaw пен Hermes арасындағы таңдау нәзік мәселе; орнату мен баптау туралы Hermes нұсқаулығы бар.

Құрал таңдап жүрсеңіз, шолудан бастаңыз: 2026 жылы адамдар немен код жазады және AI агентіне қандай тапсырмаларды тапсыруға болады. Claude Code орнату туралы да жеке мақалам бар.

OpenClaw орнатпас бұрын не керек?#

Node нұсқасын алдын ала тексеріңіз — бұл қатаң жалғыз талап:

node --version

22.22.3+, 24.15+ және 25.9+ нұсқаларына қолдау көрсетіледі; Node 26 ұсынылады. Команда «command not found» деп қайтарса немесе нұсқасы ескі болса, уайымдамаңыз: ресми орнатушы Node-тың соңғы нұсқасын өзі жүктейді, сондықтан қолмен ештеңе орнатудың қажеті жоқ.

Қалғаны — модель таңдау. OpenClaw өздігінен ойламайды: сіз таңдаған модельді шақырады. Құнына қарай екі нұсқа бар: Anthropic, OpenAI немесе Google кілті — нақты пайдаланғаныңыз үшін провайдерге төлейсіз; немесе Ollama арқылы жергілікті модель — ақшалай шығыны жоқ, бірақ қуатты жабдық қажет етеді. Төменде екі нұсқаны бөлек бөлімдерде қарастырамын.

OpenClaw-ды macOS пен Linux жүйелеріне қалай орнатуға болады?#

Ұсынылатын жол — ресми орнатушыны пайдалану:

1. Орнатушыны іске қосыңыз

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Скрипт операциялық жүйеңізді анықтайды, Node-ты тексереді (қажет болса орнатады), OpenClaw-ды орнатады да, баптау шеберін ашады. Шебер іске қосылмай тұрып қарап шыққыңыз келсе, bash -s -- --no-onboard жалаушасын қосыңыз.

2. Орнатудың дұрыс өткенін тексеріңіз

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Бірінші команда нұсқаны көрсетеді, екіншісі конфигурацияны тексереді, ал үшіншісі шлюздің жұмыс істеп, 18789 портын тыңдап тұрғанын растайды.

npm қолдансаңыз және орнатуды өзіңіз басқарғыңыз келсе:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Бұл жерде жуырда пайда болған бір тұзақ бар, ол құжаттаманың бөлек тарауында түсіндіріледі. npm 12 әдепкіде пакетті орнату скрипттерін бұғаттайды, сондықтан --allow-scripts=openclaw жалаушасынсыз орнату allowScripts хабарламасымен тоқтайды. npm 11.15 және одан бұрынғы нұсқаларда бұл жалауша керек емес — ондай шектеу әлі жоқ. Нұсқаңызды мына командамен тексеріңіз: npm --version.

Екінші командадағы --install-daemon жалаушасы автоматты іске қосылуды баптайды: macOS-та — LaunchAgent, Linux-та — systemd қызметі. Ол қызмет менеджерінің шарттарына сай қайта жүктеуден не жүйеге кіруден кейін шлюзді бастайды. Бірақ ұйқы режиміне жол бермейді деген сөз емес және компьютер өшкенде шлюзді жұмыс істетпейді. Telegram жауаптары үшін хост ояу әрі желіге қосылған болуы керек; ноутбук ұйқыда не өшірулі кезде жауап қажет болса, үнемі қосулы сервер қолданыңыз.

OpenClaw-ды Windows жүйесіне қалай орнатуға болады?#

Бірінші нұсқа терминалдан гөрі терезелермен жұмыс істегенді қалайтындарға арналған. Windows Hub — Windows 10 (20H2+) және Windows 11 жүйесіне арналған OpenClaw-дың жергілікті қолданбасы; қазір бета нұсқасында. Windows Hub релиздері бетіне өтіп, процессорыңызға арналған орнатушыны жүктеп алыңыз: кәдімгі компьютерлерге OpenClawCompanion-Setup-x64.exe, ал ARM үшін — arm64. Орнатқан соң, Бастау мәзірінде OpenClaw Companion пайда болады; оның жүйелік трей белгішесі, чат терезесі және баптаулары бар.

Алғаш іске қосқанда қолданба «Set up locally» дегенді ұсынады — қабылдаңыз. Ол OpenClawGateway атты бөлек WSL ортасын жасап, соның ішінде шлюзді орнатып, оған қосылады. Ubuntu орнатылымыңыз бар болса, оған тимейді.

Екінші нұсқа — PowerShell арқылы:

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

Бірінші жол OpenClaw-ды орнатады, екіншісі Windows Task Scheduler арқылы автоматты іске қосылуды тіркейді. Компьютеріңіздің саясаты тапсырма жасауға тыйым салса, OpenClaw өзі қосалқы нұсқаға ауысады: Startup қалтасына таңбаша жасап, жүйеге кіргенде шлюзді іске қосады.

Үшінші нұсқа — WSL2; құжаттама оны Windows жүйесіндегі үйлесімділігі ең жоғары орындау ортасы деп атайды. Ubuntu орнатып, systemd-ні қосыңыз да, алдыңғы бөлімдегі Linux нұсқауларын орындаңыз:

wsl --install -d Ubuntu-24.04

WSL ішінде /etc/wsl.conf файлына systemd-ні қосыңыз ([boot] бөліміне systemd=true жолын енгізіңіз), PowerShell-ден wsl --shutdown командасын іске қосып, WSL-ды қайта жүктеңіз, содан соң OpenClaw-ды Linux командасымен орнатыңыз. «Distribution» мен «systemd» дегеннің не екенін білмесеңіз, Windows Hub қолданыңыз; ол мұның бәрін сіз үшін орындайды.

Модельді қалай таңдап, бастапқы баптауды аяқтауға болады?#

Модель — көмекшінің қозғалтқышы. Баптау шебері провайдерлер тізімін ұсынады; міне, қолдануға болатын үш нұсқа:

Anthropic-ке қатысты бір ыңғайлы жайт бар: Claude Code құрылғыңызға орнатылып, жүйеге кірген болсаңыз, OpenClaw сол кіру деректерін пайдалана алады. Алдымен құрылғыда claude auth login командасын орындаңыз, содан кейін OpenClaw-ға оны қолдануды айтыңыз:

openclaw models auth login --provider anthropic --method cli --set-default

Шлюз фондық қызмет ретінде жұмыс істесе (--install-daemon арқылы орнатылғандағыдай), кілт қызметке қолжетімді болуы керек. Ол үшін оны ~/.openclaw/.env файлына енгізіңіз — шебер мұны сіз үшін орындайды, сондықтан файлды қолмен өңдеудің қажеті жоқ. Өзгерістерден кейін қайта іске қосып, тексеріңіз:

openclaw gateway restart
openclaw models status

Төлем жасау қиын болса, Ollama бөліміндегі жергілікті модель — таңдауға болатын жол.

OpenClaw-ды Telegram-ға қалай қосуға болады?#

Telegram — қосудың ең жылдам жолы: сізге тек бот токені керек, бизнес аккаунтын растаудың қажеті жоқ. Құжаттамада бұл көмекшімен телефоннан хабарласа бастаудың ең оңай жолы деп көрсетілген. Міне, толық қадамдар:

1. BotFather арқылы бот жасаңыз

   Telegram-да @BotFather-мен чатты ашып (дәл осы пайдаланушы аты екеніне көз жеткізіңіз — жалғандары көп), /newbot жіберіп, ботқа атау және соңында bot болатын пайдаланушы атын таңдаңыз. Жауап ретінде 123456789:ABCdef... сияқты токен аласыз — ол ботыңыздың кілті, сондықтан оны құпиясөздей сақтаңыз.

2. Токенді OpenClaw-ға енгізіңіз

   Ең оңайы — шебер арқылы: openclaw configure командасын іске қосып, Telegram арнасын таңдаңыз. Қолмен енгізудің баламалары — channels.telegram.botToken баптауы немесе TELEGRAM_BOT_TOKEN орта айнымалысы. Құжаттамада openclaw channels login telegram командасы жоқ екені арнайы айтылған; Telegram тек токен арқылы қосылады.

3. Шлюзді іске қосып, ботқа хабар жіберіңіз

   openclaw gateway
   

   Telegram-да ботыңызды ашып, оған бірдеңе жіберіңіз. Ол сегіз таңбалы тіркеу кодымен жауап береді. Бұл — қорғаныс шарасы: жіберушіні мақұлдамайынша хабарлар өңделмейді.

4. Өзіңізді мақұлдаңыз

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Код бір сағат жарамды, сондықтан ұзақ күтпеңіз. Мақұлданған бірінші жіберуші артықшылықты командалардың иесі болады.

Адамдар жиі тап болатын екі күрделі тұс бар.

Біріншісі — топтар. OpenClaw әдепкіде барлық топты бұғаттайды: ботқа рұқсат беру үшін channels.telegram.groups баптауларын арнайы өзгертіп, топ ішінде requireMention: true режимін қосулы қалдыру керек. Сонда ол тек пайдаланушы атымен шақырғанда жауап береді де, жалпы әңгімеге араласпайды. Telegram-да да боттың өз құпиялық режимі бар: топта бот әдепкіде тек командаларды көреді. Оны @BotFather арқылы /setprivacy командасымен өшіріңіз. Өзгерткеннен кейін ботты топтан шығарып, қайта қосу қажет; әйтпесе Telegram баптауды қолданбайды.

Екіншісі — баршаға ашық қолжетімділік бермеу. Баптауларда рұқсат тізімінде жұлдызшасы бар dmPolicy: "open" режимі бар: боттың пайдаланушы атын тапқан кез келген адам оған команда бере алады. Дербес көмекші үшін бұл — құрылғыңызды басқаруды бөтен адамға беру деген сөз. Кодпен жұптастыруды қосулы қалдырыңыз немесе allowFrom параметріне өзіңіздің сандық ID-іңізді енгізіңіз.

OpenClaw-ды Ollama арқылы жергілікті модельмен қалай іске қосуға болады?#

Жергілікті модельді бұлттық fallback-сыз таңдасаңыз, модельдік өңдеу өз жабдығыңызда қалады және ақылы модель endpoint-і қажет емес. Бірақ бүкіл Telegram процесі жергілікті болмайды: хабарлар Telegram арқылы өтеді, ал қосылған онлайн құралдар деректерді өзге қызметтерге жібере алады.

1. Ollama орнатыңыз

   Орнатушыны ollama.com/download бетінен жүктеп алыңыз — macOS, Windows және Linux нұсқалары бар.

2. Модельді жүктеп алыңыз

   ollama pull gemma4
   

3. Ollama-ны OpenClaw-ға қосыңыз

   openclaw onboard
   

   Ollama провайдері мен режимін таңдаңыз: Local only (өз модельдеріңіз), Cloud only (ollama.com сайтындағы модельдер) немесе Cloud + Local. Шебер жергілікті серверді тауып, орнатылған модельдерді көрсетеді.

4. Тексеріңіз

   openclaw models list --provider ollama
   

Жарнамаға ұқсап кетпес үшін бір шектеуді ашық айтайын. OpenClaw құжаттамасында жергілікті модельмен агентті жайлы қолдану үшін екі Mac Studio толық қуатта жұмыс істегендей жабдық керегі тікелей жазылған, ал 24 GB видеокарта тек жеңіл сұрауларды кідіріспен орындай алады. Шағын әрі қатты сығылған модельдер контексті қысқартады және өзге біреудің мәтінінде жасырылған зиянды нұсқауларға төзімділігі төмен. Күнделікті тілмен айтқанда: жақсы ноутбуктағы жергілікті модель «сынап көріп, не туралы екенін түсінуге» жетеді, бірақ құралдарды пайдаланатын көмекшімен күнделікті жұмысқа бұлттағы модель әлі де әлдеқайда сенімді.

Құжаттамадағы тағы бір ескерту WSL2 + Ollama + NVIDIA GPU баптауын жасайтындарға арналған: Linux-ке арналған ресми Ollama орнатушысы қайта іске қосу саясатын «always» етіп, автоматты іске қосылуды қосады. GPU бар WSL2-де бұл құрылғыны қайта жүктелу цикліне түсіруі мүмкін. Шешімі — қызметтің автоматты іске қосылуын өшіру. Осындай жағдайға тап болсаңыз, құжаттамадағы Ollama бетінің ақауларды жою бөлімін қараңыз.

OpenClaw-ды іске қосу қаншалықты қауіпсіз?#

Алдымен бәрі бірдей түсіне бермейтін басты жайттан бастайын. OpenClaw құрылғыңызға қол жеткізеді: файлдарға, командаларға және браузерге. Құжаттамада бұл анық жазылған: жоба бір сенімді пайдаланушыға арналған, ал ботқа бөгде адамдарға қолжетімділік бермеу керек. Біреу агентке хабар жібере алса, оны компьютеріңізде әрекет жасату үшін пайдалана алады.

Практикадағы ең аз талаптар:

1. Кодпен жұптастыруды қосулы қалдырыңыз немесе рұқсат тізімін пайдаланыңыз — оны баптау туралы Telegram бөлімінде жаздым.
2. Қажет болмаса, шлюзді сырттан қолжетімді етпеңіз. Әдепкіде ол тек құрылғыңызда тыңдайды; солай қалдырыңыз.
3. Конфигурацияны өзгерткеннен кейін кіріктірілген тексерісті іске қосыңыз:

openclaw security audit

Ол ашық қолжетімділікті, тым кең құрал рұқсаттарын, әлсіз токендерді және ашық порттарды тексереді. --fix жалаушасымен кейбір мәселені автоматты түрде түзетуге болады.

Алаяқтық туралы бөлек ескерту — бұл ойдан шығарылған қауіп емес. Жоба 2026 жылғы қаңтарда атауын өзгерткенде, доменді басып алушылар ескі мекенжайларды бірнеше секундта иемденіп, крипто әмиянының сілтемесін бірден жариялады; жалған «OpenClaw әзірлеушілері» токен алаяқтығын жарнамалай бастады. Бұдан екі қатаң ереже шығады. OpenClaw-ды тек openclaw.ai немесе github.com/openclaw/openclaw мекенжайларынан жүктеңіз. Жобаның криптовалютасы жоқ: кез келген «OpenClaw токені» — алаяқтық. Ешбір жағдайда оған ақша жібермеңіз.

Орнатқаннан кейін OpenClaw не істей алады?#

Алдымен мына әрекеттерді ретімен байқап көрер едім:

1. Шлюз және модель. openclaw gateway status орындап, openclaw dashboard ашыңыз. Панельдің жүктелуі Control UI қолжетімді екенін ғана көрсетеді. Чатта «Модель қосылымын сынау деп жауап бер» деп жіберіп, AI жауабы келгенін тексеріңіз; бет ашылуы модельді тексермейді.
2. Telegram және қажетті тапсырма. Ботты баптап, өз жұптастыруыңызды мақұлдаған соң Telegram-да сол ботқа жаңа хабар жіберіп, жауаптың сонда келгенін тексеріңіз. Кейін рұқсат етілген зиянсыз сынақ қалтасын қорытындылау сияқты бір шектеулі тапсырманы тексеріңіз. Еске салуда сақталған кесте мен жеткізілген хабарды бөлек тексеріңіз. Панельдегі жауап Telegram жеткізілуін не жоспар орындалуын дәлелдемейді.
3. Жоспарланған тапсырмалар. Көмекші жұмысты кесте бойынша орындай алады — мысалы, Telegram-дағы таңғы қорытындыны жіберу немесе поштаны мезгіл-мезгіл тексеру. Сондықтан шлюзді тәулік бойы іске қосып қоясыз.
4. Жад. OpenClaw ұзақ мерзімді жадын жұмыс қалтасындағы кәдімгі Markdown файлдарында сақтайды: сіз кімсіз, сізге қалай жауап беру керек және бұрынғы әңгімелерден нені есте сақтады. Файлдарды ашып, өзіңіз оқи аласыз — бәрі ашық көрсетіледі.
5. Қосымша дағдылар. Жүйені дайын дағдылар мен плагиндер арқылы кеңейтуге болады. Басқа біреудің дағдысы — құрылғыңызда орындалатын басқа біреудің коды, сондықтан оны орнатпас бұрын тексеріңіз.

Бір лебіз бар: бәрін бірден қоспаңыз. Алдымен бір тұрақты әңгімені, содан кейін Telegram-ды, соңында кестелерді баптаңыз. Сонда әр ақау өз қадамында байқалады да, «бәрі істемей қалды, қай жерден екенін білмеймін» деген жағдай туындамайды.

Орнату кезінде ақау шықса не істеу керек?#

Жиі кездесетін үш жағдайды қарастырайық.

Орнатқаннан кейін бірден “openclaw: command not found” шығады. Көбіне бұл — жолға қатысты мәселе: npm ғаламдық пакеттер қалтасы терминалдың PATH ортасына қосылмаған. Құжаттамада мына диагностикалық командалар берілген:

node -v
npm prefix -g
echo "$PATH"

Екінші команда шығарған жол үшінші команданың нәтижесінде болуы керек. Болмаса, оны shell баптауларына қосыңыз немесе терминалды жауып, қайта ашыңыз: кейде орнатқаннан кейін Node жолы жаңа сеанста ғана пайда болады.

Шлюз жұмыс істеп тұр, бірақ көмекші үндемейді. Құжаттамадағы жиі қойылатын сұрақтар бөлімінде сипатталған белгі: алғашқы хабарға жауап жоқ, ал токен есептегіші нөлде тұр. Бұл агенттің мүлде іске қосылмағанын білдіреді — көбіне модель конфигурацияланбаған. Мына ретпен тексеріңіз:

openclaw gateway restart
openclaw status
openclaw models status

Модель конфигурацияланғанымен жауап болмаса, openclaw logs --follow командасы тікелей журналды және кідіріс қай жерде болып жатқанын көрсетеді.

Telegram боты жауап бермейді. Мына ретпен тексеріңіз: токеніңіз хабарласып отырған ботқа тиесілі; шлюз жұмыс істеп тұр (openclaw gateway status); жұптастыруыңыз мақұлданған (openclaw pairing list telegram). Жұптастыру коды бір сағат жарамды — ботқа кеше хабар жіберген болсаңыз, қайта хабарласып, жаңа кодты мақұлдаңыз.

Мүлде тұйыққа тірелсеңіз, құжаттамада тосын көрінгенімен орынды кеңес бар: диагностика нәтижесін құрылғыңызды көре алатын жергілікті AI агентіне беріңіз. openclaw status --all және openclaw doctor нәтижелерін алған Claude Code немесе Codex конфигурацияны қолдау чатына қарағанда тезірек түсіне алады. Дөңгелек тұйықталды — AI AI-ды түзетеді.

OpenClaw туралы тағы қандай сұрақтар қойылады?#

Ailoot-пен танысыңыз.