# Grok Buildin istuntojen välinen muisti: asetukset ja rajoitukset

> Näin otat muistin käyttöön, missä muistiinpanot tallennetaan ja miten /flush, /remember, /dream ja /memory toimivat. Asetusten prioriteetti, tarkistaminen ja merkintöjen poistaminen.

Source: https://ailoot.ai/blog/fi/grok-build-memory/
Canonical: https://ailoot.ai/blog/fi/grok-build-memory/
Language: fi
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-111
Revision: sha256-cc00dfbd1e1ebfd8f589fb8e68691e686e2c10aa5b0086617b3c70b898f934ea


xAI:n terminaaliagentissa Grok Buildissa on istuntojen välinen muisti: se voi muistaa projektin käytäntöjä, päätöksiä ja toimiviksi osoittautuneita virheenjäljitysvaiheita ja lisätä ne sitten uuden istunnon kontekstiin ilman muistutuksia. Ominaisuus on oletusarvoisesti pois päältä ja kokeellinen – sen voi ottaa käyttöön yhdellä asetuksella.

Tämä kuvaus perustuu `xai-org/grok-build`-repossa olevaan viralliseen oppaaseen 20. syyskuuta 2026. Alkuperäisen artikkelin kirjoittaja ei kokeillut tuotetta: toimintaa kuvataan dokumentaation perusteella, ei henkilökohtaisten testien pohjalta.

[Käytännön tietoa Ailootin käytöstä on dokumentaatiossa](https://ailoot.ai/docs/).

## Mitä hyötyä muistista on Grok Buildissa?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Ilman muistia uusi Grok Build -istunto ei saa tietoja aiemmista istunnoista: ei selittämistäsi käytännöistä eikä tekemistäsi päätöksistä, ellei niitä ole kirjattu repon ohjetiedostoon. Kun muisti on käytössä, agentti etsii tallennettuja muistiinpanoja ja lisää asiaankuuluvat muistiinpanot automaattisesti uuden istunnon kontekstiin. Muistiinpanot tallennetaan tavallisina Markdown-tiedostoina, joita voit lukea ja muokata.

</div>

Olet esimerkiksi selittänyt agentille yhdessä istunnossa, että projektissa käytetään kahden välilyönnin sisennystä, tietokannan migraatiot suoritetaan erillisellä komennolla ja tietty moduuli käsittelee maksuja. Uudessa istunnossa sinun on annettava nämä tiedot uudelleen.

Kun muisti on käytössä, Grok Build voi:

- palauttaa mieleen aiemmin selittämäsi projektikäytännöt;
- hyödyntää jo toimiviksi osoittautuneita virheenjäljitysvaiheita;
- siirtää arkkitehtuuripäätökset myöhempiin istuntoihin;
- välttää kysymästä uudelleen asioita, joihin on jo vastattu.

Ominaisuus on kokeellinen ja oletusarvoisesti pois päältä. Agentin toiminta ei muutu ennen kuin otat sen käyttöön.

## Miten otat muistin käyttöön?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Aseta ympäristömuuttujaksi `GROK_MEMORY=1` yksittäistä suorituskertaa varten. Jos haluat pitää muistin käytössä, lisää tiedostoon `~/.grok/config.toml` `[memory]`-osio ja asetus `enabled = true`. Käynnistä muistin käyttöönoton jälkeen uusi istunto komennolla `/new`, jotta tallennetut muistiinpanot lisätään työn alkaessa.

</div>

**Kerran, yhtä suoritusta varten:**

```bash
GROK_MEMORY=1 grok
```

Muuttuja koskee vain tätä suoritusta. Komento `export GROK_MEMORY=1` säilyttää asetuksen nykyisessä komentotulkissa ja ottaa muistin käyttöön kaikissa sitä seuraavissa `grok`-suorituksissa kyseisessä komentotulkissa, kunnes pääteistunto päättyy tai suoritat komennon `export GROK_MEMORY=0`.

**Pysyvästi asetustiedoston kautta.** Lisää tämä tiedostoon `~/.grok/config.toml`:

```toml
[memory]
enabled = true
```

**Istunnon aikana ilman uudelleenkäynnistystä:** avaa `/memory` ja paina `t`.

Tämä valitsin vaikuttaa vain nykyiseen istuntoon eikä sitä kirjoiteta asetustiedostoon. Sen avulla voi ottaa muistin käyttöön tai poistaa sen käytöstä. Käytöstä poistaminen estää pääsyn muistityökaluihin mutta ei poista tiedostoja levyltä; kun otat muistin uudelleen käyttöön, tallennustila tulee taas käyttöön. Valitsin ei voi ohittaa prosessitason pakotettua muistin käytöstä poistamista asetuksella `GROK_MEMORY=0`: `/memory` ei ole käytettävissä koko istunnon aikana.

Jos asetuksia määritetään useassa paikassa, niiden prioriteetti on seuraava:

- `GROK_MEMORY=0` poistaa muistin käytöstä koko prosessilta, ja sen prioriteetti on korkein.
- Asetustiedoston nimenomainen `enabled = false` poistaa muistin käytöstä, vaikka hallittu etäasetus ottaisi sen käyttöön.
- Muistin voi ottaa käyttöön asetuksella `GROK_MEMORY=1`, asetustiedoston arvolla `enabled = true` tai hallitulla etäasetuksella.
- Jos asetusta ei määritetä, muisti on pois päältä.

Muistiinpanot lisätään istunnon ensimmäisellä vuorolla. Jos otit muistin käyttöön kesken työskentelyn ja haluat agentin alkavan käyttää tallennettuja projektitietoja, suorita `/new`. Voit tarkistaa, onko muisti käytössä, komennon `grok inspect` tulosteesta.

## Mitä Grok Build tallentaa ja minne?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Muistiinpanot tallennetaan hakemistoon `~/.grok/memory/` Markdown-tiedostoina: siellä on kaikkia projekteja koskeva `MEMORY.md`, kullekin projektille oma `MEMORY.md` sekä istuntolokeja. Automaattinen istunnon lopun yhteenveto kirjoitetaan ilman mallikutsua, yksityiskohtaisia muistiinpanoja luodaan komennoilla `/flush` ja `/remember`, ja `/dream` ryhmittelee hajanaiset merkinnät aiheittain.

</div>

Hakemiston `~/.grok/memory/` rakenne:

| Sijainti | Laajuus | Sisältö |
|----|----|----|
| `~/.grok/memory/MEMORY.md` | Yleinen | Kaikkia projektejasi koskevat tiedot ja mieltymykset |
| `~/.grok/memory/` + hashin sisältävä projektihakemisto + `/MEMORY.md` | Projekti | Tietyn repon käytännöt ja konteksti |
| `~/.grok/memory/` + hashin sisältävä projektihakemisto + `/sessions/` | Istunnot | Yksittäisten istuntojen yhteenvedot ja lokit |

Projektihakemiston nimeen lisätään lyhyt hash repon tunnisteesta. Tunnistukseen käytetään `origin`-etäosoitetta muodossa ”organisaatio/repo” tai hakemistopolkua, jos Git-repoa ei ole. Siksi saman repon kloonit ja worktreet (Git-haarojen erilliset työkopiot) jakavat saman projektimuistin: agentin yhdessä kopiossa muistamat asiat ovat käytettävissä myös toisessa.

Merkintöjä syntyy neljällä tavalla:

1.  **Automaattinen yhteenveto istunnon päättyessä.** Kun istunto päättyy, Grok Build tallentaa päivittäiseen lokiin lyhyen järjestelmäyhteenvedon: viestien määrän, enintään viisi ensimmäistä sisällöllistä keskusteluvaihtoa sekä päivämäärän ja kellonajan. Yhteenveto muodostetaan metatiedoista ilman mallikutsua tai viivettä. Hyvin lyhyet istunnot ohitetaan: merkintää ei luoda, jos sisällöllisiä keskusteluvaihtoja on alle kolme tai kirjoittamaasi tekstiä on alle 50 tavua. Yhteenveto ei sisällä käytettyjä työkaluja, tiedostopolkuja eikä komentoja. Automaattiset yhteenvedot voi poistaa käytöstä asetuksella `session.save_on_end = false`.
2.  **`/flush` – yksityiskohtainen muistiinpano pyynnöstä.** Tällä komennolla malli tiivistää nykyisen istunnon tärkeimmät asiat: päätökset, toimintamallit, virheenjäljitysvaiheet ja API-havainnot. Yhteenveto kirjoitetaan päivättyyn lokiin ja indeksoidaan tulevia istuntoja varten. Dokumentaatiossa suositellaan suorittamaan `/flush` ennen kontekstin tiivistämistä, onnistuneen virheenjäljitysistunnon lopuksi ja tärkeiden toimintamallien havaitsemisen jälkeen.
3.  **`/remember` – nimenomainen pyyntö muistaa jokin asia.** Kirjoita `/remember always open PR links after sending` tai sano agentille ”muista, että...”. Ennen merkinnän kirjoittamista avautuu tarkistusnäkymä: muistiinpano tallennetaan vasta vahvistuksesi jälkeen, ja syötteeseen ilmestyy `Memory saved to ~/.grok/memory/MEMORY.md`. Projektin tiedot tallennetaan projektin `MEMORY.md`-tiedostoon, ja kaikkiin projekteihin liittyvät tiedot yleiseen tiedostoon.
4.  **`/dream` – koonti.** Komento ryhmittelee hajanaiset lokit ja muistiinpanot aiheittain ja poistaa kaksoiskappaleet haun tarkkuuden parantamiseksi. Kuten `/flush`-komennon tapauksessa, koonnin tekee malli: se lukee kertyneet merkinnät ja kirjoittaa ne uudelleen aiheittain, joten tulos kannattaa tarkistaa säännöllisesti komennolla `/memory`. Käytettävissä on myös automaattinen tila: oletusarvoisesti Grok Build tarkistaa ehdot käynnistyksen yhteydessä ja kerran tunnissa ja aloittaa koonnin, kun vähintään 24 tuntia on kulunut ja istuntoja on kertynyt vähintään 5. Kynnysarvoja voi säätää asetustiedoston osiossa `[memory.dream]`.

Muistiinpanoja haetaan SQLite-indeksin avulla: oletusarvoisesti käytössä on FTS5-kokotekstihaku, ja jos upotusmalli on määritetty, siihen lisätään semanttinen vektorihaku.

## Miten muisti siirtyy uuteen istuntoon?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Istunnon ensimmäisellä vuorolla Grok Build etsii muistista projektiin liittyviä merkintöjä ja lisää ne kontekstiin automaattisesti – sinun ei tarvitse muistuttaa siitä. Haku suoritetaan uudelleen automaattisen kontekstin tiivistämisen jälkeen. Vanhoihin istuntomerkintöihin lisätään ajantasaisuuden tarkistusmerkintöjä.

</div>

Alustavan lisäyksen valintakynnys on `min_score = 0.9`, jota voit muuttaa osiossa `[memory.initial_injection]`. Automaattisen kontekstin tiivistämisen jälkeen agentti hakee muistista uudelleen palauttaakseen tiedot, jotka ovat saattaneet poistua kontekstista vanhempien keskusteluvaihtojen mukana.

Voit myös kysyä agentilta suoraan: ”Mitä muistat?” Se ryhmittelee vastauksen lähteen mukaan: yleiset mieltymykset, projektitiedot ja istuntohistoria.

Istuntomerkinnöissä on ajantasaisuusmerkintöjä. Mitä vanhempi istuntolokin merkintä on, sitä painokkaammin se merkitään: ”Tarkista, että tämä on yhä ajankohtaista, ennen kuin luotat siihen.” Yleisiin ja projektikohtaisiin `MEMORY.md`-tiedostoihin tällaisia merkintöjä ei lisätä: niiden sisältö on tarkoitettu pitkäaikaiseen käyttöön, joten sinun on itse huolehdittava sen paikkansapitävyydestä.

## Miten muistiinpanoja tarkastellaan, muokataan ja poistetaan?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Komento `/memory` avaa kaikkien muistitiedostojen yleisnäkymän esikatseluineen. Voit muokata tiedostoja millä tahansa tekstieditorilla – muutokset tulevat mukaan seuraavan haun yhteydessä. Pyyntö ”unohda ...” toimii ilman takuuta; jos haluat varmasti poistaa tietyn merkinnän, muokkaa tiedostoa.

</div>

Istunnossa suoritettu `/memory`-komento avaa ikkunan, jossa kaikki muistitiedostot on ryhmitelty laajuuden mukaan: yleiset, projekti ja istunnot (käänteisessä aikajärjestyksessä). Tiedostoluettelo on vasemmalla ja valitun tiedoston vain luku -esikatselu oikealla.

Yleisnäkymän hyödylliset näppäimet:

| Näppäin | Toiminto |
|----|----|
| `↑`/`↓` tai `j`/`k` | Siirry luettelossa |
| `/` | Suodata luetteloa |
| `y` | Kopioi valitun tiedoston polku |
| `x` | Poista valittu muistiinpano (vahvista painamalla uudelleen) |
| `t` | Ota muisti käyttöön tai poista se käytöstä |
| `Esc` | Sulje ikkuna |

Ikkunassa voi poistaa yksittäisiä muistiinpanoja ja istuntotiedostoja, mutta sillä ei voi poistaa luotuja `MEMORY.md`-indeksitiedostoja (yleistä ja projektikohtaista).

Toinen tapa on muokata tiedostoja suoraan. Ne sijaitsevat hakemistossa `~/.grok/memory/`, ja ne voi avata millä tahansa editorilla. Hakemiston muutoksia seurataan: luodut ja muokatut tiedostot indeksoidaan uudelleen, ja poistetut tiedostot poistetaan indeksistä seuraavan haun yhteydessä.

Pyyntö ”unohda snake_case” toimii ilman takuuta: malli etsii vastaavat merkinnät ja poistaa niitä, mutta voi jättää joitakin huomaamatta. Jos haluat varmistaa poistamisen, avaa tiedosto (voit kopioida sen polun kätevästi komennolla `y` näkymässä `/memory`) ja poista merkintä itse. Voit tyhjentää muistin kokonaan komentoriviltä: `grok memory clear` poistaa projektimuistin, `grok memory clear --global` yleisen muistin ja `grok memory clear --all` molemmat.

## Miten muisti eroaa repon ohjetiedostosta?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Kirjoitat ohjetiedoston, esimerkiksi CLAUDE.md:n tai AGENTS.md:n, ja sijoitat sen repoon – se jaetaan tiimin kanssa Gitin välityksellä. Grok Build -agentti ylläpitää muistimuistiinpanoja ja tallentaa ne repon ulkopuolelle hakemistoon `~/.grok/memory/`: ne ovat henkilökohtaisia eikä niitä jaeta Gitin välityksellä.

</div>

Repon ohje jaetaan kaikille projektissa työskenteleville, ja se näkyy koodissa ja muutoshistoriassa. Muisti karttuu istuntojen aikana, tallennetaan koneellesi eikä julkaistu itsestään.

Muisti ei korvaa ohjetiedostoa. Yleiset projektisäännöt, joita koko tiimi ja kaikki agentit tarvitsevat, kuuluvat edelleen repoon. Meillä on erillinen opas yhden ohjetiedoston käyttämiseen Claude Codessa, Codexissa ja Cursorissa: [AGENTS.md ja CLAUDE.md yhdessä](https://ailoot.ai/blog/fi/agents-md-claude-md-one-instruction-file/). Muisti säilyttää henkilökohtaisen kontekstisi: mieltymyksesi, jo kokeillut asiat ja tehdyn päätöksen.

Claude noudattaa samanlaista erottelua: kerromme artikkelissa [Claude-muisti ja CLAUDE.md](https://ailoot.ai/blog/fi/claude-memory-claude-md-auto-memory/), miten muisti eroaa CLAUDE.md-tiedostosta. Työkalujen vertailu on oppaassa [Grok Build vai Claude Code](https://ailoot.ai/blog/fi/grok-build-vs-claude-code/).

## Rajoitukset ja muistin toiminnan tarkistaminen

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Osion tärkein asia">

Tärkein asia

Ominaisuus on kokeellinen: komennot ja asetukset voivat muuttua. Jos haluat muistiinpanojen tulevan mukaan ensimmäisellä vuorolla muistin käyttöönoton jälkeen, aloita uusi istunto komennolla `/new`. Osa merkinnöistä on mallin luomia, joten tarkista muistiinpanot säännöllisesti ja pyydä agenttia olemaan muistamatta salaisuuksia.

</div>

Pidä seuraavat rajoitukset mielessä:

- **Kokeellinen tila.** Komennot, kynnysarvot ja toiminta voivat muuttua tulevissa versioissa. Tarkista repon muistiohje, jos jokin ei toimi odotetusti.
- **Alustava lisäys uudessa istunnossa.** Aloita työ komennolla `/new` muistin käyttöönoton jälkeen, jotta tallennetut muistiinpanot lisätään ensimmäisellä vuorolla.
- **Malli päättää, mikä on tärkeää.** Malli luo `/flush`-yhteenvedon ja valitsee, mitä muistiinpanoon sisällytetään. Avaa `/memory` viikon tai kahden välein ja tarkista, mitä on kertynyt; poista tarpeettomat tiedot.
- **Älä pyydä agenttia muistamaan salaisuuksia.** Avaimet, tokenit ja salasanat eivät kuulu pitkäaikaisiin muistiinpanoihin: hakemiston `~/.grok/memory/` tiedostot tallennetaan raakatekstinä. Jos muistiin tallentuu arkaluonteisia tietoja, poista ne muokkaamalla tiedostoa.
- **Projektimuisti jaetaan repon kopioiden kesken.** Jos agentti muistaa yhdessä kloonissa jotain, joka on toisessa vanhentunutta, ota jaettu hakemisto huomioon siivotessasi.

Jos muisti ei toimi:

1.  Tarkista komennon `grok inspect` tulosteesta, että muisti on käytössä.
2.  Tarkista, etteivät `GROK_MEMORY=0` tai asetustiedosto poista sitä käytöstä.
3.  Suorita vianmääritystä varten `RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok` ja tarkista muistia koskevat rivit tiedostosta `/tmp/grok.log`.

## Lyhyt yhteenveto

Grok Buildin muistin voi ottaa käyttöön asetuksella `GROK_MEMORY=1` tai lisäämällä `~/.grok/config.toml`-tiedostoon `[memory] enabled = true`. Aloita uusi istunto komennolla `/new`, jotta muistiinpanot lisätään ensimmäisen kerran käyttöönoton jälkeen. Agentti tallentaa muistiinpanot hakemistoon `~/.grok/memory/`: istuntoyhteenvedot ilman mallikutsua, yksityiskohtaiset yhteenvedot komennolla `/flush`, nimenomaiset merkinnät komennolla `/remember` vahvistuksesi jälkeen ja aiheittain järjestetyt muistiinpanot komennolla `/dream`. Tarkastele ja siivoa muistiinpanoja komennolla `/memory` tai muokkaamalla tiedostoja suoraan. Ominaisuus on kokeellinen, joten tarkista kynnysarvot ja komennot virallisesta oppaasta ja käy muistiinpanot läpi säännöllisesti.

<div class="section" role="doc-bibliography" aria-label="Lähteet">

### Lähteet

- Grok Buildin virallinen ”Cross-Session Memory” -opas (käyttöopas, luku 13): <https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/13-memory.md>
- Grok Build, xAI:n GitHub-repo: <https://github.com/xai-org/grok-build>

</div>

Järjestelmällisessä työskentelyssä yhdistelmä **AI-klooni + Second Brain + Context Engineering** on hyödyllinen.



[Avaa Ailoot](https://ailoot.ai/).

## Kysymyksiä tästä oppaasta: Grok Buildin istuntojen välinen muisti: asetukset ja rajoitukset

### Miksi tallennetut muistiinpanot eivät näy muistin käyttöönoton jälkeen?

Muistiinpanot lisätään uuden istunnon ensimmäisellä vuorolla. Aloita muistin käyttöönoton jälkeen uusi istunto ja tarkista raportoitu tila komennolla grok inspect. Prosessi, joka käynnistettiin asetuksella GROK_MEMORY=0, ei voi ottaa muistia käyttöön istuntokytkimestä.

### Poistaako muistin sammuttaminen sen tiedostot?

Ei. Käytöstä poistaminen poistaa pääsyn muistityökaluihin mutta jättää Markdown-muistiinpanot levylle. Tarkista tai muokkaa tallennettuja muistiinpanoja erikseen, jos tietue pitää poistaa.


## Ailoot · Yritys ja sen projektisalkku

Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.
