הקובץ הזה מסופק עם ה-CLI ומחולץ אל ~/.grok/docs/user-guide/26-config-reference.md בהפעלה. זו רשימת השדות המלאה עבור config.toml, managed_config.toml, ו-requirements.toml. להדרכה מושגית ראו 05-configuration.md.
שלושה קבצים מגדירים את Grok Build, והם נכתבים על ידי אנשים שונים.
קובץ
מי כותב אותו
איפה הוא נמצא
למה משתמשים בו
config.toml
המפתח
~/.grok/config.toml, וגם .grok/config.toml בפרויקט
לקבוע ברירות מחדל אישיות. כל מה שכאן יכול להשתנות על ידי מי שמשתמש במכונה.
managed_config.toml
אתם, דרך הקונסולה או כלי פריסה
/etc/grok/managed_config.toml, או $GROK_HOME/managed_config.toml
לשלוח נקודת התחלה לצי. הקובץ של המפתח דורס אותו.
requirements.toml
אתם, חתום
/etc/grok/requirements.toml, ניהול מכשירים ב-macOS, או $GROK_HOME/requirements.toml
לקבוע ערכים שמפתח לא יכול לשנות. מפתחות שמסומנים pin למטה מחזיקים מול כל קובץ אחר, הסביבה, ושורת הפקודה.
בחרו managed_config.toml לברירות מחדל שאתם רוצים שאנשים יוכלו להתאים, ו-requirements.toml לערכים שאתם רוצים שאנשים לא ישנו.
Grok Build קורא גם את השכבות האלה. שורות מאוחרות מנצחות, חוץ ממקום שבו נעילת requirements או עמודת Managed אומרת אחרת.
ברירות מחדל מהודרות.
/etc/grok/managed_config.toml, ואחר כך $GROK_HOME/managed_config.toml (ברירות מחדל של צי, מסונכרנות מהקונסולה).
$GROK_HOME/config.toml (ההגדרות שלכם. /settings כותב לכאן). ברירת המחדל של $GROK_HOME היא ~/.grok.
.grok/config.toml של הפרויקט: רק [mcp_servers], [plugins], [permission], ו-[mcp] max_output_bytes.
GROK_CONFIG (JSON בתוך השורה) או GROK_CONFIG_PATH (קובץ JSON או TOML). מפתחות ברשימת ההיתר בלבד.
$GROK_HOME/requirements.toml, ואחר כך /etc/grok/requirements.toml, ואחר כך MDM של macOS בשם ai.x.grok. שכבת מנהל. מפתחות שמסומנים pin בטבלה אי אפשר לדרוס. מפתחות שמסומנים yes תקפים גם בקובץ הזה.
משתני סביבה GROK_*.
דגלי CLI כגון --model, --sandbox, --yolo.
הריצו grok inspect או grok inspect --json כדי לראות אילו קבצים וערכים ניצחו.
הגדרות ברמת המשתמש נמצאות ב-$GROK_HOME/config.toml (ברירת מחדל ~/.grok/config.toml, ב-Windows %USERPROFILE%\.grok\config.toml). דריסות בהיקף פרויקט נמצאות ב-.grok/config.toml ותורמות רק את [mcp_servers], [plugins], [permission], ו-[mcp] max_output_bytes.
Requirements מסמן אם אפשר לקבוע את אותו מפתח ב-requirements.toml: pin אי אפשר לדרוס (כולל סביבה ו-CLI במקום שבו הפותר מכבד את הנעילה). yes מתקבל בקובץ הזה. אין לא נקרא מ-requirements.toml. Managed מסמן אם ערך צי ב-managed_config.toml עומד (fleet), הקובץ של המשתמש מנצח (user), או שלא חל כלל מיזוג (אין): המפתח נקרא מקובץ אחד בלבד, או מוחל על הקובץ שמחזיק אותו.
כינוי של [grok_com_config]. כל מפתח grok_com_config.* עובד גם כ-auth.*.
auth.auth_provider_command
string
yes
user
קובץ בינארי חיצוני לאימות. stdout הוא הטוקן. כש-endpoints.models_base_url או models_list_url מוגדרים, רשימת נקודת הקצה הזו קובעת אילו מודלים מוצעים. גם GROK_AUTH_PROVIDER_COMMAND. תקף גם כ-grok_com_config.auth_provider_command.
auth.auth_provider_label
string
yes
user
תווית כפתור התחברות לספק אימות חיצוני. גם GROK_AUTH_PROVIDER_LABEL. תקף גם כ-grok_com_config.auth_provider_label.
auth.auth_token_ttl
number
yes
user
TTL של הטוקן בשניות לספקים שמחזירים טוקן חשוף. גם GROK_AUTH_TOKEN_TTL. תקף גם כ-grok_com_config.auth_token_ttl.
auth.disable_api_key_auth
boolean
pin
user
לסרב לאימות במפתח API כדי שרק ה-IdP של הפריסה יוכל להתחבר. גם GROK_DISABLE_API_KEY_AUTH. תקף גם כ-grok_com_config.disable_api_key_auth.
auth.force_login_team_uuid
string / string[]
pin
user
לדרוש התחברות ל-UUID הזה של צוות, או לכל אחד במערך. מערך ריק נכשל סגור. גם GROK_FORCE_LOGIN_TEAM_ID. תקף גם כ-grok_com_config.force_login_team_uuid.
auth.grok_ws_origin
string
yes
user
מקור Websocket עבור grok.com. גם GROK_WS_ORIGIN. תקף גם כ-grok_com_config.grok_ws_origin.
auth.grok_ws_url
string
yes
user
כתובת Websocket של הממסר. גם GROK_WS_URL. תקף גם כ-grok_com_config.grok_ws_url.
auth.oauth2
table
yes
user
ספק OAuth2 שבשימוש כש-OIDC ארגוני לא מוגדר. תקף גם כ-grok_com_config.oauth2.
auth.oauth2.client_id
string
yes
user
מזהה לקוח OAuth2. גם GROK_OAUTH2_CLIENT_ID. תקף גם כ-grok_com_config.oauth2.client_id.
auth.oauth2.issuer
string
yes
user
כתובת issuer של OAuth2. גם GROK_OAUTH2_ISSUER. תקף גם כ-grok_com_config.oauth2.issuer.
auth.oauth2.principal_id
string
yes
user
מזהה principal נדרש כש-principal_type מוגדר. גם GROK_OAUTH2_PRINCIPAL_ID. תקף גם כ-grok_com_config.oauth2.principal_id.
auth.oauth2.principal_type
string
yes
user
סוג principal של הטוקן, למשל Team. גם GROK_OAUTH2_PRINCIPAL_TYPE. תקף גם כ-grok_com_config.oauth2.principal_type.
auth.oauth2.referrer
string
yes
user
Referrer לייחוס שימוש ב-OAuth. גם GROK_OAUTH2_REFERRER. תקף גם כ-grok_com_config.oauth2.referrer.
auth.oauth2.scopes
string[]
yes
user
היקפי OAuth2. גם GROK_OAUTH2_SCOPES. תקף גם כ-grok_com_config.oauth2.scopes.
auth.oidc
table
yes
user
הגדרות ספק זהות OIDC של הלקוח. תקף גם כ-grok_com_config.oidc.
auth.oidc.audience
string
yes
user
audience אופציונלי של OIDC. גם GROK_OIDC_AUDIENCE. תקף גם כ-grok_com_config.oidc.audience.
auth.oidc.client_id
string
yes
user
מזהה לקוח OIDC. גם GROK_OIDC_CLIENT_ID. תקף גם כ-grok_com_config.oidc.client_id.
auth.oidc.issuer
string
yes
user
כתובת issuer של OIDC. גם GROK_OIDC_ISSUER. תקף גם כ-grok_com_config.oidc.issuer.
auth.oidc.scopes
string[]
yes
user
היקפי OIDC. גם GROK_OIDC_SCOPES. תקף גם כ-grok_com_config.oidc.scopes.
auth.preferred_method
api_key / oidc
yes
user
לנעול את האימות האוטומטי לשיטה אחת בלי מעבר לשיטה אחרת. תקף גם כ-grok_com_config.preferred_method.
auth.token_header
string
yes
user
שם הכותרת שנושאת את טוקן האימות של ה-CLI. ברירת מחדל xai-grok-cli. תקף גם כ-grok_com_config.token_header.
טלאה של [[campaigns]] או [[experiments]] יכולה לכבות את מצב Auto ולעולם לא להדליק אותו, ורק auto_mode.enabled של שכבת requirements עצמה דורס אותו. בזמן ש-config.toml או managed_config.toml נכשלים בטעינה, קמפיין מכל קובץ אחר או מהשרת שומר את מצב Auto כבוי, אבל שאר המפתחות שלו לא חלים, מלבד כללי הדחייה שרשומים תחת permission. ראו campaigns ו-experiments לגבי מתי טלאה חלה.
טלאי קמפיין בעלי שם שחלים מתחת ל-requirements. אחד יכול לכבות את auto_mode.enabled ולעולם לא להדליק, ואף אחד לא יכול לקבוע ui.permission_mode רופף יותר. הפריסה מפרסמת אותם.
לבדוק עדכוני CLI בהפעלה. גם GROK_DISABLE_AUTOUPDATER כדי לדכא.
cli.channel
stable / alpha / enterprise / other
pin
user
ערוץ הפצה, אחרי הסרת רווחים בקצוות והמרה לאותיות קטנות. ערך ריק פירושו stable. שמות לא מוכרים עוקבים אחרי כללי הגרסה של stable. GROK_UPDATE_CHANNEL נועל את הערוץ מעל הערך הזה, כולל כל זרוע [[experiments]] שקובעת אותו, אלא אם קובץ requirements קובע את [cli] channel ישירות. כל עוד הוא מוגדר, grok update מסרב לעבור לערוץ אחר. קבעו אותו לערוץ ציבורי או לערוץ מותאם ש-cli.channels.<name> מגדיר. Grok מתעלם מכל ערך אחר, ו-grok inspect מציג אזהרה. גרסאות שקדמו ל-1.0.70 מתעלמות מ-GROK_UPDATE_CHANNEL.
מגדיר ערוץ עדכון מותאם שמתקין את binary מהראשון מבין sources שעונה, ונבחר עם cli.channel או GROK_UPDATE_CHANNEL.
cli.grove
boolean או grove / grove-fuse / grove-nfs / nfs / all / copy / true / false / 1 / 0 / on / off
yes
user
נוחות שמפעילה את שניהם, grok clone וגם Grove של סשן / -w, כשהמתגים הספציפיים לא מוגדרים. גם GROK_GROVE. false / copy / off אומר שהפעלת הכל כבויה (ממשיכים הלאה). זה לא כופה כיבוי של שני המשטחים. [cli] grove_worktree ו-GROK_WORKTREE_TYPE עדיין מנצחים לעצי עבודה. GROK_CLONE עדיין מנצח עבור clone. grove_worktree = false מרוחק עדיין מכבה רק עצי עבודה.
cli.grove_worktree
boolean או grove / grove-fuse / grove-nfs / nfs / copy / true / false / 1 / 0 / on / off
yes
user
Grove של סשן / -w מול copy. ברירת מחדל היא copy, או Grove כשמקור עץ העבודה כבר נמצא בתוך עיגון Grove (checkout של grok clone או עץ עבודה של Grove). נפרד ממצב היצירה cli.worktree_type. גם GROK_WORKTREE_TYPE. סדר שכבות: request, env, local, enable-all (GROK_GROVE / [cli] grove), remote-true, מקור Grove (source). אחר כך כיבוי אחרון: grove_worktree = false מרוחק מוביל ל-copy (remote_kill). היעדר הגדרות מרוחקות אינו כיבוי: מקומי, סביבה, בקשה, הפעלת הכל ומקור עדיין חלים. קבעו false או GROK_WORKTREE_TYPE=copy כדי לשמור על copy למקור Grove. לא מפעיל את grok clone.
cli.installer
string
אין
user
איזה מתקין הגדיר לאחרונה את ה-CLI הזה, ומשמש לבחירת נתיב העדכון.
cli.maximum_version
string
pin
user
הגרסה הגבוהה ביותר שהמעדכן או מעבר ערוץ מתקינים. גם GROK_MAXIMUM_VERSION.
cli.minimum_version
string
pin
user
הגרסה הנמוכה ביותר שהמעדכן או מעבר ערוץ נוחתים עליה. גם GROK_MINIMUM_VERSION.
cli.npm_registry
string
yes
user
מאגר npm שהמעדכן האוטומטי משתמש בו.
cli.nfs_worktree
כמו cli.grove_worktree
yes
user
כינוי קריאה של cli.grove_worktree.
cli.required_maximum_version
string
pin
user
מקסימום קשיח לגרסת CLI: Grok מסרב להתחיל מעליו, ושום עדכון או מעבר ערוץ לא מתקין מעליו. גם GROK_REQUIRED_MAXIMUM_VERSION.
cli.required_minimum_version
string
pin
user
מינימום קשיח לגרסת CLI: Grok מסרב להתחיל מתחתיו, ושום עדכון או מעבר ערוץ לא נוחת מתחתיו. גם GROK_REQUIRED_MINIMUM_VERSION.
cli.session_picker_grouped
boolean
yes
user
לקבץ סשנים לפי מאגר בבורר וברשימות CLI.
cli.session_registry
boolean
pin
user
להשתתף במרשם הסשנים בין תהליכים. נעילת requirements גוברת על GROK_SESSION_REGISTRY.
cli.show_tips
boolean
pin
user
טיפים בהפעלה.
cli.use_leader
boolean
pin
user
להשתמש בתהליך המוביל לטעינה מחדש של הגדרות ולמעקבי MCP.
cli.worktree_type
string
yes
user
מצב יצירה כשהערך הוא linked, standalone, או git. הכתיבים grove, grove-fuse, grove-nfs, nfs, ו-copy מזינים גם את שער Grove של סשן / -w (כמו cli.grove_worktree). הם לא ערכי מצב יצירה.
רושם את המוביל כעובד פרטי של Cursor כדי ש-Cursor Cloud Agents יוכלו לרוץ מול המכונה הזו. נדרש build עם תמיכה ב-Cursor worker. התחלה מוצלחת פותחת גם דלת מאגר שכפולים לכתובות git שלא נמצאות ב-worker_dirs. [worker] הוא כינוי לטבלה הזו. כשקובץ אחד קובע את שתיהן, מפתחות [worker] מנצחים.
מפתח
סוג / ערכים
Requirements
Managed
פרטים
cursor_worker.auto_start
boolean
yes
user
לרשום את המוביל הזה כעובד פרטי של Cursor בהפעלה. ברירת מחדל false.
cursor_worker.name
string
yes
user
שם תצוגה של העובד שמוצג ב-Cursor. ברירת המחדל היא שם המארח של המכונה.
cursor_worker.worker_dirs
string[]
yes
user
נתיבים מוחלטים של תיקיות המאגר שמוצעות ל-Cursor Cloud Agents. הראשון הוא תיקיית העבודה הרשומה.
cursor_worker.max_agents
integer
yes
user
מקסימום Cloud Agents שנתפסים במקביל לכל דלת (תפיסה במנוחה משחררת את המשבצת שלה). מעבר לכך סוכן חדש נכשל במקום להיכנס לתור. כשהמפתח לא מוגדר אין תקרה.
cursor_worker.any_repo
boolean
yes
user
לרשום גם את דלת any-repo, שמשכפלת כל מאגר ש-Cloud Agent מביא. הצטרפות מפורשת, ברירת מחדל כבויה.
cursor_worker.hub_url
string
yes
user
כתובת בסיס של Computer Hub שמשמשת לקבלת סשן Cursor. ברירת המחדל נגזרת מכתובת ה-hub של המוביל.
cursor_worker.rewrite_shell_output
boolean
yes
user
לכתוב מחדש נתיבי עץ עבודה וצילום בפלט המעטפת חזרה לתיקייה הרשומה. ברירת מחדל true.
cursor_worker.engine
"rust", "typescript"
yes
user
איזה worker מריץ grok worker. "typescript" מריץ את ה-worker של Cursor עצמו ומעביר לו כל ארגומנט אחרי grok worker (build שלא אורז Cursor worker נופל חזרה ל-"rust"). ברירת מחדל "rust".
לכתוב דוח פאניקה תחת $GROK_HOME/crash/. גם GROK_CRASH_HANDLER.
diagnostics.error_reporting
boolean
pin
user
לשלוח דוחות קריסה. כשהמפתח לא מוגדר ההתנהגות עוקבת אחרי טלמטריה, ו-builds ששולחים מדדי שימוש שולחים אותם כברירת מחדל. גם GROK_ERROR_REPORTING, וכל DISABLE_ERROR_REPORTING לא ריק מכבה אותם. builds בלי מדדי שימוש קוראים את ה-pin רק מ-requirements.toml של המשתמש.
מפתח ניהול לפריסות ארגוניות. גם GROK_DEPLOYMENT_KEY.
endpoints.feedback_base_url
string
pin
user
היעד שאליו נשלחות הגשות משוב. גם GROK_FEEDBACK_BASE_URL.
endpoints.managed_config_url
string
yes
user
עקיפה של נקודת הקצה של התצורה המנוהלת. גם GROK_MANAGED_CONFIG_URL.
endpoints.models_base_url
string
pin
user
כתובת בסיס מותאמת להסקה. כאשר auth_provider_command מוגדר, {models_base_url}/models קובע אילו מודלים מוצעים. גם GROK_MODELS_BASE_URL.
endpoints.models_list_url
string
pin
user
עקיפה של URL רשימת המודלים. כאשר auth_provider_command מוגדר, הרשימה הזו קובעת אילו מודלים מוצעים. גם GROK_MODELS_LIST_URL. כינוי models_endpoint.
endpoints.trace_upload_bucket
string
pin
user
דלי gs:// או s3:// ישיר לעקבות. עוקף את הפרוקסי. נתיב אחרי הדלי הוא קידומת מפתח האובייקט לכל העלאה: s3://example-traces/team-a כותב team-a/<session>/turn_<n>/.... רווח לבן ו / סביב הנתיב נחתכים. גם GROK_TRACE_UPLOAD_BUCKET. לדלי gs://, GROK_TELEMETRY_GCS_BUCKET עדיין מחליף את כתובת ה URL של הדלי, גם מעל pin. הנתיב שלו הוא אז הקידומת.
endpoints.trace_upload_credentials
string
pin
user
JSON מוטמע של חשבון שירות GCS או אישורי AWS לדלי הזה. גובר על trace_upload_credentials_file ואין לו משתנה סביבה.
endpoints.trace_upload_credentials_file
string (path)
pin
user
נתיב לקובץ JSON של חשבון שירות GCS או לקובץ אישורי AWS לדלי הזה. גם GROK_TRACE_UPLOAD_CREDENTIALS_FILE.
endpoints.trace_upload_endpoint_url
string
pin
user
נקודת קצה תואמת S3 מותאמת להעלאות של דלי s3://. גם GROK_TRACE_UPLOAD_ENDPOINT_URL.
endpoints.trace_upload_region
string
pin
user
אזור AWS להעלאות של דלי s3://. ברירת מחדל us-east-1. גם GROK_TRACE_UPLOAD_REGION.
endpoints.trace_upload_url
string
pin
user
יעד הפרוקסי לעקבות כשלא הוגדר דלי ישיר. גם GROK_TRACE_UPLOAD_URL.
endpoints.web_base_url
string
pin
user
אפליקציית הווב של Grok למחברים: הקישור /mcps, תווית המקטע Managed, והודעת ההתחברות המתארחת. ברירת מחדל https://grok.com. חייב להיות URL של http או https, אחרת נעשה שימוש בברירת המחדל. קישורי שיתוף ולקוחות של אפליקציית הווב קוראים את GROK_CODE_WEB_URL במקום. /usage וקישורי חיוב נשארים ב grok.com. גם GROK_WEB_BASE_URL.
endpoints.xai_api_base_url
string
pin
user
בסיס ה API הציבורי של xAI. גם GROK_XAI_API_BASE_URL.
טלאים לכל מכונה שמוחלים על הקובץ שמחזיק אותם לפני מיזוג הקבצים. ראה את ההערות שמתחת לטבלה הזו.
experiments.id
string
yes
-
שם הניסוי, [a-z0-9._-] ולכל היותר 64 תווים, ייחודי בתוך הקובץ.
experiments.percent
integer 0-100
yes
-
חלק המכונות בכל זרוע, ברירת מחדל 0 ולכל היותר 100 / number of arms.
experiments.include
array of strings
yes
-
שמות משתמש, כתובות אימייל של התחברות, או מזהי סוכן לשיבוץ בזרוע אלא אם הם מוחרגים או מחוץ לטווח הגרסאות. עד 1,000 רשומות. ההתאמה מתעלמת מרישיות.
experiments.exclude
array of strings
yes
-
שמות משתמש, כתובות אימייל של התחברות, או מזהי סוכן כדי להשאיר מחוץ לכל זרוע. grok inspect מציג מכונה כזו כ excluded (excluded_by_email), excluded_by_username או excluded_by_agent_id, והטלמטריה experiment_assigned שלה נושאת outcome = excluded עם הסיבה הזו ובלי זרוע. עד 1,000 רשומות. ההתאמה מתעלמת מרישיות.
experiments.dismissible
boolean
yes
-
מאפשר למשתמש לעזוב את הניסוי (רשומת תצורה מנוהלת או של משתמש, שהזרוע שלה מגדירה cli.channel, אפשר לעזוב בלי השדה הזה, אלא אם רשומת dismissible בקובץ אחר עם אותו id מגדירה models.default). דורש minimum_version, זרוע שמגדירה models.default או cli.channel, ואין זרוע שמגדירה את ההגדרה האחרת. ברירת מחדל false.
experiments.minimum_version
string (semver)
yes
-
גרסת CLI הנמוכה ביותר שהרשומה חלה עליה, כולל.
experiments.maximum_version
string (semver)
yes
-
גרסת CLI הגבוהה ביותר שהרשומה חלה עליה, כולל. לא מותר כאשר זרוע מגדירה cli.channel.
experiments.arms
table of tables
yes
-
זרועות בעלות שם, כל אחת עם ההגדרות שלה ועם include אופציונלי, ותופסות משבצות שוות לפי סדר השמות.
איך רשומת [[experiments]] משבצת את המכונה הזו:
מכונה בזרוע מקבלת את הגדרות הזרוע כחלק מהקובץ שמחזיק את הרשומה, חוץ מ auto_mode.enabled, שזרוע יכולה לכבות ולעולם לא להדליק (ראה auto_mode). מכונה שאינה בזרוע שומרת את ערכי הקובץ, ו grok inspect והטלמטריה מכנים אותה לפי התוצאה: control, excluded, dismissed או disabled. ארבעת אלה הם שמות זרוע שמורים. לרשומה בלי arms יש זרוע אחת בשם treatment, ומפתחות הרשומה שנותרו הם ההגדרות שלה. כשיש arms, include מוגדר בכל זרוע.
הכללים חלים לפי הסדר: גרסת CLI מחוץ ל minimum_version..=maximum_version היא control, אחר כך מכונה בלי מזהה סוכן, אחר כך exclude, אחר כך עזיבת המשתמש מרשומה שהוא רשאי לעזוב, אחר כך include, ואחר כך הדלי.
משתמש עוזב ניסוי dismissible שהזרועות שלו מגדירות models.default על ידי בחירת מודל ברירת מחדל ב grok, וניסוי שהזרועות שלו מגדירות cli.channel באמצעות grok update --stable, --alpha, --enterprise או --channel. זרוע cli.channel ב managed_config.toml או ב config.toml אפשר לעזוב כך בלי dismissible, רשומת requirements צריכה אותו, ומזהה שהרשומות שלו שאפשר לעזוב על פני קבצים מגדירות את שתי ההגדרות אי אפשר לעזוב בכלל. בחירה לא עוזבת דבר כאשר דרישה הייתה אז קובעת ערך אחר, ונכשלת כאשר אי אפשר לשמור את העזיבה. העזיבה היא לפי מזהה ניסוי ונשמרת ב $GROK_HOME/experiments_state.json. grok inspect מדווח dismissed. כל עוד אי אפשר לקרוא או לנתח את הקובץ הזה, המכונה נשארת מחוץ לכל ניסוי שהמשתמש רשאי לעזוב, ומדווחת כ dismissed (dismissals_unreadable). בחירה שהייתה עוזבת אחד נכשלת עד שהקובץ מתוקן. מחיקת הקובץ מחזירה הצטרפות לכל ניסוי שהמשתמש עזב. בילדים ישנים יותר מהעזיבות מחילים את הזרוע בכל מקרה, לכן הגדר minimum_version לגרסה שיש בה אותן. עזיבה מורידה את כל הזרוע של הרשומה, ולכן רשומת dismissible אינה דרך לאכוף הגדרה, ומזהה שהרשומות dismissible שלו על פני קבצים כלשהם מגדירות גם models.default וגם cli.channel אי אפשר לעזוב. ניקוי מודל ברירת המחדל לא עוזב דבר.
הדלי הוא שמונת הבתים הראשונים של sha256("<id>/<agent id>"), שנקראים כמספר שלם big-endian, מודולו 10,000, והוא יציב בין הפעלות. מזהה הסוכן הוא GROK_AGENT_ID או המזהה שבמטמון ב $GROK_HOME/agent_id. ההפעלה הראשונה של מכונה היא control עד שהמטמון הזה קיים. התאמת שם המשתמש ב include וב exclude היא $USER, אחר כך $LOGNAME, אחר כך $USERNAME. רשומה מתאימה גם לכתובת האימייל של כל התחברות ב $GROK_HOME/auth.json (או הקובץ ש GROK_AUTH_PATH מציין) או ב GROK_AUTH, כך שרשומה יכולה להיות שם משתמש, מזהה סוכן, או כתובת אימייל של התחברות. ההתאמה מתעלמת מרישיות. גרסאות שקדמו ל 1.0.70 לא מתאימות כתובות אימייל, לכן יש גם לרשום את שם המשתמש או את מזהה הסוכן של האדם, או להגדיר minimum_version ל 1.0.70 או מאוחר יותר.
העלאת percent מוסיפה מכונות לזרוע ולעולם לא מעבירה מכונה בין זרועות. שינוי id, או הוספה, הסרה, או שינוי שם של זרוע, משבץ מחדש כל מכונה.
כאשר שני קבצים משתמשים מחדש ב id, שני הטלאים חלים ו grok inspect מדווח את השיבוץ של קובץ המפעיל מעל השיבוץ של המשתמש, ואחר כך את הקובץ שמנצח במיזוג.
fail_closed ב requirements.toml נקרא מהקובץ לפני כל טלאי ואי אפשר להעלות אותו בהדרגה.
שני מקורות מזהה הסוכן בשליטת המשתמש. משתמש יכול לבחור איזו זרוע חלה, ולעולם לא את מה שהיא קובעת. בקובץ requirements כל זרוע חייבת להיות מדיניות קבילה בפני עצמה.
כדי לכבות כל רשומה בכל קובץ, הגדר GROK_DISABLE_EXPERIMENTS=1, או כתוב [experiments] enabled = false במקום רשימת רשומות בכל קובץ תצורה: config.toml, כל managed_config.toml, קובץ requirements או מטען ה MDM. כל enabled = false מכבה את הניסויים. enabled = true לא גובר עליו. כל רשומה היא אז disabled (kill_switch), או disabled (env_opt_out) תחת המשתנה, ב grok inspect, והיא לא מחילה דבר. ניסויים שעזבת נשארים עזובים כשמחזירים את הניסויים לפעולה. גרסאות שקדמו ל 1.0.70 מתעלמות משניהם.
השרת יכול לכבות ניסויים לחשבון אחד: קמפיין מרוחק (campaigns בתשובת /v1/settings) שהטלאי שלו הוא experiments = { enabled = false } נחשב כמו מתג הקובץ, גם כש features.campaigns או GROK_CAMPAIGNS=0 משאירים את טלאי הקמפיינים כבויים. כל רשומה היא אז disabled (remote_opt_out), אלא אם מתג מקומי כבר כיבה אותה. כל שליפת הגדרות רושמת את המתג ב $GROK_HOME/experiments_remote_opt_out, והשליפה האחרונה גוברת. כל תהליך grok קורא את הקובץ הזה פעם אחת, בטעינת התצורה הראשונה, ולכן שינוי נכנס לתוקף בהפעלה הבאה. החשבון האחרון ששולף הגדרות במכונה הוא שקובע, וקובץ שאי אפשר לקרוא נחשב כבוי. גרסאות שקדמו ל 1.0.75 מתעלמות מזה.
32 הרשומות הראשונות בקובץ חלות, והשאר זוכות להתעלמות עם אזהרה. רשומה מחזיקה לכל היותר 10 זרועות. רשומה לא תקינה מדולגת ונכתבת ליומן לפי אינדקס ושדה. שאר הקובץ עדיין חל.
grok inspect מפרט את השיבוצים. המזהה של כל שיבוץ והזרוע שלו, או התוצאה של מכונה בלי זרוע, נשלחים בכל אירוע מוצר כל עוד הטלמטריה פעילה. הכותרת x-grok-experiments בבקשות אל cli-chat-proxy נושאת כל מזהה עם הזרוע שלו, ו control למכונה בלי זרוע, בכל מצב טלמטריה.
# requirements.toml: 10% מהצי רץ בערוץ alpha. שתי מכונות אף פעם לא רצות בו
[[experiments]]
id = "alpha-channel-2026-10"
percent = 10
exclude = ["build-server", "ci-runner"]
[experiments.cli]
channel = "alpha"
למכונה בזרוע יש cli.channel נעוץ ל alpha. כל מכונה אחרת שומרת את ערך הקובץ. העלה את percent כדי להרחיב את הפריסה, הוסף שם משתמש או מזהה סוכן ל include כדי להכניס מכונה אחת בכפייה, ומחק את הרשומה כדי לחזור לאחור. grok inspect מציג alpha-channel-2026-10: treatment (bucket 731) על מכונה בזרוע ו alpha-channel-2026-10: control (bucket 4301) על מכונה שאינה בזרוע.
זרוע שמגדירה cli.channel היא דריסה זמנית של הערוץ ב config.toml של המשתמש עצמו, בכל קובץ שנושא את הרשומה: היא לא שומרת דבר, ו grok inspect מדווח Update channel: <name> (from an experiment arm). פקודה מפורשת grok update --stable, --alpha, --enterprise או --channel עוזבת את הניסוי כשהמשתמש רשאי לעזוב אותו, והדבר רושם את העזיבה ב experiments_state.json: זרוע ערוץ ב managed_config.toml או ב config.toml, או זרוע requirements כשהרשומה היא dismissible. רשומה שהמשתמש רשאי לעזוב מגדירה אחד מבין cli.channel ו models.default. הטוען דוחה רשומה שמגדירה את שניהם, ומזהה שהרשומות שלו בקבצים שונים מגדירות את שניהם אי אפשר לעזוב. זרוע requirements שהמשתמש לא יכול לעזוב מסרבת לבחירה בהודעה שמציינת את הניסוי ואת דרכי היציאה (רשימת exclude שלה, או GROK_DISABLE_EXPERIMENTS). לפני 1.0.71 ערוץ ב config.toml השאיר מכונה מחוץ להעלאה הדרגתית של managed_config.toml בכוחות עצמו. רשומה בלי minimum_version של 1.0.71 או מאוחר יותר נכתבה תחת הכלל הזה, ולכן ה grok update הראשון שמתקין רושם את העזיבה של כל העלאה הדרגתית כזו למכונה ש config.toml שלה מגדיר ערוץ אחר, או לא מתקין דבר כשאי אפשר לרשום אותן. מתג שנפתר משאיר בלי עזיבה את ההעלאות ההדרגתיות אל הערוץ שברשומה שלו, או את כל ההעלאות ההדרגתיות כשאין ברשומה שם ערוץ, אלא אם הערוץ של המשתמש עצמו בזמן המתג היה ערוץ אחר. ערוץ שהוגדר מאז לא נספר. בילד ציבורי שהתצורה שלו לא נטענת לא רושם דבר ומתעדכן כמו קודם. --check מדווח אותו דבר. רשומה עם minimum_version = "1.0.71" או מאוחר יותר דורסת את ערוץ המשתמש כמתואר למעלה. כשהזרוע מפסיקה לחול, כי הרשומה איננה, percent הורד או המכונה הוחרגה, העדכון הבא מחזיר את ההתקנה לערוץ של המשתמש עצמו. GROK_UPDATE_CHANNEL גובר על הזרוע, ו [cli] channel שקובץ ה requirements הגבוה ביותר מגדיר בעצמו גובר על שניהם. זרוע ערוץ בקובץ requirements גבוה יותר שמה את הנעיצה הזו בצד. השתמש בנעיצה רק למנדט קשיח. הגדרות אחרות שזרוע מטליאה, ובהן models.default, נעזבות רק דרך רשומת dismissible, בכל קובץ.
במסלול המעטפת, הסוכן יכול לשלוח המשכים לסוכני המשנה הפעילים שלו (send_subagent_message). במסלול הדמון, כששירות הרקע של Grok מציע זאת, סוכנים מקבלים SendToAgent על פני עץ הסשן, כך שסוכן משנה יכול גם לשלוח הודעה לסשן השורש. Grok מזהיר כשהשירות לא מציע זאת. שם, לתצוגה של סוכן משנה שהסשן השורש יצר בזמן אמת יש גם composer לשליחת הודעה אליו, שחיבור מחדש או טעינה מחדש שומרים. לתצוגה שנבנתה לראשונה משידור חוזר, כמו אחרי resume, אין (ראו סוכני משנה). ברירת המחדל false. גם GROK_ACTIVE_AGENT_MESSAGES.
features.ask_answer_rows
boolean
pin
user
מצייר את התשובות שלך לשאלות הסוכן כשורות משלך. כבוי שומר את שורת הכלי Ask. ברירת המחדל false. גם GROK_ASK_ANSWER_ROWS.
features.ask_user_question
boolean
pin
user
הפעלה או השבתה של ask_user_question. ברירת המחדל true. גם GROK_ASK_USER_QUESTION.
features.auto_wake
boolean
pin
user
הפעלה או השבתה של auto_wake. ברירת המחדל true. גם GROK_AUTO_WAKE.
features.backend_tools
boolean
pin
user
הפעלה או השבתה של backend_tools. ברירת המחדל true. גם GROK_BACKEND_SEARCH.
features.campaigns
boolean
yes
user
הפעלת טלאי קמפיין מרוחקים. GROK_CAMPAIGNS=0 עדיין משבית גם כשהדרישות מגדירות זאת ל-true.
features.cancel_rewind
boolean
pin
user
הפעלה או השבתה של cancel_rewind. ברירת המחדל true. גם GROK_CANCEL_REWIND.
features.codebase_indexing
boolean / string[]
pin
user
אינדוקס גרף של בסיס הקוד. true מאנדקס מאגרי git, או מעבירים globs של include/exclude.
features.compaction_detail
none / minimal / balanced / verbose
yes
user
רמת פירוט מילולית לדחיסת segments. גם GROK_COMPACTION_DETAIL.
features.compaction_mode
summary / transcript / segments
yes
user
אסטרטגיית דחיסה. גם GROK_COMPACTION_MODE.
features.compaction_tool_choice
string
yes
user
רמז לבחירת כלי שמשמש במהלך הדחיסה.
features.compaction_verbatim_input
boolean
pin
user
הפעלה או השבתה של compaction_verbatim_input. ברירת המחדל true. גם GROK_COMPACTION_VERBATIM_INPUT.
features.cursor_marketplace
boolean
pin
user
מציע את קטלוג התוספים של Cursor ב-Marketplace של /plugins. כבוי משאיר את תוספי הקטלוג המותקנים נטענים. ברירת המחדל false. גם GROK_CURSOR_MARKETPLACE.
features.daemon_feedback_drafts
boolean
pin
user
רק במסלול הדמון: שירות הרקע של Grok במכונה הזו שומר את טיוטות המשוב של הסשנים, ש-/feedback מציג והכלי send_feedback שומר. כבוי, /feedback מסרב לטיוטות שלו במסלול הדמון והסוכן לא מקבל את send_feedback. ברירת המחדל true. גם GROK_DAEMON_FEEDBACK_DRAFTS. כשמכבים זאת מרחוק, לא המפתח הזה ולא המשתנה מדליקים אותו בחזרה. נעיצת דרישות כן. נקרא כששירות הרקע של Grok מתחיל, כך ששינוי חל אחרי הפעלה מחדש. השירות שכל החלונות חולקים קורא אותו בלי הסביבה של חלון עצמו או שכבת GROK_CONFIG, ו-grok leader kill מפעיל אותו מחדש.
features.dock
boolean
pin
user
הפעלה או השבתה של dock. ברירת המחדל false. גם GROK_DOCK.
features.feedback
boolean
pin
user
הפעלה או השבתה של feedback. ברירת המחדל true. גם GROK_FEEDBACK_ENABLED.
features.feedback_trace_card
boolean
pin
user
הצגת שאלת הסכמה להעלאת trace אחרי /feedback. ברירת המחדל false. גם GROK_FEEDBACK_TRACE_CARD.
features.file_acceleration
boolean
pin
user
מעביר את מערכות הקבצים של סשנים מקומיים למאיץ קבצים כשהבילד מתקין אחד. ברירת המחדל false. גם GROK_FILE_ACCELERATION.
features.image_edit_model_override
string
yes
user
מזהה מודל Imagine עבור image_edit.
features.image_gen
boolean
pin
user
הפעלת image_gen / /imagine.
features.image_gen_model_override
string
yes
user
מזהה מודל Imagine עבור image_gen. ריק מפנה לברירת המחדל שמוגדרת מרחוק.
features.lsp_tools
boolean
pin
user
הפעלה או השבתה של lsp_tools. ברירת המחדל false. גם GROK_LSP_TOOLS.
הפעלה מחדש אוטומטית של שרתי MCP ב-stdio אחרי כשל תעבורה. גם GROK_MCP_AUTO_RESTART.
features.mcp_liveness_watchers
boolean
yes
user
סקר של תעבורות MCP ודחיפת עדכוני server_status. מתג חירום כש-false.
features.mcp_push_server_status
boolean
yes
user
ה-pager נרשם לדחיפת server_status של MCP. משתנה הסביבה של התהליך GROK_MCP_PUSH_SERVER_STATUS גובר בהפעלה.
features.mcp_recursive_config_watch
boolean
yes
user
מעקב אחרי <cwd>/ ו-<cwd>/.grok/ לעריכות של תצורת MCP של הפרויקט. השם מטעה. המעקבים אינם רקורסיביים.
features.non_git_warning
boolean
yes
user
הצגת אזהרה חוסמת כש-Grok מתחיל מחוץ למאגר Git.
features.remember_mode
boolean
-
-
זכירת מצב ההרשאה האחרון בין סשנים. נקרא רק מ-config.toml של המשתמש.
features.remote_fetch
boolean
pin
fleet
נעיצת שליפה מרחוק של קטלוג מודלים ונכסים. המנוהל גובר על קובץ המשתמש כששניהם מוגדרים.
features.request_compression
boolean
pin
user
דחיסת גופי בקשה גדולים שנשלחים לשרתים שידוע שמפענחים אותם. חיבור דרך פרוקסי, עם אישור לקוח או עם חבילת CA נוספת נשאר לא דחוס כברירת מחדל. בחיבור כזה, רק נעיצה, הסביבה או קובץ תצורה מדליקים אותו. SSL_CERT_FILE לא נחשב לחבילת CA נוספת. ההגדרה המרוחקת וטלאי [[campaigns]] יכולים רק לכבות אותו. ברירת המחדל true. גם GROK_REQUEST_COMPRESSION.
features.resume_pagination
boolean
pin
user
פתיחת סשן שחודש בתורות החדשים ביותר וטעינת הקודמים כשגוללים למעלה. סשן שהסוכן שלו לא יכול לרשום את התורות שלו, ומצב מינימלי, טוענים כל תור. ברירת המחדל false. גם GROK_RESUME_PAGINATION. כשמכבים זאת מרחוק, לא המפתח הזה ולא המשתנה מדליקים אותו בחזרה. נעיצת דרישות כן. נקרא בהפעלה.
features.send_feedback_tool
boolean
pin
user
רק במסלול הדמון: להציע לסוכן את הכלי send_feedback, כשלחבילת הדמון יש אותו והיא שומרת את טיוטות המשוב של הסשנים (features.daemon_feedback_drafts), וגם features.feedback דלוק. הכלי של מסלול המעטפת עוקב אחרי features.feedback בלבד. כיבוי חל בהנחיה הבאה, חוץ מכך שתורות שמכשיר אחר מתחיל בסשן שומרים את הערך שהדמון התחיל איתו עד שהוא מופעל מחדש. הדלקה חלה בהנחיה הבאה, או אחרי הפעלה מחדש אם הדמון התחיל כשזה כבוי. ברירת המחדל true. גם GROK_SEND_FEEDBACK_TOOL.
features.session_recap
boolean
pin
user
הפעלה או השבתה של session_recap. ברירת המחדל true. גם GROK_SESSION_RECAP.
features.session_search
boolean
pin
user
הפעלה או השבתה של session_search. ברירת המחדל true. גם GROK_SESSION_SEARCH.
features.subagent_bundle
boolean
pin
user
טעינת הכישורים המובנים של מסלול הדמון מחבילת הכישורים בעלת הגרסה. מסלול המעטפת מתעלם מזה. ברירת המחדל true. גם GROK_SUBAGENT_BUNDLE. נקרא בהפעלה.
features.subagent_model_inheritance
boolean
pin
user
הסתרת ארגומנט model של סוכן המשנה כשכל מודל שאפשר לבחור הוא מודל xAI, כך שסוכני משנה יורשים את מודל ההורה. ברירת המחדל false. גם GROK_SUBAGENT_MODEL_INHERITANCE. נקרא כשסשן מתחיל. שינוי דורש הפעלה מחדש.
features.subagent_worktree_snapshot
boolean
pin
user
הפעלה או השבתה של subagent_worktree_snapshot. ברירת המחדל false. גם GROK_SUBAGENT_WORKTREE_SNAPSHOT.
features.support_permission
boolean
yes
user
לאפשר לסוכן לבקש הרשאה להרצות כלים.
features.telemetry
boolean / session_metrics / off
pin
user
מצב טלמטריית מוצר. ברירת המחדל ב-Enterprise היא off.
features.terminal_theme
boolean
pin
user
חשיפת ערכת הצבעים terminal הילידית לטרמינל במהלך ההשקה שלה. ברירת המחדל false. גם GROK_TERMINAL_THEME.
features.title_refresh
boolean
pin
user
רענון אוטומטי של כותרת בתחילת הסשן. נעצו זאת ב-requirements כדי לגבור על GROK_TITLE_REFRESH.
features.turn_summary
boolean
pin
user
הפעלה או השבתה של turn_summary. ברירת המחדל true. גם GROK_TURN_SUMMARY.
features.two_pass_compaction
boolean
pin
user
הפעלה או השבתה של two_pass_compaction. ברירת המחדל true. גם GROK_TWO_PASS_COMPACTION.
features.video_gen
boolean
pin
user
הפעלת כלי וידאו / /imagine-video.
features.voice_mode
boolean
pin
user
הפעלה או השבתה של voice_mode. ברירת המחדל true. גם GROK_VOICE_MODE.
features.web_fetch
boolean
pin
user
הפעלה או השבתה של web_fetch. ברירת המחדל false. גם GROK_WEB_FETCH.
features.workflow_conversion
boolean
pin
user
רק במסלול הדמון: הרצת תהליך עבודה ישן .rhai לפי שם מבקשת מהמודל להמיר אותו למודול JavaScript לצדו ולהתחיל אותו, כשלחבילת הדמון יש את כישור ההמרה. ברירת המחדל true. גם GROK_WORKFLOW_CONVERSION.
features.workspace_dashboard
boolean
pin
user
שימוש בלוח הבקרה של סביבת העבודה v2. ברירת המחדל true. גם GROK_WORKSPACE_DASHBOARD. נקרא בהפעלה. שינוי דורש הפעלה מחדש.
features.worktree_inherits_main_approvals
boolean
pin
user
worktree משתמש גם בתשובות "always allow" השמורות של ה-checkout הראשי שלו. תשובות "never allow" שלו חלות בכל מקרה. ברירת המחדל true. גם GROK_WORKTREE_INHERITS_MAIN_APPROVALS. נקרא כשסשן מתחיל, בכל פעם ש-Grok מפעיל את הדמון שלו במסלול הדמון, וכשדמון סביבת העבודה מחבר תיקייה.
features.write_file
boolean
pin
user
הפעלה או השבתה של write_file. ברירת המחדל true. גם GROK_WRITE_FILE. במסלול הדמון, חבילת דמון שלא רושמת turn_tool_identifiers לא יכולה למנוע את Write לבד, וכיבוי מונע גם את StrReplace, EditNotebook ו-Delete. הרצה עם -p מדפיסה הודעה כשזה קורה.
הגדרות websocket ו-OAuth/OIDC של Grok.com. [auth] הוא כינוי.
grok_com_config.auth_provider_command
string
yes
user
קובץ הרצה חיצוני לאימות. stdout הוא האסימון. כש-endpoints.models_base_url או models_list_url מוגדרים, הרשימה של נקודת הקצה הזו קובעת אילו מודלים מוצעים. גם GROK_AUTH_PROVIDER_COMMAND.
grok_com_config.auth_provider_label
string
yes
user
תווית כפתור ההתחברות לספק אימות חיצוני. גם GROK_AUTH_PROVIDER_LABEL.
grok_com_config.auth_token_ttl
number
yes
user
TTL של אסימון בשניות לספקים שמחזירים אסימון חשוף. גם GROK_AUTH_TOKEN_TTL.
grok_com_config.disable_api_key_auth
boolean
pin
user
סירוב לאימות במפתח API כדי שרק ה-IdP של הפריסה יוכל להתחבר. גם GROK_DISABLE_API_KEY_AUTH.
grok_com_config.force_login_team_uuid
string / string[]
pin
user
דרישת התחברות ל-UUID הזה של הצוות, או לכל אחד במערך. מערך ריק נכשל סגור. גם GROK_FORCE_LOGIN_TEAM_ID.
grok_com_config.grok_ws_origin
string
yes
user
מקור websocket עבור grok.com. גם GROK_WS_ORIGIN.
grok_com_config.grok_ws_url
string
yes
user
כתובת URL של websocket ממסר. גם GROK_WS_URL.
grok_com_config.oauth2
table
yes
user
ספק OAuth2 שמשמש כש-OIDC ארגוני לא מוגדר.
grok_com_config.oauth2.client_id
string
yes
user
מזהה לקוח OAuth2. גם GROK_OAUTH2_CLIENT_ID.
grok_com_config.oauth2.issuer
string
yes
user
כתובת URL של מנפיק OAuth2. גם GROK_OAUTH2_ISSUER.
grok_com_config.oauth2.principal_id
string
yes
user
מזהה principal נדרש כש-principal_type מוגדר. גם GROK_OAUTH2_PRINCIPAL_ID.
grok_com_config.oauth2.principal_type
string
yes
user
סוג principal של האסימון, למשל Team. גם GROK_OAUTH2_PRINCIPAL_TYPE.
grok_com_config.oauth2.referrer
string
yes
user
מפנה לייחוס שימוש ב-OAuth. גם GROK_OAUTH2_REFERRER.
grok_com_config.oauth2.scopes
string[]
yes
user
היקפי OAuth2. גם GROK_OAUTH2_SCOPES.
grok_com_config.oidc
table
yes
user
הגדרות ספק זהות OIDC של הלקוח.
grok_com_config.oidc.audience
string
yes
user
קהל OIDC אופציונלי. גם GROK_OIDC_AUDIENCE.
grok_com_config.oidc.client_id
string
yes
user
מזהה לקוח OIDC. גם GROK_OIDC_CLIENT_ID.
grok_com_config.oidc.issuer
string
yes
user
כתובת URL של מנפיק OIDC. גם GROK_OIDC_ISSUER.
grok_com_config.oidc.scopes
string[]
yes
user
היקפי OIDC. גם GROK_OIDC_SCOPES.
grok_com_config.preferred_method
api_key / oidc
yes
user
נעיצת אימות אוטומטי לשיטה אחת בלי מעבר הלאה.
grok_com_config.token_header
string
yes
user
שם הכותרת שנושאת את אסימון האימות של ה-CLI. ברירת המחדל xai-grok-cli.
המתנה להעלאות trace של סוף תור לפני החזרת תגובת ההנחיה. כבוי כברירת מחדל. הרצות headless חד פעמיות במקום זאת מרוקנות העלאות סוף תור ממתינות ביציאה בתוך תקציב מינימום מחייב (כ-150 שניות: חלון הניתוח ועוד ניסיון העלאה אחד) ש-upload_flush_timeout_secs, כשהוא גדול יותר, מאריך.
nav: מקשי vim ב-scrollback, בלוח הבקרה ובבוררים. all (ניסיוני, רק config.toml): nav ועוד עריכת vim בהנחיית הסוכן. ברירת המחדל off. גם /vim-mode ו-/settings → Vim keys, שמציעים off ו-nav. טלאי [[campaigns]] מדורג מתחת ל-config.toml שלך.
הזרקת תזכורת באמצע התור לנמק בקצרה אחרי קריאת מודל עם חשיבה נסתרת ארוכה. ברירת המחדל false. גם GROK_LONG_REASONING_REMINDER (מילת bool, או אובייקט JSON בצורת הטבלה הזו).
long_reasoning_reminder.tokens
integer
yes
user
אסימוני חשיבה בקריאת מודל אחת שנחשבים ארוכים. ברירת המחדל 1000, מוגבל ל-100-200000. גם tokens באובייקט ה-JSON של GROK_LONG_REASONING_REMINDER.
long_reasoning_reminder.delay
integer
yes
user
קריאות מודל להמתנה אחרי הקריאה הארוכה לפני התזכורת. ברירת המחדל 1, מוגבל ל-0-10. גם delay באובייקט ה-JSON של GROK_LONG_REASONING_REMINDER.
שליפת הגדרות MCP מנוהלות בעת ההפעלה. גם GROK_MANAGED_MCPS_ENABLED.
managed_mcps.gateway_tools_enabled
boolean
yes
user
חשיפת כלי שער MCP מנוהלים. גם GROK_MANAGED_MCP_GATEWAY_TOOLS_ENABLED.
managed_mcps.allow_external_auth
boolean
yes
user
לאפשר לכלי השער לרוץ כשאתה נכנס דרך ספק OIDC או auth.auth_provider_command שהמנפיק שלו אינו של xAI. ה-endpoints.cli_chat_proxy_base_url של הפריסה חייב לקבל את האסימון הזה. מפתחות API עדיין אינם עומדים בתנאי. ברירת מחדל false. גם GROK_MANAGED_MCP_ALLOW_EXTERNAL_AUTH.
מאגרי marketplace של תוספים ב-[[marketplace.sources]].
marketplace.require_sha
boolean
yes
user
רק להחמרה: התקנות ועדכונים של תוספים מרוחקים חייבים לנעוץ sha מלא של commit. גם GROK_MARKETPLACE_REQUIRE_SHA. לא המפתח הזה ולא משתנה הסביבה יכולים לכבות את השער בחזרה.
מפעיל או מכבה את הזיכרון. בשימוש כש-memory_v2.enabled אינו מוגדר. נעיצה כאן גם גוברת על memory_v2.enabled שאינו נעוץ. אלא אם המפתח נעוץ, GROK_MEMORY והדגל --no-memory גוברים עליו. ברירת מחדל: false.
memory_v2.enabled
boolean
pin
user
מפעיל או מכבה את הזיכרון. גובר על memory.enabled כשהוא מוגדר. אלא אם המפתח נעוץ, GROK_MEMORY והדגל --no-memory גוברים עליו. false שאינו נעוץ מכבה את הזיכרון לסשנים חדשים. המתג /memory עדיין יכול להפעיל אותו לסשן אחד. ברירת מחדל: false.
memory_v2.batch_dream_enabled
boolean
-
user
מריץ את Dream של memory-v2 בתור batch Dream, שמקפל הערות לנושאים באצוות עם קטלוג הנושאים המלא. ערך מקומי גובר על memory_v2.batch_dream_enabled מרוחק, ואחר כך ברירת המחדל היא false.
memory_v2.batch_dream_max_run_secs
number
-
user
מגביל ריצת batch Dream אחת בשניות, ברירת מחדל 1800, מוגבל לטווח 60 עד 3600. הערות שלא הושלמו נשארות ב-inbox. ערך מקומי גובר על memory_v2.batch_dream_max_run_secs מרוחק.
memory_v2.batch_dream_max_calls_per_batch
number
-
user
מגביל קריאות מודל לכל אצווה של batch Dream, ברירת מחדל 6, מוגבל לטווח 2 עד 16. ערך מקומי גובר על memory_v2.batch_dream_max_calls_per_batch מרוחק.
memory_v2.batch_dream_max_batch_note_bytes
number
-
user
מגביל בתי הערות באצוות batch Dream אחת, ברירת מחדל 98304, מוגבל לטווח 16384 עד 262144. ערך מקומי גובר על memory_v2.batch_dream_max_batch_note_bytes מרוחק.
memory_v2.archived_retention_days
number
-
user
שומר קבצי תצפיות memory-v2 בארכיון למשך מספר הימים הזה. ברירת מחדל: 30.
memory_v2.job_retention_days
number
-
user
שומר מטא-נתונים של משימות לכידה memory-v2 במצב סופי למשך מספר הימים הזה. ברירת מחדל: 14.
memory_v2.daily_token_cap
number
-
user
אסימוני מודל ששרת הזיכרון רשאי להוציא עבורך בחלון מתגלגל של 24 שעות. מעבר לכך, הלכידה נעצרת עד שהחלון מתפנה, בעוד הערות, עריכות ושכחות ממשיכים לעבוד. memory_v2.daily_token_cap מרוחק מוריד אותו עוד, אף פעם לא מתחת ל-1000000. ברירת מחדל: 20000000.
עקיפה לכל מודל או הגדרת BYOK. העדף env_key על פני api_key מוטמע.
model.<id>.agent_type
string
yes
user
סוג הגדרת סוכן שמשויך למודל הזה.
model.<id>.api_backend
chat_completions / responses / messages
yes
user
פרוטוקול קו למודל הזה.
model.<id>.api_base_url
string
yes
user
בסיס API חלופי בשימוש עם פתרון XAI_API_KEY.
model.<id>.api_key
string
yes
user
מפתח API מוטמע. העדף env_key. זה לא סוד לשים במאגר משותף.
model.<id>.auth_provider
string
yes
user
שם של עוזר [auth_provider.<name>] שמנפיק את אסימון ה-bearer של המודל הזה.
model.<id>.auto_compact_threshold_percent
integer
yes
user
סף דחיסה אוטומטית לכל מודל (0-100).
model.<id>.base_url
string
yes
user
כתובת בסיס של נקודת הקצה של הספק.
model.<id>.compaction_at_tokens
boolean / integer
yes
user
מגדיר את כותרת הבקשה x-compaction-at למספר האסימונים הזה. true שולח auto_compact_threshold_percent מתוך context_window. false לא שולח דבר. הדחיסה עצמה מתחילה ב-auto_compact_threshold_percent.
model.<id>.compactions_remaining
boolean / integer
yes
user
מגדיר את כותרת הבקשה x-compactions-remaining. true שולח 1 עד הסיכום הראשון של השיחה ו-0 אחריו. מספר שלם מ-0 עד 255 שולח את המספר הזה. false לא שולח דבר. כינוי send_compactions_remaining.
model.<id>.context_window
number
yes
user
אסימוני חלון הקשר. קובע את תזמון הדחיסה האוטומטית.
model.<id>.description
string
yes
user
תיאור אופציונלי שמוצג בבורר.
model.<id>.env_http_headers
map<string,string>
yes
user
כותרות HTTP שממולאות ממשתני סביבה כשהם מוגדרים.
model.<id>.env_key
string / string[]
yes
user
שם או שמות של משתני סביבה שמחזיקים את מפתח ה-API של הספק.
model.<id>.extra_headers
map<string,string>
yes
user
כותרות לכל בקשה למודל הזה.
model.<id>.hidden
boolean
yes
user
הסתרת המודל הזה מהבורר. models.default מדלג עליו, אבל -m עדיין בוחר אותו.
model.<id>.inference_idle_timeout_secs
number
yes
user
זמן קצוב לחוסר פעילות בהסקה בזרימה למודל הזה.
model.<id>.interjection_reply_nudge
boolean
yes
user
פעם אחת לכל send-now, הודעה באמצע תור, או הפרומפט הראשון אחרי שאתה עוצר תור: לעכב את ההמתנות ברקע של המודל הזה שמגיעות עם חשיבה אבל בלי טקסט תשובה, ולומר לו לענות קודם.
model.<id>.max_completion_tokens
number
yes
user
מקסימום אסימוני השלמה לכל מודל.
model.<id>.max_request_bytes
number
yes
user
תקרת גוף הבקשה של הספק שתמונות מוטמעות מפונות כדי להישאר מתחתיה. כשלא מוגדר, יורש את הערך של [model_providers.<id>], ואחר כך את ברירת המחדל של api_backend: 30 MB ל-messages, 50 MiB אחרת.
model.<id>.max_retries
number
yes
user
ניסיונות חוזרים של הסקה למודל הזה.
model.<id>.model
string
yes
user
מזהה מודל שנשלח ל-API.
model.<id>.model_family
string
yes
user
מזהה משפחה לשימוש בדחיסה ובקיבוץ יכולות.
model.<id>.model_provider
string
yes
user
מזהה ספק בשם [model_providers.<name>] למודל הזה. ההגדרה נדחית כשטבלת הספק הזו אינה מנותחת בהצלחה.
model.<id>.mtls_cert_dir
string
yes
user
ספרייה שמכילה את זהות ה-mTLS של נקודת הקצה של המודל בתור client.crt ו-client.key, או tls.crt ו-tls.key. ההגדרה נדחית אלא אם לאותו מודל יש base_url אחד ב-HTTPS ואין api_base_url, ובקשות אינן עוקבות אחרי הפניות.
model.<id>.name
string
yes
user
תווית שמוצגת בבורר המודלים.
model.<id>.notice
table (severity = info / warning / critical, text, label)
yes
user
הודעה שמוצגת מעל הפרומפט בזמן שהמודל הזה נבחר, ומתנקה למודל הזה על ידי text ריק.
model.<id>.query_params
map<string,string>
yes
user
פרמטרי שאילתה נוספים בבקשות של המודל הזה.
model.<id>.rate_limit_retry_threshold
number
yes
user
תקרת סך הניסיונות לבקשות שמוגבלות בקצב, מוגבלת על ידי max_retries שנפתר. כשמוגדר, זה משבית את לולאת ההמתנה הנפרדת של 429 לסוכן משנה.
model.<id>.reasoning_effort
string
yes
user
מאמץ לכל מודל שיצא משימוש. העדף reasoning_efforts.
model.<id>.reasoning_efforts
array of tables
yes
user
ערכי מאמץ חשיבה מותרים למודל הזה. כשמושמט, התפריט מגיע משורת /v1/models של נקודת הקצה (reasoning_efforts, או capabilities.reasoning_effort כשזה נעדר).
model.<id>.reasoning_summary
none / auto / concise / detailed
yes
user
reasoning.summary של Responses API למודל הזה. ברירת מחדל concise. none משמיט את השדה לנקודות קצה שדוחות אותו (למשל AWS Bedrock Mantle).
model.<id>.show_model_fingerprint
boolean
yes
user
הצגת טביעת האצבע של מודל הספק בממשק כשהיא קיימת.
model.<id>.stream_tool_calls
boolean
yes
user
צורת בקשת זרימה של קריאות כלים לכל מודל.
model.<id>.subagent_rate_limit_max_attempts
number
yes
user
מקסימום ניסיונות בלולאת ההמתנה של 429 לסוכן משנה כש-rate_limit_retry_threshold אינו מוגדר. ברירת מחדל 8, מקסימום 32, ו-0 משבית את לולאת ההמתנה.
model.<id>.supported_in_api
boolean
yes
user
האם רשומת הקטלוג הזו מוצעת כמודל API ציבורי.
model.<id>.supports_backend_search
boolean
yes
user
האם נקודת הקצה תומכת בכלי חיפוש בצד השרת שמתארחים ב-Grok.
model.<id>.supports_reasoning_effort
boolean
yes
user
יצא משימוש. העדף reasoning_efforts. false מפורש משאיר את המודל מחוץ לכל תפריט שהוא היה יורש אחרת מנקודת הקצה או מרשומת קטלוג של אותו מודל.
model.<id>.system_prompt_label
string
yes
user
תווית זהות של פרומפט מערכת לכל מודל.
model.<id>.temperature
number
yes
user
טמפרטורת דגימה לכל מודל.
model.<id>.top_p
number
yes
user
top_p לכל מודל.
model.<id>.use_concise
boolean
yes
user
שימוש בחבילת תיאורי הכלים התמציתית למודל הזה.
model.<id>.vision
boolean
yes
user
האם מודל נקודת הקצה המותאם הזה מקבל קלט תמונה. במסלול ה-daemon, false מונע ממנו תמונות מצורפות ותמונות כלים. כשלא מוגדר, הן נשלחות לפי מה ש-/models של השער אומר.
רשימת התרה ב-glob לבורר המודלים, לברירת המחדל ול--m. מתעלמים ממנה מחוץ ל-requirements.toml כש-auth_provider_command ונקודת קצה מותאמת של מודלים מוגדרים. ריק פירושו בלי הגבלה.
models.default
string
pin
user
מודל בשימוש לסשנים חדשים. כשאף אחד לא מוגדר, מסלול ה-daemon נפתח על המודל הראשון ברשימה מלבד מודל הנתב (Auto), אלא אם Auto הוא היחיד. אם אי אפשר לשלוף את רשימת המודלים, משתמשים ברשימה שנשמרה במטמון מהפעלה קודמת של הגרסה הזו (עד גיל 7 ימים) לפני חזרה ל-Auto. גם GROK_DEFAULT_MODEL, --model, -m.
models.default_reasoning_effort
string
yes
user
מאמץ חשיבה ברירת מחדל למודל ברירת המחדל כשהמודל תומך בזה.
models.disabled_models
string[]
yes
user
הסרת מזהי המודלים האלה מהקטלוג. גובר על hidden_models.
models.extra_headers
map<string,string>
yes
user
כותרות בקשה שחלות על כל מודל. מפתחות לכל מודל גוברים.
models.hidden_models
string[]
yes
user
הסתרת מזהי המודלים האלה מהבורר. models.default מדלג עליהם, אבל -m עדיין בוחר אותם.
models.image_description
string
yes
user
מודל ראייה לתמלול תמונות שהמשתמש מספק.
models.inference_idle_timeout_secs
number
yes
user
זמן קצוב גלובלי לחוסר פעילות בהסקה בזרימה כשמודל משאיר אותו לא מוגדר.
models.max_completion_tokens
number
yes
user
ברירת מחדל גלובלית למקסימום אסימוני השלמה כשמודל משאיר אותה לא מוגדרת.
models.max_retries
number
yes
user
ברירת מחדל גלובלית לניסיונות חוזרים של הסקה כשמודל משאיר אותה לא מוגדרת.
models.prompt_suggestion
string
yes
user
נעיצת מודל לטקסט רפאים של הפרומפט הבא. כשלא מוגדר, עובר למרוחק ואחר כך למודל הסשן.
models.rate_limit_retry_threshold
number
yes
user
תקרת סך ניסיונות גלובלית לבקשות שמוגבלות בקצב כשמודל משאיר אותה לא מוגדרת, מוגבלת על ידי max_retries שנפתר. כשמוגדר, זה משבית את לולאת ההמתנה הנפרדת של 429 לסוכן משנה.
models.session_summary
string
yes
user
מודל לכותרות ולסיכומי סשן.
models.stream_tool_calls
boolean
yes
user
צורת בקשת זרימה גלובלית של קריאות כלים. חלק מנקודות הקצה של BYOK צריכות false.
models.subagent_rate_limit_max_attempts
number
yes
user
ברירת מחדל גלובלית לניסיונות בלולאת ההמתנה של 429 לסוכן משנה כש-rate_limit_retry_threshold אינו מוגדר. ברירת מחדל 8, מקסימום 32, ו-0 משבית את לולאת ההמתנה.
models.temperature
number
yes
user
ברירת מחדל גלובלית לטמפרטורת דגימה כשמודל משאיר אותה לא מוגדרת.
models.top_p
number
yes
user
ברירת מחדל גלובלית ל-top_p כשמודל משאיר אותה לא מוגדרת.
models.web_search
string
pin
user
מודל שבשימוש כלי הלקוח web_search. גם GROK_WEB_SEARCH_MODEL.
כללי allow תמציתיים כמו Bash(git *). deny גובר על ask, ו-ask גובר על allow. קבצי פרויקט רשאים להגדיר זאת.
permission.ask
string[]
yes
user
כללי ask תמציתיים. קבצי פרויקט רשאים להגדיר זאת.
permission.deny
string[]
yes
user
כללי deny תמציתיים. קבצי פרויקט רשאים להגדיר זאת.
permission.rules
array of tables
yes
user
כללי אובייקט מפורטים של action/tool/pattern. קבצי פרויקט רשאים להגדיר זאת.
כאשר config.toml או managed_config.toml נכשלים בטעינה, תיקון campaigns מכל קובץ אחר או מהשרת שומר רק את כללי ה-deny של permission שלו על WebFetch, WebSearch ו-AgentMessage. הכללים האחרים שלו לא חלים, ו-grok inspect מציג אותם כ-skipped.
כלל AgentMessage מציין את ה-subagent שאליו הודעה הולכת. AgentMessage(<subagent id>) מתאים למזהה הזה כ-glob או כקידומת, ו-AgentMessage חשוף מתאים לכל הודעה. SendSubagentMessage(...) ו-SendAgentMessage(...) הם איותים אחרים של אותו כלל.
יצואן לוגים של OTEL חיצוני. גם OTEL_LOGS_EXPORTER.
telemetry.otel_endpoint
string
pin
user
נקודת קצה בסיס OTLP חיצונית. גם OTEL_EXPORTER_OTLP_ENDPOINT. pin מסיר משתני סביבה של מפתחים ואחים לא רשומים מקבצי user/managed, חוץ מהרשומים.
telemetry.otel_logs_endpoint
string
pin
user
נקודת קצה OTLP לאות הלוגים (כלשונה). גם OTEL_EXPORTER_OTLP_LOGS_ENDPOINT.
telemetry.otel_metrics_endpoint
string
pin
user
נקודת קצה OTLP לאות המדדים (כלשונה). גם OTEL_EXPORTER_OTLP_METRICS_ENDPOINT.
telemetry.otel_protocol
http/protobuf / grpc
pin
user
תעבורת OTLP חיצונית. גם OTEL_EXPORTER_OTLP_PROTOCOL. pin מסיר משתני סביבה של פרוטוקול לפי אות ואחים לא רשומים בקבצים, חוץ מהרשומים.
telemetry.otel_logs_protocol
http/protobuf / grpc
pin
user
פרוטוקול OTLP לאות הלוגים. גם OTEL_EXPORTER_OTLP_LOGS_PROTOCOL.
telemetry.otel_metrics_protocol
http/protobuf / grpc
pin
user
פרוטוקול OTLP לאות המדדים. גם OTEL_EXPORTER_OTLP_METRICS_PROTOCOL.
telemetry.otel_timeout
number
pin
user
פסק זמן לייצוא במילישניות. גם OTEL_EXPORTER_OTLP_TIMEOUT.
telemetry.otel_metric_export_interval
number
pin
user
מרווח ייצוא מדדים במילישניות. גם OTEL_METRIC_EXPORT_INTERVAL.
telemetry.otel_certificate
string
pin
user
נתיב PEM של אישורי CA נוספים ל-collector. גם OTEL_EXPORTER_OTLP_CERTIFICATE. pin של CA לא מסיר נקודות קצה.
telemetry.otel_logs_certificate
string
pin
user
נתיב PEM של CA לאות הלוגים. גם OTEL_EXPORTER_OTLP_LOGS_CERTIFICATE.
telemetry.otel_metrics_certificate
string
pin
user
נתיב PEM של CA לאות המדדים. גם OTEL_EXPORTER_OTLP_METRICS_CERTIFICATE.
telemetry.otel_client_certificate
string
pin
user
נתיב PEM של אישור לקוח mTLS. גם OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE. pin מסיר עותקי אישורים, נקודות קצה של מפתחים, ואחים לא רשומים בקבצים.
telemetry.otel_client_key
string
pin
user
נתיב PEM של מפתח לקוח mTLS. טוקנים אף פעם לא נמצאים בקובץ הזה. גם OTEL_EXPORTER_OTLP_CLIENT_KEY.
telemetry.otel_logs_client_certificate
string
pin
user
נתיב PEM של אישור לקוח mTLS לאות הלוגים. גם OTEL_EXPORTER_OTLP_LOGS_CLIENT_CERTIFICATE.
telemetry.otel_logs_client_key
string
pin
user
נתיב PEM של מפתח לקוח mTLS לאות הלוגים. גם OTEL_EXPORTER_OTLP_LOGS_CLIENT_KEY.
telemetry.otel_metrics_client_certificate
string
pin
user
נתיב PEM של אישור לקוח mTLS לאות המדדים. גם OTEL_EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATE.
telemetry.otel_metrics_client_key
string
pin
user
נתיב PEM של מפתח לקוח mTLS לאות המדדים. גם OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY.
telemetry.otel_metrics_include_session_id
boolean
pin
user
צירוף session.id למדדים. גם OTEL_METRICS_INCLUDE_SESSION_ID.
telemetry.otel_log_user_prompts
boolean
pin
user
שער תוכן לטקסט הפרומפט ב-grok_code.user_prompt. גם OTEL_LOG_USER_PROMPTS. הצמדה של שער תוכן כלשהו בלי לרשום אח הופכת את האח שהושמט לכבוי כברירת מחדל.
telemetry.otel_log_tool_details
boolean
pin
user
שער מטא-נתונים לתצוגה מקדימה של ארגומנטים של כלי, נתיבים, ושמות כלשונם. מומלץ דלוק לצירוף SIEM. גם OTEL_LOG_TOOL_DETAILS. לא כולל גופים מלאים.
telemetry.otel_log_assistant_responses
boolean
pin
user
שער תוכן לטקסט grok_code.assistant_response. כשלא מוגדר, עוקב אחרי otel_log_user_prompts אלא אם שער אח מוצמד ב-requirements. OTEL_LOG_USER_PROMPTS=1 רק מסביבה חייב להגדיר את זה ל-0 (או להצמיד אותו false) לזרם של פרומפטים בלבד. גם OTEL_LOG_ASSISTANT_RESPONSES.
telemetry.otel_log_tool_content
boolean
pin
user
שער גוף ל-tool_input, tool_output, full_command, ו-error_message. עצמאי מ-details; ברירת מחדל כבוי. CONTENT בלבד מאבד שמות MCP ונתיבים כלשונם. גם OTEL_LOG_TOOL_CONTENT.
telemetry.trace_upload
boolean
pin
user
העלאת עקבות סשן. pin של requirements גובר על הגדרת המשתמש.
לכידת סביבת מעטפת ההתחברות של המשתמש עבור bash. כאשר false, פקודות רצות בלי הכינויים והפונקציות מפרופיל ההתחברות, .zshrc או .bashrc, ועשויות גם לרוץ בלי PATH והייצואים שלהן. ברשימת ההיתר של overlay.
toolset.bash.max_timeout_secs
number
yes
user
תקרה על פסקי זמן בחזית שהמודל מבקש.
toolset.bash.output_byte_limit
number
yes
user
מקסימום פלט bash שנלכד, בבתים.
toolset.bash.timeout_secs
number
yes
user
פסק זמן לפקודת bash בחזית, בשניות.
toolset.file_toolset
standard / hashline
yes
user
סכמת כלי עריכת קבצים.
toolset.image_gen.base_url
string
yes
user
בנקודת קצה של מודל, נקודת הקצה של התמונות (נתיבי ה-API לתמונות של xAI) עבור image_gen ו-image_edit. כשלא מוגדר, שניהם הולכים אל endpoints.xai_api_base_url כאשר זה לא מארח של xAI. הבקשות שלהם נושאות את המפתח העצמי של טבלת מודל שמוגש, ש-base_url שלה הוא בדיוק ה-URL הזה. טבלה כשירה רק כאשר בקשת מדיה אליה צריכה רק את אותו base_url, את api_key או env_key שלה שנשלחים כ-bearer, ואת הכותרות שלקוח המדיה של Grok מוסיף. extra_headers, mtls_cert_dir, query_params או env_http_headers פוסלים אותה. מפתח מ-auth_provider לא נספר. הגדרות שטבלה יורשת מ-[models] או מ-model_provider שלה נחשבות לשלה. בלי טבלה כשירה, שניהם נשארים כבויים. ה-API של xAI אף פעם לא משמש במקומם.
toolset.image_gen.env_key
string / string[]
yes
user
משתנים שמחזיקים את ה-bearer עבור toolset.image_gen.base_url; הראשון שמוגדר מנצח. ה-daemon עולה בלי משתני אישורים כמו XAI_API_KEY, GROK_AUTH, GROK_CODE_XAI_API_KEY ומשתני המפתח של נקודת הקצה של המודל, ולכן שם כאן מתוכם לא מוצא מפתח, ו-Grok מזהיר בהפעלה.
toolset.video_gen.base_url
string
yes
user
בנקודת קצה של מודל, נקודת הקצה של הווידאו (נתיבי ה-API לווידאו של xAI) עבור כלי הווידאו. כשלא מוגדר, הם הולכים אל endpoints.xai_api_base_url כאשר זה לא מארח של xAI. הבקשות שלהם נושאות את המפתח העצמי של טבלת מודל שמוגש, ש-base_url שלה הוא בדיוק ה-URL הזה. טבלה כשירה רק כאשר בקשת מדיה אליה צריכה רק את אותו base_url, את api_key או env_key שלה שנשלחים כ-bearer, ואת הכותרות שלקוח המדיה של Grok מוסיף. extra_headers, mtls_cert_dir, query_params או env_http_headers פוסלים אותה. מפתח מ-auth_provider לא נספר. הגדרות שטבלה יורשת מ-[models] או מ-model_provider שלה נחשבות לשלה. בלי טבלה כשירה, הם נשארים כבויים. ה-API של xAI אף פעם לא משמש במקומם.
toolset.video_gen.env_key
string / string[]
yes
user
משתנים שמחזיקים את ה-bearer עבור toolset.video_gen.base_url; הראשון שמוגדר מנצח. ה-daemon עולה בלי משתני אישורים כמו XAI_API_KEY, GROK_AUTH, GROK_CODE_XAI_API_KEY ומשתני המפתח של נקודת הקצה של המודל, ולכן שם כאן מתוכם לא מוצא מפתח, ו-Grok מזהיר בהפעלה.
toolset.web_fetch.allowed_domains
string[]
yes
user
דריסת רשימת היתר דומיינים עבור web_fetch.
toolset.web_fetch.proxy_endpoint
string
yes
user
URL של פרוקסי יציאה עבור web_fetch. גם GROK_WEB_FETCH_PROXY. בנקודת קצה של מודל, web_fetch רץ רק דרך הפרוקסי הזה, עם features.web_fetch דלוק; כשלא מוגדר, הוא נשאר כבוי והפרוקסי של xAI אף פעם לא משמש במקומו.
toolset.web_search.allowed_domains
string[]
yes
user
רשימת היתר דומיינים עבור web_search בצד הלקוח. ברשימת ההיתר של overlay.
toolset.web_search.excluded_domains
string[]
yes
user
רשימת דחייה של דומיינים עבור web_search בצד הלקוח. ברשימת ההיתר של overlay.
נתיבי @ שמתחילים ב-/, ~/ או ../ מציגים קבצים מחוץ לתיקיית העבודה. ברירת המחדל true. נדרשת הפעלה מחדש.
ui.auto_dark_theme
string
yes
user
ערכת נושא כאשר theme = auto ומערכת ההפעלה כהה.
ui.auto_light_theme
string
yes
user
ערכת נושא כאשר theme = auto ומערכת ההפעלה בהירה.
ui.cancel_subagents_on_turn_cancel
ask / always_stop / always_continue
yes
user
מה לעשות עם subagents שרצים כאשר מבטלים תור הורה.
ui.combine_queued_prompts
boolean
yes
user
מיזוג המשכים פשוטים עוקבים לתור אחד.
ui.compact_mode
boolean
yes
user
ריפוד הודעות צפוף יותר. גם /compact-mode.
ui.confirm_before_rewind
boolean
yes
user
שאלה לפני החזרת היסטוריית השיחה לאחור.
ui.dashboard_preview
boolean
yes
user
התצוגה המקדימה של לוח הבקרה וחלונית התשובה מופיעות כברירת מחדל (Appearance ב-/settings).
ui.contextual_hints.image_input
boolean
yes
user
טיפ להדבקת תמונה מהלוח כאשר המודל מקבל תמונות.
ui.contextual_hints.plan_mode
boolean
yes
user
הצעת מצב תכנון (Shift+Tab) להנחיות בסגנון תכנון.
ui.contextual_hints.send_now
boolean
yes
user
אחרי הכנסה לתור של המשך באמצע תור, Enter על הנחיה ריקה שולח עכשיו.
ui.contextual_hints.small_screen
boolean
yes
user
הצעת /compact-mode במסופים קצרים.
ui.contextual_hints.ssh_wrap
boolean
yes
user
המלצה על grok wrap כאשר ל-SSH אין יעד לוח.
ui.contextual_hints.undo
boolean
yes
user
טיפ ש-Ctrl+Z משחזר טיוטת הנחיה שנמחקה.
ui.contextual_hints.word_select
boolean
yes
user
אחרי לחיצה כפולה עם בחירת fold/nav, הפניה אל Word select בהגדרות.
ui.cursor_blink
boolean
yes
user
כפיית סמן בלוק מהבהב (true) או יציב (false), שגם קובעת אם בלוק מצב Normal ופס מצב Insert בהנחיית vim מהבהבים. כשהערך לא מוגדר, הוא יורש את סמן המסוף ושומר את הצורות האלה יציבות.
ui.default_selected_permission
string
yes
user
שורת האישור שנבחרת מראש בהנחיית האישור הראשונה אחרי ש-Grok מתחיל. גם GROK_DEFAULT_SELECTED_PERMISSION.
ui.display_refresh.auto_cadence_enabled
boolean
yes
user
התאמת קצב הזרם והגלילה לקצב רענון התצוגה. גם GROK_DISPLAY_REFRESH_AUTO_CADENCE.
ui.follow_up_behavior
queue / steer
yes
user
ניתוב המשך באמצע תור.
ui.fork_secondary_model
string
yes
user
מודל לסוכן המשני בעת פיצול. ברירת המחדל היא מודל ברירת המחדל הראשי.
ui.hunk_tracker_mode
agent_only / all_dirty / off
yes
user
מעקב hunk אחר שינויי קבצים. גם GROK_HUNK_TRACKER ו---hunk-tracker-mode.
ui.invert_scroll
boolean
yes
user
היפוך כיוון הגלילה האנכית. גם GROK_INVERT_SCROLL.
ui.keep_text_selection
flash / hold / word_select
yes
user
בחירה בתוך היישום: הבהוב קצר, החזקה, או בחירת מילה בהודעות (פריטי שורה עדיין נפתחים). ברירת המחדל word_select.
ui.kitty_keyboard
auto / query
yes
user
query שואל גם מסופים ש-Grok לא מזהה, ואת Windows Terminal, אם הם תומכים בפרוטוקול המקלדת Kitty, ש-Grok מפעיל רק אם המסוף עונה כן. ברירת המחדל auto. נדרשת הפעלה מחדש. גם GROK_KITTY_KEYBOARD.
ui.max_thoughts_width
number
yes
user
רוחב עמודות לחלונית המחשבות (40-500).
ui.mouse_reporting_toggle
boolean
yes
user
Ctrl+R ב-scrollback מחליף את מצב לכידת העכבר של המסוף. גם GROK_MOUSE_REPORTING_TOGGLE.
ui.multiline_default
boolean
yes
user
התחלת סשנים ולוח הבקרה בקלט רב-שורות, שבו Enter מוסיף שורה חדשה ו-Shift+Enter או Alt+Enter שולחים (Editor ב-/settings).
ui.page_flip_on_send
boolean
yes
user
הצמדת ההנחיה שנשלחה לראש אזור התצוגה.
ui.permission_mode
default / ask / auto / always-approve
yes
user
התנהגות ברירת המחדל של הרשאות כלים. נעילות ארגוניות משתמשות ב-requirements.toml.
ui.prompt_suggestions
boolean
yes
user
טקסט רפאים להנחיה הבאה אחרי כל תור. גם GROK_PROMPT_SUGGESTIONS. מתג כיבוי מרוחק יכול להשבית את זה לכל הצי.
prompt_suggestions.max_output_tokens
number
yes
user
אסימוני פלט גלוי לקריאת ההצעה. מוגבל ל-16-256, ברירת המחדל 64, עם רזרבה נפרדת לחשיבה. ניתן לדריסה מרחוק.
prompt_suggestions.temperature
number
yes
user
טמפרטורת דגימה לקריאת ההצעה (ברירת מחדל 0.2). ניתן לדריסה מרחוק.
prompt_suggestions.reasoning_effort
none / minimal / low / medium / high
yes
user
מאמץ חשיבה לקריאת ההצעה. ברירת המחדל ו-none מכבים חשיבה, וערכים אחרים משתמשים במאמץ מודל נתמך. ניתן לדריסה מרחוק.
ui.remember_tool_approvals
boolean
yes
user
הצגת אפשרויות Always allow לכל כלי. גם GROK_REMEMBER_TOOL_APPROVALS.
ui.render_mermaid
auto / on / off
yes
user
איך גדרות mermaid מוצגות: שורת פתיחה לחיצה או מקור גולמי.
ui.screen_mode
fullscreen / minimal
yes
user
מצב רינדור ברירת המחדל ל-grok רגיל. נדרשת הפעלה מחדש.
ui.scroll_lines
integer
yes
user
שורות לכל תנועת גלילה (1-10). גם GROK_SCROLL_LINES.
ui.scroll_mode
auto / wheel / trackpad
yes
user
סיווג קלט גלילה. גם GROK_SCROLL_MODE.
ui.scroll_speed
integer
yes
user
מכפיל מהירות גלילה של עכבר או משטח מגע (1-100). גם GROK_SCROLL_SPEED.
ui.show_thinking_blocks
boolean
pin
user
הצגת בלוקי חשיבה בזמן הזרמה. ברירת המחדל true. גם GROK_SHOW_THINKING_BLOCKS. ברירת מחדל מרוחקת חלה רק כאשר שום דבר לא מגדיר את זה מקומית.
ui.show_timeline
boolean
pin
user
פס סימונים לכל תור במקום פס הגלילה. ברירת המחדל false. גם GROK_SHOW_TIMELINE. ברירת מחדל מרוחקת חלה בהפעלה הבאה, ורק כאשר שום דבר לא מגדיר את זה מקומית.
ui.show_timestamps
boolean
pin
user
מראה ישן של הפעלה וכיבוי של ui.timestamps, שכל כתיבה שומרת מסונכרן. ראו את הערת timestamps מתחת לטבלה זו.
ui.simple_mode
boolean
,
user
יצא משימוש ואין לו השפעה. Grok מתעלם ממנו וכבר לא כותב אותו. grok doctor מסמן אותו ב-config.toml שלכם.
ui.single_ctrl_c_quit
boolean
yes
user
Ctrl+C אחד יוצא כאשר הפעולה לא תאבד טיוטה או עבודה שלא הסתיימה (Editor ב-/settings). ברירת המחדל false מבקשת לחיצה שנייה.
ui.status_line.command
string
yes
user
סקריפט לשורת סטטוס מסוג command. קמפיינים מסירים את הנתיב הזה. שכבת requirements עדיין ממזגת אותו.
ui.status_line.type
builtin / command / disabled
yes
user
שורת סטטוס אופציונלית מעל סרגל הקיצורים. כבויה כברירת מחדל. ראו את מדריך המשתמש של שורת הסטטוס.
ui.theme
string
yes
user
שם ערכת צבעים, או auto/system כדי לעקוב אחרי מערכת ההפעלה. גם /theme ו-GROK_THEME.
ui.timestamps
off / minimal / on
pin
user
אילו שורות מציגות את שעת השעון: אף אחת, רק ההנחיות שלכם ושורת Worked for … של כל תור, או כל הודעה. ברירת המחדל on. גם /timestamps ו-GROK_TIMESTAMPS (מצב או ערך בוליאני). ברירת מחדל מרוחקת חלה בהפעלה הבאה, ורק כאשר שום דבר לא מגדיר את זה מקומית.
כמה מכל קריאת כלי התמליל מציג, מהפרשי עריכה ופלט shell ועד שורות סיכום מקופלות. ברירת המחדל compact-all-grouped. המפתחות שיצאו משימוש group_tool_verbs, collapsed_edit_blocks ו-expanded_by_default ב-pager.toml עדיין בוחרים רמת התחלה. ראו את הערת המיגרציה מתחת לטבלה זו. ui_defaults.tool_call_density מרוחק (אותם ערכים) חל בהפעלה הבאה, ורק כאשר שום דבר לא מגדיר את זה מקומית. גם /density ו-GROK_TOOL_CALL_DENSITY.
ui.ui_theme
string
yes
user
כינוי ישן ל-ui.theme.
ui.vim_mode
boolean
pin
user
הוצא משימוש. השתמשו ב-keys.vim. false נקרא כ-off ו-true כ-nav, אלא אם אותו קובץ מגדיר keys.vim תקין (ערך לא מזוהה נחשב כלא מוגדר). grok doctor מסמן אותו ב-config.toml שלכם.
ui.voice_capture_mode
hold / toggle
yes
user
החזקה לדיבור, או לחיצה להחלפת מצב לכידת הקול.
ui.voice_keybind_enabled
boolean
yes
user
הפעלת Ctrl+Space / F8 להכתבת קול. /voice עדיין עובד כאשר הערך false.
ui.voice_stt_language
string
yes
user
קוד שפה של דיבור לטקסט, או auto. דורס את [voice].language לסשן.
ui.yolo
boolean
pin
user
אישור תמיד של קריאות כלים. Requirements יכולים לנעוץ false ולחסום את --yolo.
איך ui.timestamps ו-ui.show_timestamps הישן משתלבים:
קובץ שמגדיר רק את show_timestamps נחשב כמגדיר את timestamps ל-on או off, ולכן הוא דורס קבצים נמוכים יותר.
כאשר קובץ אחד מגדיר את שניהם והם סותרים (false עם minimal או on, true עם off), טבלת [ui] ברמה העליונה של config.toml שלכם נפתרת אל show_timestamps. כל קובץ אחר, וכל תיקון [[version_overrides]], [[experiments]] או [[campaigns]], נפתר אל timestamps.
כאשר אתם עורכים את config.toml ידנית, שנו את שני המפתחות או מחקו את show_timestamps.
איך ui.group_tool_verbs ו-ui.collapsed_edit_blocks שיצאו משימוש, ו-scrollback.blocks.edit.expanded_by_default ב-pager.toml, בוחרים ui.tool_call_density התחלתי (מנהלים שנועצים או מנהלים אחד ממפתחות [ui] צריכים להגדיר את ui.tool_call_density במקומם):
collapsed_edit_blocks = true או expanded_by_default = false מתחיל ב-compact-ungrouped. אחרת, collapsed_edit_blocks = false, expanded_by_default = true או group_tool_verbs = false מתחיל ב-compact-shells. group_tool_verbs = true לא ממופה לשום רמה, ונרשם פעם אחת.
אי אפשר לכבות קיבוץ: קריאות וחיפושים מתקפלים בכל רמה, ולכן group_tool_verbs = false מקבל את הרמה שמקבצת הכי מעט.
הדרגות מדורגות מהגבוהה קודם: נעיצה של requirements או MDM, הסביבה (GROK_TOOL_CALL_DENSITY, ואז GROK_COLLAPSED_EDIT_BLOCKS ו-GROK_GROUP_TOOL_VERBS), config.toml שלכם עם pager.toml, ואז קובץ מנוהל או קמפיין. כל מפתח שיצא משימוש לוקח את ערכו מהדרגה הגבוהה ביותר שמגדירה אותו, כך שמפתחות בדרגות שונות משתלבים כמו קודם. tool_call_density של דרגה דורס את המפתחות שיצאו משימוש של אותה דרגה ושל כל דרגה מתחתיה. מפתחות שיצאו משימוש ומוגדרים מעליה גוברים עליה, וממופים בלי המפתחות שמתחת. לכן מפתח שננעץ ויצא משימוש גובר על tool_call_density של המשתמש עצמו.
ערכים מרוחקים של המפתחות שיצאו משימוש מתעלמים מהם.
איך קמפיינים וקבצים שבורים משפיעים על ui.timestamps, ui.show_timeline, ui.show_thinking_blocks ו-ui.tool_call_density:
תיקון [[campaigns]] מדורג מתחת ל-config.toml שלכם ומעל managed_config.toml, כך שמפתח שהגדרתם בעצמכם שומר את הערך שלכם, ושאר התיקונים של הקמפיין עדיין חלים.
אם לא ניתן לנתח קובץ תצורה, הקבצים שעדיין מנותחים ממשיכים לחול, וקמפיינים וברירות מחדל מרוחקות מדולגים עד שזה מתוקן.
הפעלת workflows. ברירת המחדל true. גם GROK_WORKFLOWS. כאשר זה כבוי מרחוק, לא המפתח הזה ולא המשתנה מפעילים אותו בחזרה.
workflows.runtime
node / deno
pin
user
רק נתיב הדמון: סביבת הריצה שעליה רצים סקריפטי workflow ותאי Execute. node מריץ אותם על Node בארגז החול של הסקריפטים של Grok, או על Deno המצורף של Grok כאשר ארגז החול לא יכול להריץ אותם. deno מריץ אותם על Deno המצורף. סביבת ריצה שהבנייה הזו לא מכירה נקראת כלא מוגדרת, ו-config.toml מזהיר על אחת כזו. ברירת המחדל deno. גם GROK_WORKFLOWS_RUNTIME, והגדרה מרוחקת. נקרא בהפעלה.
managed_config.toml מקבל כל מפתח בטבלאות למעלה. הוא קובע ברירות מחדל לצי, כך ש-config.toml של המפתח דורס אותו. השתמשו בו לערכים שאתם רוצים שאנשים יוכלו לשנות, וב-requirements.toml לערכים שהם לא יכולים לשנות.
חריג אחד לכלל הזה:
מפתח
התנהגות
features.remote_fetch
הערך המנוהל גובר על זה של המפתח.
Grok Build קורא קודם את /etc/grok/managed_config.toml, ואז את $GROK_HOME/managed_config.toml, שהקונסולה שומרת מסונכרן. ערכים בשני מחליפים ערכים בראשון.
עמודת מנוהל בטבלאות למעלה היא התשובה לכל מפתח: fleet אומר שערך הצי נשאר, user אומר שקובץ המשתמש מנצח, , אומר שהקובץ הזה מתעלמים ממנו.
דוגמה לברירת מחדל של צי לערוץ מותאם (config.toml של מפתח עדיין מנצח במפתח הזה):
requirements.toml הוא קובץ שנאכף על ידי מנהל. המיקומים: $GROK_HOME/requirements.toml (מטמון חתום), ואז /etc/grok/requirements.toml, ואז MDM של macOS ai.x.grok. עמודת דרישות בטבלאות config.toml מפרטת כל מפתח config.toml שהקובץ הזה מקבל (pin או yes). מפתחות שהושמטו נשארים בלי אילוץ.
המפתחות האלה קיימים רק ב-requirements.toml:
מפתח
סוג / ערכים
ברירת מחדל
פרטים
fail_closed
boolean
false
סירוב להתחיל כאשר לא ניתן להחיל requirements חתומים או version_overrides. ברירת המחדל false. Grok Build תמיד מסרב להתחיל כאשר לא ניתן לקרוא או לנתח את requirements.toml.
features.image_edit
boolean
,
נעיצת זמינות image_edit. רק ב-Requirements. רשומה בקובץ משתמש לא מזוהה, וערך לא מוגדר משאיר את ברירת המחדל שהוגדרה מרחוק.
features.writeback
boolean
,
נעיצת writeback של סשן, שמסנכרן את היסטוריית הסשן אל code.grok.com. false שומר את הסשנים מקומיים, יהיו מה שיהיו --storage-mode, GROK_STORAGE_MODE או ההגדרות המרוחקות. true עדיין דורש אימות ב-grok.com. רק ב-Requirements.
ui.disable_bypass_permissions_mode
boolean
,
נעילה שמשאירה את always-approve כבוי. הנעילה נאכפת רק משכבת requirements. ערך true בקבצי משתמש או בקבצים מנוהלים מתעלמים ממנו.
נעיצות מדיניות כמו allow_managed_hooks_only (ראו Hooks) ורשימות MCP ו-marketplace (ראו Plugins) מתקבלות ב-requirements.toml וב-managed_config.toml כאחד, ורק מהדקות.
טבלאות [[hooks.<Event>]] מתקבלות בכל קובץ תצורה. Hooks ממטמון ה-requirements החתום ומקבצי /etc/grok שבבעלות root נאכפים. ראו Hooks.
המפתחות האלה נקראים רק מ-requirements.toml ומ-managed_config.toml. ערך ב-config.toml לא משנה כלום, ו-grok inspect מזהיר על כך.
מפתח
סוג / ערכים
ברירת מחדל
פרטים
allow_hosted_models
boolean
true
false משאיר את נתיב הדמון בלי היסק מתארח, כך שהשקה שאף נקודת קצה של מודל לא משרתת נדחית. false בכל אחד מהקבצים האלה מנצח. קובץ שנותן שם לנקודת קצה של מודל מכבה את זה, אלא אם true מוגדר בדרגת הקובץ הזה או מעליה: MDM של macOS ai.x.grok, ואז /etc/grok/requirements.toml, ואז ~/.grok/requirements.toml חתום, ואז /etc/grok/managed_config.toml, ואז ~/.grok/managed_config.toml ו-~/.grok/requirements.toml לא חתום. כתובות URL של מודלים ב-[endpoints] נספרות רק מחוץ למארחים של xAI. בזמן שהיסק מתארח כבוי, התחברות [auth] עדיין יכולה לשרת ב-cli_chat_proxy_base_url מחוץ למארחים של xAI, שאחד מהקבצים האלה מגדיר. רשומת מודל, רשומת ספק או URL שהטוען מדלג עליהם כי הם לא מנותחים, או URL של מודל ב-[endpoints] או cli_chat_proxy_base_url שלא מנותח, נחשבים כנתינת שם לאחד.