Du har bestemt deg for å bygge din første agent i OpenClaw, og nå står du foran en agents.md-fil som skal beskrive teamet ditt. Det føles kanskje som en teknisk fil, men det er det ikke. Tenk på det som et organisasjonskart. Du beskriver hvem som er på laget, hvilken rolle hver enkelt har, og hva de er gode på. Når du forstår strukturen, blir filen enkel å fylle ut.
Hva agents.md egentlig er
Agents.md er forsiden av agent-teamet ditt. Den lister opp alle agentene i oppsettet, gir dem identitet, og kobler dem til ferdighetene de skal bruke. Hvis du har flere agenter som jobber sammen, er det her du ser hele laget i en oversikt. Hvis du har én agent, er det her du beskriver hvem den er.
Filen er skrevet i markdown, men det betyr bare at den er ren tekst med litt struktur. Du trenger ikke kunne kode for å fylle den ut. Du leser den fra topp til bunn som du ville lest et organisasjonskart i en bedrift.
Strukturen øverst i filen
Helt øverst står noen linjer med generell informasjon om hele oppsettet. Du gir teamet et navn, og du legger til en kort beskrivelse av hva teamet gjør. Det er omtrent som forsiden på et organisasjonskart. Det forteller leseren, eller deg selv om noen måneder, hva slags team du har bygd og hvorfor.
Disse linjene er korte. Et navn og en setning eller to er nok. Hovedpoenget er å gjøre det klart for både deg selv og for agentene hva de er en del av. Hvis du har et team som heter "Kundeservice-Norge" og en beskrivelse som sier at teamet svarer på henvendelser fra norske kunder, vet alle agentene konteksten de jobber i.
Hver agent får fire enkle felter
Etter den generelle delen kommer selve agentene. Hver agent defineres med fire felter, og det er det. Du trenger ikke mer for å ha en fungerende agent.
Det første feltet er name, altså navnet. Det kan være et fornavn som Chief, Researcher eller Builder, eller det kan være noe mer beskrivende som "Innboks-sortereren". Velg noe du selv husker. Du kommer til å referere til agenten ofte når du justerer instruksjoner.
Det andre feltet er role, altså rollen. Hva slags posisjon har agenten i teamet? Er den en sjef, en spesialist eller en utfører? Rollen styrer hvordan agenten oppfører seg overfor andre agenter og overfor deg.
Det tredje feltet er en kort setting eller beskrivelse av hva agenten gjør. Holdes kort og presist. "Mottar oppgaver fra brukeren og delegerer videre" er et godt eksempel. Det forteller agenten selv hva som er primæroppgaven.
Det fjerde feltet er model, altså hvilken språkmodell den bruker. Det kan være ChatGPT, Claude eller en annen, og du velger ut fra hva agenten skal være god til. Vil du se hvordan modellene skiller seg, har vi en egen artikkel om hvordan du finner den beste KI-modellen for jobben din.
Skills binder agenten til konkrete ferdigheter
Til slutt har hver agent et felt som heter skills. Det er en liste over ferdighetene agenten har tilgang til. Hver ferdighet er beskrevet i sin egen skill.md-fil, men i agents.md ser du bare lista. Det gjør det lett å se hva en agent kan gjøre uten å åpne flere filer.
Du gir agenten kun de ferdighetene den faktisk trenger. En agent som skal sortere e-post trenger ikke en ferdighet for å oppdatere regneark. En agent som skal poste i Slack trenger ikke tilgang til kalenderen. Disse grensene er en stor del av sikkerheten i OpenClaw.
Eksempel på en typisk agents.md
En enkel agents.md kan ha tre agenter. Helt øverst står teamnavnet og beskrivelsen. Deretter kommer Chief, som er sjefen og den du snakker med. Under Chief kommer Researcher, som graver i ting og finner svar. Til slutt kommer Builder, som lager og leverer ting.
Hver av dem har samme fire felter: navn, rolle, beskrivelse, modell og ferdigheter. Til sammen utgjør de et team med tre tydelige roller. Det er ingen fasit på dette. Du kan ha bare én agent eller du kan ha ti. Du kan kalle dem hva du vil, og du kan gi dem rollene som passer arbeidet ditt.
Hvordan filen henger sammen med resten
Agents.md står ikke alene. Den henger sammen med soul.md, som beskriver kulturen og holdningene til agentene, og med skill.md, som beskriver hva hver enkelt ferdighet faktisk gjør. Sammen utgjør disse tre kjernen i hvordan en agent oppfører seg i OpenClaw.
Vil du forstå hvor agents.md passer inn i hele filstrukturen, er Filer og minne i OpenClaw et naturlig neste steg. Du finner også grunnleggende informasjon om byggeklossene i de tre lagene i en AI-agent.
Slik kommer du i gang
Den enkleste måten å lære agents.md på er å åpne en og endre litt. Start med en kopi av et eksempel, bytt ut navnet og rollen, og se hva som skjer når du kjører agenten. Etter hvert som du blir komfortabel, legger du til flere agenter og finjusterer ferdighetene de har tilgang til.
Vil du se filen åpnet og forklart linje for linje med video, finner du gjennomgangen i OpenClaw-kurset til Benjamin Bruarøy på Utdannet.no. Der lærer du både agents.md, soul.md og skill.md i sammenheng, slik at du har hele bildet før du bygger din første agent.
