Katalog modeley OpenClaw i openclaw models sync
Drift provaydera, kesh, auth — runbook (posutochno macOS)
Gateway zapuskaetsya, no marshrutizator ne vidit modeli, kotoryye tolko chto sinhroniziroval CLI; sync zavershaetsya s kodom 0, no katalog na diske pakhnet negativnym keshem; 401 prilipayut tolko k metadannym — pereputat OAuth-drift s oppechatkami v ID modeley dorogo stoit dlya nochnoy smeny. Runbook dlya self-host i ops: tri klastera boli, matritsa CLI/Gateway/konfig, sem uporyadochennyh shagov, triazh-tablitsa, tri metriki i ritm 1–3 dnya na arendovanom macOS, so ssylkami na v2026.4.14 katalog + doctor, v2026.5.5 kanaly/npm i SSH/VNC FAQ.
Soderzhanie
01. Tri klastera
1) Sync uspeshno, no lokalnyy catalog «pustoy negativ»: nekotoryye sborki negativno keshiruyut pustye otvety provaydera. Pervyy fetch 200 s pustym massivom zakorachivaet posleduyushchiye kak «svezhiye». Parallelnyye shell so starymi OPENCLAW_* na arendnom hoste usilivayut prizrak «akkaunt A, gateway B».
2) Drift spiska provaydera i pamyat Gateway: aliasy dolzhny byt stabilnymi. Apstrim snyal imya, a openclaw.json yeshche ssylaetsya — CLI pokazyvaet naslediye s diska, validatsiya pri starte tikho vybrosila stroki. Proydite trehstoronnyy razbor v2026.4.14: disk, protsess, apstrim.
3) 401 i 429 sveryayutsya v «model nedostupna»: bez sparennyh curl -v i strok access Gateway so vremennymi metkami dezhurnyy skatyvaetsya k «perezapustite gateway».
02. Matritsa
Yesli v tot zhe vecher trogaete npm-plaginy i marshrut kanalov, razdelite tikety, kak v v2026.5.5, chtoby ne meshat peer-ispravleniya i tablitsu modeley.
| Simptom | CLI | Gateway | Arenda macOS |
|---|---|---|---|
| V konsoli est, v spiske net | exit 0, chislo strok JSON stranno | catalog cache hit | ochistit kesh, kholodnyy restart |
| unknown model v routere | alias ostalsya v json | v protsessnoy tablitse net stroki | doctor + poryadok perezapuskov |
| Peremezhayushchiesya 401 | tolko metadannyye | Authorization propal / istek | vremennyy klyuch, odna sled |
Gateway v Linux-konteynere, CLI na macOS — zafiksiroyte v odnom tikete chasy i DNS. «Sync na diske OK» ne oznachayet reload konteynera.
03. Sem shagov
- Zamorozit:
openclaw --version, tag obraza, absolyutnyy put kopenclaw.json. - Doctor-bazovaya liniya:otdelno PASS i WARN.
- Sync modeley:polnyy stdout/stderr i kod vykhoda cherez
tee. - Proverit endpoint modeley Gateway:sravnit mnozhestva ID.
- Vyravnyat aliasy v
openclaw.json:planovyy perezapusk vmesto goryachego ddzha. - Vyborka:dva malonagruzhennyh + odin osnovnoy, po 20 vizov.
- Dokazatelstva i stiraniye:redaktsiya logov, otzyv demo-klyuchey, ochistka kesha kataloga na arende. Obzor ustanovki: rukovodstvo po ustanovke.
openclaw doctor 2>&1 | tee /tmp/openclaw-doctor-baseline.txt
curl -sS -H "Authorization: Bearer ***" "https://gateway.example/v1/models" | head -c 4000Nizhe 16 GB svobodnogo mesta raspakovka i indeks vo vremya sync mogut «sryvatysya». FAQ po podklyucheniyu.
04. Triazh
| Simptom | Snachala | Chastaya oshibka |
|---|---|---|
| Sync ok, spisok ploskiy | ochistit kesh + kholodnyy GW | tolko pereimenovyvat aliasy |
| 401 na metadannyh | rotatsiya klyuchey, tsep Authorization | slepoye major-obnovleniye CLI |
| unknown model + npm v odnu noch | razdelit tikety | parallelno menyat kanal i marshrut |
05a. Observability i SLO
Ne ogranichivaytes vremenem sync: interval ot starta Gateway do «tablitsa modeley gotova», razryv mezhdu okonchaniyem sync i mtime kataloga, P95 pri pervom kholodnom keshe. SLO vida «dostupny dlya zaprosa modeli ≥ N i simmetrichnaya raznost s konsolyu ≤ K». Stranitsy 401 i unknown model napravlyayte v raznyye rotatsii. Esli vremenno povysili sampling access-logov, zapishite vremya vozvrata k defoltu dlya audita hranilishcha. Metki regiona na dampah, chtoby ne prinyat Tokyo sinhron / Frankfurt ustarel za globalnyy outage.
05b. Upravleniye izmeneniyami
Katalog — eto polu-publichnyy API: zhestko zashityye imena v testah ili dashboardah vzryvayutsya v tot zhe vecher. Chek-list: okno zakrytiya aliasov, okno migratsii modeli po umolchaniyu, put k predydushchemu tarball. Tenevyye protsenty vmesto rezlogo pereklyucheniya. Otakatyvaytes na arende: doctor→sync→curl; proverayte poryadok zagruzki npm.
05. Metriki i grafik
- M1:okolo 24–37 % «strannogo kataloga» — kesh/reload, a ne dolgiy apstrim.
- M2:trehkolonnaya matritsa sokratila pervoye vosstanovleniye zdorovogo marshruta na ~0,7–1,5 iteratsiy.
- M3:pri nizhe ~18 GB svobodno, retry sync+index ~10–22 % do/posle uborki.
Den 1:zamorozka, doctor, sync, odin curl-diff. Den 2:ochistka ili klyuchi po triazhu, tri modeli-vyborki. Den 3:arhiv redaktirovannyh logov, stiraniye arendy.
06. Linux vs posutochno Mac
Linux-d hosting zrel; dlya Control UI, dev-keychain i zakhvata trafika na odnoy mashine v korotkom okne dokazatelstv arenda nativnogo macOS chashche vyigryvaet. Posutochnaya oplata privyazyvaet OPEX k piku. Kontekst tsen: stranitsa paketov i tsen.
Neskolko inzhenerov na odnom hoste: papki dokazatelstv tolko s dobavleniyem s UTC i tegom sborki. CI: zakrepit env-fayly, zapretit povtornoye ispolzovaniye lichnyh API-klyuchey.
Granitsa vendora: rotatsiya URL vydachi JWT bez zapisi v changelog do istecheniya TTL JWKS — fiksiruyte SLA metadannyh i sinteticheskiye proby.
Yomkost: budzhet na tarball na reliz i rabocheye prostranstvo; limit egress na malenkom oblachnom Mac dushit bolshiye katalogi — sync vne pika, propusknaya sposobnost v tiket.
Bezopasnost: kto mozhet zapuskat sync na prod-sosednih hostah; audit vmeste s kommitami v openclaw.json.
Chasy: date -u na CLI i Gateway v odnom tikete; korotkiy runbook (sbros kesha, obnovleniye tokena, restart) vmesto improvizatsii.