Openclaw(Moltbot /Clawdbot) : Орнату нұсқаулығы+ API хостинг жөніндегі нұсқаулық

Бұл өзгерістің алдыңғы шебінде Moltbot (бұрын Clawdbot деп аталған) тұр — жоба бірнеше апта ішінде 60,000 GitHub жұлдызына ие болып, тар нишалық әзірлеуші құралы деңгейінен вирустық сенсацияға айналды. Peter Steinberger жасаған Moltbot AI агентінің «қабық жаңартуы» ұғымын білдіреді — веб-интерфейстердің шектеулерін тастап, күнделікті пайдаланатын хабарласу қолданбалары мен файл жүйелеріне қоныстану.

Соңғы назар: жоба Clawdbot-тан Moltbot-қа ребрендинг жасады — Anthropic тарапынан сауда белгісіне қатысты өтініштен кейін, өйткені «Clawd» атауы «Claude»-қа тым ұқсас естілген.

Moltbot (Clawdbot) деген не және неге вирустық танымал?

Moltbot — қуатты Үлкен тілдік модельдерге (LLMs) мен сіздің жергілікті компьютерыңызға аралық көпір болуға арналған ашық бастапқы, өзін-өзі хосттайтын AI агент. «Қоршалған бақ» секілді браузер қойындыларында жұмыс істейтін ChatGPT немесе Claude.ai-ден айырмашылығы, Moltbot сіздің жабдығыңызда (Mac, Linux немесе VPS) Gateway ретінде іске қосылады.

Ол Telegram, WhatsApp және Slack сияқты платформалардан келген табиғи тілдегі хабарламаларды машинаңызда орындалатын әрекеттерге аударады. Дүкенде жүргенде үстел үстіндегі файлды табу керек болсын немесе телефоныңыздан күрделі деплоймент скриптін іске қосу керек болсын, Moltbot толық жүйелік қолжетімділігі бар сандық прокси ретінде әрекет етеді.

Неліктен ол өзгеше

• Жергілікті орындалу және құралдар: Moltbot хостыңызда (келісіммен) командаларды шын мәнінде орындай алады, сыртқы API-ларды шақырады және шағын бағдарламалар немесе markdown арқылы анықталған жұмыс ағындары болып табылатын “skills”-терді қолданады.
• Көп арналы: сіз Telegram, WhatsApp, Slack, Discord және басқалардан бір ассистентті қолданасыз — ол сізге проактивті хабар жібере алады.
• Жад және тұрақтылық: Moltbot жұмыс кеңістікте жад файлдарын (Markdown) сақтайды және оларды индекстейді, сол арқылы ассистент сессиялар арасында “есте сақтайды” (толығырақ төменде).

Негізгі мүмкіндіктер қысқаша

Clawdbot мәліметтер қорысыз бәрін қалай «есте сақтайды»?

Moltbot-тың ең инновациялық қырларының бірі — оның мөлдір жад архитектурасы. Көптеген AI құралдары сессиялар арасында «амнезияға» ұшырайды. Moltbot мұны жұмыс кеңістігіңіздегі қарапайым Markdown файлдарының қабатты жүйесі арқылы шешеді. Бұл тәсіл сіздің AI сіз туралы не білетінін дәл оқуға, өңдеуге және аудиттеуге мүмкіндік береді.

Жад дизайны қандай және ол қалай жұмыс істейді?

Moltbot-тың жады әдейі қарапайым және аудиттелетін: жад — агент жұмыс кеңістігіндегі қарапайым Markdown файлдары. Файлдар — ақиқаттың көзі; модель тек дискіге жазылғанды ғана “есте сақтайды”. Әдепкі орналасу:

• memory/YYYY-MM-DD.md — күнделікті тек қосуды ғана қолдайтын логтар (ассистент сессия басталғанда бүгінгі және кешегі күнді оқиды).
• MEMORY.md — сіз басқаратын және тек жеке сессияларға жүктелетін өңделген ұзақ мерзімді жад.

Бұл дизайнның екі үлкен артықшылығы бар:

1. Аудит мүмкіндігі — ассистент жад ретінде қолданатынды оқып, өңдей аласыз.
2. Құралдарға қарапайымдылық — жад плагиндері вектор/BM25 индекстеуді қамтамасыз етіп, агентке релевантты жад жазбаларын жылдам іздеуге мүмкіндік береді.

Техникалық тәсіл

• Әңгіме/сессия қоймасы: Gateway сессияларды бақылайды және тиісті контексті агенттің орындау ортасына жібереді. Бұл агентке хабарлар мен арналар арасында әңгіменің күйін сақтауға мүмкіндік береді.
• Индекстелген жергілікті деректер: Moltbot жергілікті файлдар мен құжаттарды индекстей алады және оларды іздеу құралдары (семантикалық немесе кілтсөз арқылы) арқылы алу үшін ұсынады. Осылайша агент сіздің жиналыс жазбаларыңызды, үзінділеріңізді немесе кодыңызды «есте сақтай» алады.
• Құрал шығулары және жад примитивтері: Skills пен құралдар тұрақты қоймаға (дерекқор немесе файл жүйесі) жаза алады, ал Moltbot кейінгі промпттарда сол жазбаларға сілтеме жасай алады. Көптеген орнатулар шағын конфигурациялар үшін SQLite, Postgres немесе жергілікті JSON/YAML қолданады.
• LLM embeddings және вектор қоймасы: Семантикалық қайта шақыру үшін әдеттегі үлгі — құжаттарды эмбеддинг жасап, векторларды векторлық ДБ-да сақтау, содан соң ең жақын көршілерді промпттарға қосу үшін алу. Moltbot архитектурасы модельге тәуелсіз құрал шақыруды қолдайды, сондықтан сіз өзіңіздің эмбеддинг + вектор қоймасы комбинацияңызды қоса аласыз.

Қауіпсіздік ескертпесі: жад тұрақты және skills хостта командалар орындай алатындықтан, ұсынылатын әдепкі баптаулар консервативті: белгісіз жіберушілер үшін DM арқылы жұптастыру, негізгі емес сессиялар үшін sandboxing және қауіпті конфигурацияларды айқындау үшін moltbot doctor тексерісі. Қауіпсіздік құжаттамасын әрдайым қарап шығыңыз және кіріс хабарламаларды сенімсіз енгізу ретінде қарастырыңыз.

Жад иерархиясы

Moltbot-қа «Есептерді PDF форматында ұнататынымды есте сақта» десеңіз, ол мұны жасырын SQL дерекқорына сақтамайды. Ол тікелей USER.md файлын ашып, жаңа маркерлі пункт қосады. Бұл агентке бірнеше апта бойы контекстті сақтауға мүмкіндік береді, осылайша ол әр таң сайын жаңадан басталатын инстанс емес, шынайы жеке көмекші болып сезіледі.

---

Moltbot орнату нұсқаулығы: алғышарттар және инсталляция

Төменде macOS/Linux (Ubuntu) жүйелерінде базалық Moltbot инстансын іске қосу үшін практикалық тексеру тізімі мен командалар берілген. Бұл ықшам, продакшнға бағытталған нұсқаулық — егер сізге GUI немесе басқарылатын хост керек болса, API хостинг бөліміне өтіңіз.

Қажетті нәрселер (алғышарттар)

• macOS немесе Linux жүйесінде жұмыс істейтін машина (Windows WSL2 арқылы жұмыс істей алады). Gateway және CLI үшін Node.js v22+ қажет.
• Мәтіндік редактор және shell-мен базалық таныстық.
• Кем дегенде бір LLM API кілті (OpenAI, Anthropic, Venice немесе Ollama сияқты жергілікті модель) — Moltbot өзі модельге тәуелді емес.
• Қосымша: Егер контейнерлік деплой қажет болса, Docker.

Қадам-қадамымен орнату

1. Пакетті орнатыңыз: Терминалда келесі команданы орындаңыз: npm install -g clawdbot@latest
2. Онбординг шеберін іске қосыңыз: Шебер — орнатудың өзегі. Ол қауіпсіздік растауларынан және модель таңдаудан өткізеді. clawdbot onboard --install-daemon
3. Қауіпсіздік тәуекелдерін растаңыз: Moltbot машинаңызға «root-секілді» қолжетімділігі бар екенін растауды сұрайды. Жалғастыру үшін растауды теруіңіз керек.
4. Gateway-ді баптаңыз: Шебер clawdbot gateway-ді фондық қызмет ретінде орнатады (Mac-та launchd, Linux-та systemd), сондықтан ол 24/7 онлайн тұрады.

Жылдам орнату (macOS / Linux)

Бұл мысал ресми құжаттарды қайталайтын ұсынылатын git + npm әдісін қолданады.

# Clone and enter repo
git clone https://github.com/moltbot/moltbot.git
cd moltbot

# Install via npm (global CLI) or run locally
npm install -g @moltbot/cli   # or: npm ci && npm run build

# Create environment file from example
cp .env.example .env

# Edit .env and add your API keys (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)
# Then run onboarding
moltbot onboard --install-daemon
moltbot start

Docker (негізгі)

# docker-compose.yml (simplified)
version: "3.8"
services:
  moltbot:
    image: moltbot/moltbot:latest
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - OTHER_KEYS=...
    volumes:
      - ./data:/app/data
    ports:
      - "3000:3000"

Осымен іске қосыңыз:

docker compose up -d

Орнатудан кейін: хабарласу арнасын жұптастыру

Moltbot бірнеше арнаны қолдайды. Жұптастыру, әдетте, gateway UI немесе CLI арқылы жұптастыру токенін генерациялауды және Telegram боты немесе WhatsApp аккаунтын қосу үшін шағын «жұптастыру URL-ін» қолдануды қамтиды — нақты қадамдар таңдаған арна коннекторына байланысты (Telegram Bot API vs. grammY wrapper, WhatsApp Baileys арқылы және т.б.). moltbot connect telegram немесе moltbot connect whatsapp құжаттарын қараңыз.

Telegram арқылы Moltbot көмегімен компьютерімді қалай басқаруға болады (қадам-қадамымен)?

Төменде Telegram хабарламалары арқылы хостты басқару үшін қауіпсіз, практикалық нұсқаулық берілген — қашықтан әкімшілеу, скрипттерді іске қосу, логтарды алу немесе Moltbot-қа шағын жұмысты орындауды сұрау үшін пайдалы. Маңызды қауіпсіздік ескертпесі: Gateway-ді ашық Интернетке API токен мен firewall-сыз шығармаңыз; тек сенімді Telegram пайдаланушыларға ботыңызға хабарласуға рұқсат етіңіз.

1) BotFather арқылы Telegram ботын жасаңыз

1. Telegram-да @BotFather-ға хабарлама жіберіңіз.
2. /newbot жіберіп, нұсқауларды орындаңыз.
3. Бот токенін көшіріңіз 123456789:ABC-... (BotFather оны көрсетеді).

2) Токенді gateway-ге қосыңыз

Ортаны немесе конфигурацияны баптаңыз:

export TELEGRAM_BOT_TOKEN="123456789:ABC-..."
# or add to your gateway's config file:
# channels:
#   telegram:
#     botToken: "123456789:ABC-..."

Сондай-ақ токенді CLI нұсқаңызға байланысты moltbot channels add немесе moltbot configure командалары арқылы қосуға болады. Telegram құжаттары бұл жылдам орнату жолын көрсетеді.

3) Онбординг шеберін іске қосып, Telegram-ды таңдаңыз

Іске қосыңыз:

moltbot onboard --install-daemon

Шебер барысында:

• Модель провайдерін таңдаңыз (Anthropic Opus, OpenAI немесе жергілікті).
• Арналар сұралғанда, Telegram таңдаңыз және токенді қойыңыз.
• Ботпен кім хат жаза алатынын шектеу үшін жұптастыру/allowlist баптаңыз (маңызды — тек өзіңіз басқара алуы үшін user ID-іңізді қойыңыз).

Қауымдастық нұсқаулықтары және онбординг процесі түйінді жұптауды дәлелдеу үшін хосттан шағын команданың шығысын қоюды сұрайды — нұсқауларды орындаңыз.

4) exec құралын және рұқсат берулерді қауіпсіз қосыңыз

Moltbot exec құралы арқылы жүйелік командаларды орындай алады, бірақ ол мұны нақты рұқсат беру үлгісі бойынша жасайды:

• Exec рұқсаттары ~/.clawdbot/exec-approvals.json ішінде жазылады.
• Жүйе алғаш рет әрекет сұралғанда чатта растауды сұрайды; жалғастыру үшін /approve деп жауап бере аласыз (немесе бас тартасыз).
• Толық автоматтандырылған жұмыс ағындары үшін командалардың шектеулі рұқсат тізімін немесе алдын ала мақұлданған скрипттердің “bin”-ін жасаңыз.

Мысал: moltbot конфигурациясында (немесе UI/плагин арқылы) exec құралын қосыңыз:

{
  "tools": {
    "exec": {
      "enabled": true,
      "allowlist": ["/usr/local/bin/backup.sh", "/usr/bin/uptime"]
    }
  }
}

Жоба exec үшін нақты рұқсат беру ағындарын ұсынады және сұралғанда рұқсат сұрауларын чат арналарға жібереді, бұл операцияларды қарап шығып, мақұлдауды жеңілдетеді.

5) Telegram-нан қауіпсіз команданы байқап көріңіз

Telegram аккаунтыңыздан (рұқсат етілген пайдаланушы) жіберіңіз:

@YourMoltbot Hi — please run: uptime

Ассистент:

1. Растау сұрайды (егер exec мақұлдауды қажет етсе).
2. Хостта рұқсат етілген команданы орындайды.
3. Шығысты чатқа қайтарады.

6) Skills арқылы қауіпсіздеу әрекеттер жасаңыз

Чат арқылы тікелей shell қолжетімділігін берудің орнына, әрекеттерді инкапсуляциялайтын skills-терді таңдаңыз (мысалы, скриптті шақырған және әдемі форматталған нәтижені қайтаратын backup skill). Skills орнатылып/жойыла алады және оларды қарап шығу қауіпсіздеу.

Moltbot API-ды (Gateway) қалай хосттап, HTTP API-ды қалай қолданамын?

Басқа бағдарламалар шақыра алатын API-ды Moltbot бере ала ма?

Иә. Moltbot Gateway OpenResponses-пен үйлесімді HTTP endpoints-терді (мысалы, POST /v1/responses) және OpenAI-стиліндегі /v1/chat/completions shim-ын аша алады. Бұл endpoints-тер әдепкіде ажыратылған, оларды gateway конфигурациясында қосу керек. OpenResponses HTTP endpoint-і тура gateway агент орындалу жолына сәйкестенеді, сондықтан сұраулар нақты агент сессиялары ретінде орындалады (сол маршрутизация/рұқсаттармен).

Moltbot-та API Proxy деген не?

API proxy — Moltbot-тың агент орындалу ортасы мен жоғары деңгейдегі LLM провайдерлерінің арасында орналасқан аралық сервис, мысалы:

• OpenAI
• Anthropic
• Venice
• Azure OpenAI
• Өзін-өзі хосттайтын OpenAI-мен үйлесімді endpoints-тер

Moltbot провайдерге тікелей қоңырау шалудың орнына, барлық сұраулар прокси арқылы маршрутизделеді, ол:

• Сұраулар мен жауаптарды қайта жаза алады
• Жиілік/квота шектеулерін енгізеді
• Токен пайдалануды және құнын бақылайды
• Модельдерді динамикалық ауыстырады
• Шынайы API кілттерін Moltbot-тан жасырады
• Аутентификация, логтау және кэштеуді қосады

Тұжырымдамалық түрде:

Moltbot → API Proxy → LLM Provider

Бұл архитектура қауіпсіздікті, бақыламдылықты және құнды басқаруды айтарлықтай жақсартады.

🚀 Жылдам бастау: API кілтіңізді алу үшін CometAPI (apiyi.com) қолдануды ұсынамыз. Тіркелу тегін кредиттер береді. Claude Sonnet 4.5, Claude Opus 4.5 және GPT-5.2 сияқты барлық негізгі алгоритмдерді қолдайды және әдетте ресми бағалардан 10–20% арзан.

1-қадам: API Proxy кілтін алыңыз

Әдіс 1: Орталық айнымалыларды орнату. Moltbot .env файлында:

OPENAI_API_BASE=https://cometapi.com/v1
OPENAI_API_KEY=moltbot-internal-token
OPENAI_MODEL=gpt-4.1-mini

Негізгі тұстар:

• OPENAI_API_BASE OpenAI-ға емес, проксиға бағытталады
• OPENAI_API_KEY — прокси шығарған токен
• Қай провайдер/модель қолданылатынын прокси шешеді

Бұл мәндерді жаңартқаннан кейін Moltbot-ты қайта іске қосыңыз.

Әдіс 2: config.json арқылы конфигурациялау:

• Moltbot конфигурация файлын табу
• Конфигурация файлын ашып, models.providers мәнін қосыңыз немесе жаңартыңыз

Конфигурация файлы әдетте мына орындардың бірінде тұрады:

Сондай-ақ командалық жол арқылы таба аласыз:

# See your current config
moltbot config list

# Get the exact path to your config file
moltbot config path

---

2-қадам: Байланысты тексеру

Қарапайым тест промптын іске қосыңыз:

moltbot test llm

Дұрыс конфигурацияланған болса, Moltbot жауаптарды қалыпты түрде алады — жоғарыдағы провайдерге тікелей хабарласпай-ақ.

Хостталған модельдерді қолдана отырып Moltbot-ты іске қосудың құн бағамдары

Басқарылатын модельді қолдану құны API бағасына байланысты, сондықтан арзан API провайдерді таңдау өте маңызды, сол себепті мен CometAPI-ді ұсынамын.

Баға әдетте мына факторларға байланысты:

• Провайдер бағалары. Басқарылатын модельді қолдану құны API бағасына тәуелді, сондықтан арзан API провайдерді таңдау маңызды, осы себепті мен CometAPI ұсынамын.
• Флагмандық немесе жеңіл модельді таңдау; мысалы, Claude Opus 4.5 пен GLM 4.7 арасындағы баға айырмасы елеулі.
• Өңделетін контенттің күрделілігі. Егер жұмыс ағындарыңыз мәтінге жүктемелі болса (файлды талдау, ұзын жауаптар), токендер қосыңыз.

Жалпы мысалдар (иллюстрация ретінде, қауымдастық жазбаларындағы 2026 ж. қаңтар бағалары):

• Сирек жеке қолдану (айына бірнеше жүз жауап, жергілікті модельдер мен арзан API қоңыраулары аралас): $0–$50/ай.
• Ауыр жеке/профи қолдану (файл индекстеу, көп құрал шақырулар): $100–$1,000/ай.
• Командалық немесе әрдайым қосулы продакшн (көп пайдаланушы + веб-скрапинг + тізбектеу): $1,000+/ай, егер модель қолдануын агрессивті оптимизацияламасаңыз.

Құнды азайтудың жолдары

• Модель маршрутизациясы: жеңіл тапсырмаларды арзан модельдерге немесе жергілікті LLM-дарға жіберіңіз, ұзақ ойлануды қажет ететін тапсырмаларға қымбат модельдерді сақтаңыз — қауымдастық тесттері бұл құнды шамамен 50% және одан да көп қысқартатынын көрсетеді.
• Релейлер және көтерме бағалар: токен бағалары жақсырақ API релейлерін немесе жеке модель хостингін қолданыңыз (Venice, жеке endpoints-тер).
• Агрессивті кэштеу және қысқарту: LLM шығуларын кэштеңіз, ұзын тарихтарды қысқартыңыз және толық контекстті қайта жіберудің орнына қысқаша мазмұндаңыз.

Moltbot үшін кеңейтілген API Proxy мүмкіндіктері

Тапсырма түрі бойынша модель маршрутизациясы

Сұрау пейлоадын қарап, динамикалық маршрутизация жасай аласыз:

function selectModel(messages) {
  const systemPrompt = messages[0]?.content || "";
  if (systemPrompt.includes("shell") || systemPrompt.includes("automation")) {
    return "gpt-4.1";
  }
  return "gpt-4.1-mini";
}

Бұл үлгі сапаны жоғалтпай құнды азайтады.

---

Токен және құн шектеулері

Қатаң шектеулер енгізе аласыз:

if (req.body.max_tokens > 2000) {
  return res.status(400).json({
    error: "Token limit exceeded"
  });
}

Кейбір командалар Moltbot пайдаланушы ID-і бойынша жиынтық пайдалануды да бақылайды.

---

AI-ға компьютерыма Shell қолжетімділігін беру қауіпсіз бе?

Бұл кез келген Moltbot пайдаланушысы үшін ең маңызды сұрақ. LLM-ға rm -rf орындау мүмкіндігін беру табиғатынан тәуекелді. Moltbot мұны азайту үшін бірнеше қорғаныс тетіктерін қамтиды:

1. Sandboxing: Moltbot-ты Docker контейнерінде іске қосуға болады. Бұл агенттің «әлемін» белгілі бір қалтамен шектейді, жүйелік файлдарға қол тигізбеуге мүмкіндік береді.
2. Айқын мақұлдау: Әдепкіде «Main Sessions» (сізбен тікелей чаттар) сенім деңгейі жоғарырақ, бірақ ботты кез келген деструктивті shell командаларын орындамас бұрын рұқсат сұрауға баптауға болады.
3. Пароль қорғауы: Егер Moltbot Web UI-ды ашсаңыз, config.json ішінде парольдік аутентификацияны әрдайым қосыңыз:

{
  "gateway": {
    "auth": {
      "mode": "password",
      "password": "YOUR_STRONG_SECURE_PASSWORD"
    }
  }
}

Қорытынды ойлар:

Moltbot жай ғана чатбот емес; ол жеке цифрлық қызметкер үшін инфрақұрылым. Оны өзіңіз хосттай отырып, деректеріңізді бақылауды қайта аласыз және ешқашан ұйықтамайтын AI өнімділігін қолдана аласыз. Оны Telegram арқылы күнтізбені басқаруға немесе диванда отырып devops конвейерін автоматтандыруға пайдалансаңыз да, Moltbot — әркімде бөлменің бұрышында Mac Mini-де жұмыс істейтін «Jarvis» болады деген болашаққа көзқарас.

Егер ресми бағадан төмен бағамен бірнеше провайдер модельдері (мысалы, Chatgpt-5.2, Claude opus 4.5 және т.б.) бар API платформасын қаласаңыз, CometAPI — ең жақсы таңдау. Бастау үшін, модельдің мүмкіндіктерін Playground-да зерттеңіз және егжей-тегжейлі нұсқаулар үшін API нұсқаулығын қараңыз. Қол жеткізер алдында CometAPI-ге кіріп, API кілтін алғаныңызға көз жеткізіңіз. CometAPI интеграциялауға көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсынады.

Дайынсыз ба?→ Бүгін CometAPI-ге тіркеліңіз !

Қосымша кеңестер, нұсқаулықтар және AI жаңалықтары үшін бізді VK, X және Discord желілерінде қадағалаңыз!