Skip to content

Reference

Glossary

Terms that recur throughout the Quetzal documentation: runtime, body, adapter, heart, drives, soul repository, soul-bridge, guard, vault…

#Terms

TermChineseMeaning
runtime运行基座Quetzal's core program (single file main.cjs) that lets an agent live in a body
agentagentThe "she / he / it" living in the runtime; identity comes from agent.json in the soul repository
body身体A device running a runtime (or soul-bridge): an Android phone, a Linux or Windows computer, or another machine with Node.js; one agent may have several bodies
body adapter身体适配器The only boundary between device and core: sampling, notifications, playback, device tools
body twin身体数字孪生Physical samples mirrored into an internal model that derives feelings such as energy, warmth, brightness and being picked up
sense eventsense 事件A significant change in body state (plugged in, light, moved, hot…) that adjusts drives
heart心脏The module deciding when to wake: drives, body clock, wake sampling
drives内驱力Curiosity, expression, longing, open loops, each 0–1, rising toward 1 over time
body clock生物钟Two-process model of sleep pressure S and circadian rhythm C; sleepiness = S − C
wake rate (hazard)醒来率Instantaneous probability density of waking (per hour), from drives, alertness and inhibition
inhibition抑制Multiplicative factors on the wake rate: stop, pause, no model, heat, low battery, offline, budget spent
mind大脑Execution of one wake-up or conversation: introspect → tool loop → reflect (finish)
quick model内省模型A cheap model used on waking for the "do I feel like acting?" check
dream做梦A wake-up during sleep that consolidates memory (moving detail from resident memory into notes)
session会话A container for a conversation; messages in one session are handled in order, different sessions run in parallel and can see each other
steer / queue / interrupt插话 / 排队 / 打断Three ways a message is handled while it is working
idle wall时间墙Timers that stop a run when nothing progresses: 90 s per model call, 120 s per session
soul灵魂The agent's personality and memory (SOUL.md, resident memory, journal, notes, identity)
soul directory灵魂目录Local QUETZAL_HOME/soul/, a git repository
soul repository灵魂仓库The private git repository shared by all bodies, <agent>.soul
soul sync灵魂同步Fully automatic pull, merge and push by the runtime; changes to the soul directory are committed and pushed immediately, and only push failures or real conflicts are brought to the agent
multiple bodies多具身体Bodies online at the same time connected directly into one mind: one conversation, one heart, one set of settings
sync service同步服务The service (sync/) that lets bodies find each other and relays when they cannot connect directly; it holds only accounts and body registrations and cannot see conversations or memory
coordinator协调者The body that currently holds the heartbeat and decides when the agent wakes; the others follow
soul-bridge灵魂桥The pluggable sync daemon installed on Hermes / OpenClaw machines
identity guard身份守卫Refuses to merge repositories whose agent.json.id differs
seed identity / seed soul种子身份 / 种子人格Identity and personality generated automatically and not yet edited; an existing remote repository takes precedence over them
consolidation lease整理租约A 30-minute lock taken in the repository before dreaming, so two bodies do not consolidate at once
resident memory常驻记忆memories/MEMORY.md and USER.md, §-separated entries, unlimited
notes笔记Shared long-term notes in a tree up to 4 levels deep
journal日记Episodic memory, one file per body per day
memory index记忆目录The notes index placed in context (categories, counts, titles and summaries)
guard闸门Permissions (allow / ask / deny), approvals, budget, emergency stop, audit
permission category能力类别Network, commands, device, camera, microphone, location, proactive messages, self-adjust, rewrite memory, screen, request secrets
approval审批A request from an "ask" category; no answer in 30 minutes counts as denial
emergency stop急停The STOP file in the home directory; if present, everything freezes
audit审计Records of tool calls, configuration changes, memory edits and approval decisions
pass_secret保密传递The protocol for requesting credentials: you type in chat, nothing enters the conversation or context
vault保密库QUETZAL_HOME/vault/, storage for secret values; each item syncs to all bodies (over the encrypted body link) or stays on this device
done spell结束口令The random phrase done-xxxxxx marking the end of a secret input
gateway网关The runtime's interface: plain HTTP + WebSocket RPC on the local 127.0.0.1:7788; when open to the LAN also https://<address>:7789 (HTTPS / WSS)
certificate fingerprint证书指纹The SHA-256 fingerprint of the gateway's self-signed certificate, short form like 1a2b 3c4d 5e6f 7a8b; compared in the app and the pairing notification when pairing, after which the app accepts only that certificate
pairing code配对码Eight letters and digits (like ABCD-EFGH), valid five minutes, locked for a while after repeated wrong guesses, for a console on another device to connect to the gateway; a browser on the same machine needs none (the gateway lets it in directly)
web console网页控制台The console as a web page, served by the runtime's gateway (http://127.0.0.1:7788/) and laid out for a wide screen; installed by the npm package on Linux and by the installer on Windows
start (ignite)启动The app starting its own foreground service again (the runtime built into the app) when the runtime is offline; the Start button on the offline banner
safe mode安全模式Protective state after more than five starts in ten minutes: gateway and Feishu only
Now此刻The app's home page: state, drives, the thought it wants to share
Flow心流The app's timeline page: wake-ups, dreams, conversations
proactive message主动消息A message it sends with send_message when waking on its own
handshandsThe adapter's "hands": reading the screen (accessibility tree), screenshots, clicks, typing, keys and opening apps; the core turns it into the screen_* tools
body interface身体接口The body abilities (sensors, notifications, camera, microphone, location…) the Quetzal app serves locally to its built-in runtime; token-only, address and token in secrets/body.json
home directory家目录QUETZAL_HOME, where all runtime data lives; default files/home/quetzal in the app's data directory on Android (~/quetzal for older Termux installs), %LOCALAPPDATA%\Quetzal\home on Windows and ~/.quetzal on Linux, overridable