OpenClaw QQ: התחלה מהירה ב-3 דקות

[AIYA.DE5.NET]

מקור: המאגר constansino/openclaw_qq בקובץ docs/quickstart.md
מקור מקורי：openclaw_qq/docs/quickstart.md at main · constansino/openclaw_qq · GitHub
גרסה זו סונכרנה לפורום, לצורך חיפוש, דיון ותחזוקה שוטפת.

התחלה מהירה ב-3 דקות

1. תנאים מקדימים

• OpenClaw מותקן ורץ.
• שרת OneBot v11 רץ (מומלץ NapCat או Lagrange).
• בהגדרות OneBot הערך message_post_format חייב להיות array.

2. התקנת התוסף

cd openclaw/extensions
git clone https://github.com/constansino/openclaw_qq.git qq
cd ../..
pnpm install && pnpm build

אם התקנת את OpenClaw באופן גלובלי (npm install -g openclaw) ורק עדכנת את תיקיית ההרחבות, לרוב מספיק להריץ npm install בתוך ~/.openclaw/extensions/qq, ואז openclaw gateway restart.

3. העדיפו הגדרה דרך WebUI (מומלץ)

הגדירו ישירות את channels.qq ב-OpenClaw WebUI — בדרך כלל זה מהיר ויציב יותר מכתיבת JSON ידנית.

מומלץ למלא קודם:

• wsUrl
• accessToken
• requireMention
• admins（אופציונלי）
• allowedGroups（אופציונלי）

4. הגדרת JSON ידנית（אופציונלי）

ערכו את ~/.openclaw/openclaw.json：

{
  "channels": {
    "qq": {
      "wsUrl": "ws://127.0.0.1:3001",
      "accessToken": "your_token",
      "requireMention": true
    }
  },
  "plugins": {
    "entries": {
      "qq": { "enabled": true }
    }
  }
}

5. אימות הפעלה

openclaw gateway restart

פריטי אימות:

• שלחו הודעה פרטית לבוט — האם הוא מגיב כרגיל.
• בצ’אט קבוצתי בצעו @ לבוט — האם הוא מגיב כרגיל.
• אין בלוגים שגיאות רציפות של התחברות מחדש/אימות.

6. השלב הבא

• צריך בקרת מנהלים/רשימה שחורה-לבנה: ראו מדריך הגדרות。
• צריך פריסה בקונטיינר: ראו הוראות פריסה של NapCat。