OpenClaw QQ: רפרנס לתצורה

[AIYA.DE5.NET]

מקור: הקובץ docs/config-reference.md במאגר constansino/openclaw_qq
מקור: openclaw_qq/docs/config-reference.md at main · constansino/openclaw_qq · GitHub
גרסה זו סונכרנה לפורום, כדי להקל על חיפוש, דיון ותחזוקה מתמשכת.

אסמכתת תצורה (גרסה מקובצת)

מטרה: קודם להבין “מה חייבים להגדיר”, ואז לראות “מה להפעיל לפי הצורך”.

A. פריטים חיוניים

• wsUrl：כתובת OneBot WebSocket.
• accessToken：טוקן גישה של OneBot (אם מופעל אימות).

B. טריגרים בסיסיים ובקרת גישה

• requireMention：סף הפעלה בצ’אט קבוצתי (@ / reply / מילת מפתח).
• keywordOnlyTrigger：האם בצ’אט קבוצתי לקבל טריגר רק ממילות מפתח (ולהתעלם מ-@ / reply).
• admins：רשימת QQ של מנהלים.
• adminOnlyChat：רק מנהלים יכולים להפעיל צ’אט.
• allowedGroups：רשימה לבנה של קבוצות.
• blockedUsers：רשימה שחורה של משתמשים.

C. יציבות וסבילות לתקלות

• maxRetries：מספר ניסיונות חוזרים אוטומטיים לאחר כשל (ברירת מחדל 0, כבוי).
• retryDelayMs：מרווח בין ניסיונות (בתוקף רק כאשר maxRetries > 0).
• fastFailErrors：בהתאמה—מעבר מהיר למודל/דילוג על המתנה (ברירת מחדל מערך ריק, כבוי).
• enableEmptyReplyFallback：גיבוי לתשובה ריקה.
• emptyReplyFallbackText：טקסט הגיבוי לתשובה ריקה.

D. מקביליות וקטיעה

• queueDebounceMs：חלון debounce למיזוג הודעות באותו סשן (ברירת מחדל 0, כבוי).
• interruptOnNewMessage：האם הודעה חדשה קוטעת תשובה קודמת (ברירת מחדל כבוי).

E. העשרת הקשר (Context)

• historyLimit：מספר הודעות היסטוריה מהקבוצה להזרקה (מומלץ ברירת מחדל 0).
• enrichReplyForwardContext：האם לנתח באופן רקורסיבי reply/forward.
• maxReplyLayers / maxForwardLayers：מגבלת עומק רקורסיה.
• maxTotalContextChars：מגבלת תקציב תווים להזרקה.

F. פלט ובקרת סיכונים

• maxMessageLength：אורך מרבי להודעה בודדת.
• rateLimitMs：מרווח בין שליחת מקטעים מרובים.
• formatMarkdown：המרת Markdown לטקסט רגיל.
• antiRiskMode：מצב עקיפת בקרת סיכונים.
• showReplySessionSource：צירוף תג מקור סשן לתשובה (שימושי מאוד בתרחישי סשן זמני).
• forwardLongReplyThreshold：סף לאיחוד והעברה (forward) אוטומטיים של תשובות ארוכות.

G. מולטימדיה וערוצים

• enableTTS：מתג תשובה קולית.
• enableGuilds：תמיכה בהודעות QQ 频道.
• sharedMediaHostDir / sharedMediaContainerDir：נתיבי שיתוף מדיה (נפוץ בפריסה בקונטיינר).

תצורת ייצור מינימלית מומלצת

{
  "channels": {
    "qq": {
      "wsUrl": "ws://127.0.0.1:3001",
      "accessToken": "your_token",
      "requireMention": true,
      "admins": "10000001",
      "adminOnlyChat": true,
      "allowedGroups": "20000001",
      "rateLimitMs": 1000,
      "maxRetries": 0,
      "retryDelayMs": 3000,
      "fastFailErrors": [],
      "queueDebounceMs": 0,
      "injectGatewayMeta": false,
      "interruptOnNewMessage": false
    }
  }
}

קריאה נוספת

• פרמטרים מלאים ודוגמאות: ראו את פרק התצורה ב-/t/topic/124 שבשורש המאגר.
• פרטי פריסה: ראו את NapCat 部署说明。