Агар шумо аллакай OpenClaw-ро дар сервери абрӣ насб карда бошед, раванди умумӣ барои ҳамгироӣ бо QQ дар асл хеле содда аст: аввал ба Платформаи кушодаи QQ гузаред, то боти QQ эҷод кунед ва дастрас кунед AppID 和 AppSecretСипас ба панели идоракунии OpenClaw дар Tencent Cloud баргардед, то танзимоти модел ва каналҳоро анҷом диҳед ва дар ниҳоят дар QQ санҷед, ки оё бот дуруст посух медиҳад. Ин усули ҳамгироӣ дар Tencent Cloud бо истифода аз интерфейси визуалӣ кор мекунад, бинобар ин зарурати иҷрои ягон фармонҳои ибтидоии иловагӣ вуҷуд надорад.
1. Пеш аз оғоз, боварӣ ҳосил кунед, ки шумо ин ашёҳои зеринро омода доред
Пеш аз идома додан, лутфан боварӣ ҳосил кунед, ки шумо ба талаботи зерин ҷавобгӯ ҳастед:
- Ман як ҳисоби QQ дорам, ки тафтишоти номи воқеиро гузаштааст.
- OpenClaw аллакай дар сервери сабуки барномавии Lighthouse насб шудааст.
- Агар инстанси OpenClaw-и шумо бо версияи кӯҳна эҷод шуда бошад, тавсия дода мешавад, ки пеш аз идома додани танзим онро ба версияи нави барнома навсозӣ кунед.
- Агар шумо ният доред, ки канали QQ-ро дар дарозмуддат истифода баред, бояд ба серверҳои дохилӣ ва хидматрасониҳои моделӣ, ки ба онҳо боэътимод дастрасӣ кардан мумкин аст, афзалият диҳед.
2. Дар Платформаи Озоди QQ сабти ном кунед ва ворид шавед

Аввал ворид шав Платформаи кушодаи QQ, QR-кодро бо барномаи QQ мобилӣ скан кунед, то ворид шавед. Агар шумо қаблан сабти ном нашуда бошед, пас аз скан кардани код ва додани иҷозат, платформа ба таври худкор раванди сабти номро барои шумо анҷом дода, ҳисоби QQ-и ҷории шуморо ба Платформаи Озод пайваст мекунад. Пас аз ин шумо ба саҳифаи идоракунии QQ Bot мегузаред.

3. Боти QQ-и худро эҷод кунед

Вақте ки шумо ба саҳифаи QQ Bot дастрасӣ пайдо кардед, тугмаи “Create Bot”-ро пахш кунед ва дастурҳои дар экран нишондодашударо барои танзим кардани боти нав риоя кунед. Пас аз анҷом ёфтани эҷод, система ду параметри муҳимро тавлид мекунад:
AppIDAppSecret

Боварӣ ҳосил кунед, ки ин ду арзишро фавран нусхабардорӣ ва захира кунед, зеро баъдтар ҳангоми танзим кардани OpenClaw ба онҳо ниёз хоҳед дошт. Лутфан ба ин махсусан диққат диҳед:AppSecret Барои сабабҳои амниятӣ, ин маълумот одатан муддати дароз дар матни оддӣ намоиш дода намешавад; мумкин аст ҳангоми боздид дубора лозим ояд онро аз нав танзим кунед, бинобар ин ҳангоми аввалин намоиш ҳатман онро қайд кунед.

Вақте эҷод ба анҷом расид, одатан шумо бояд ботро дар рӯйхати паёмҳои барномаи QQ бинед. Аммо дар ин марҳила он одатан дуруст кор намекунад, зеро он танҳо “эҷод” шудааст ва ҳанӯз ба инстанси OpenClaw-и шумо дуруст пайваст нашудааст. Тавре дар матни аслӣ зикр шудааст, агар танзимоти абрӣ анҷом наёфта бошад, ҳангоми кӯшиши гуфтугӯ бо он мумкин аст паёме мисли “Инбот ба Марс рафтааст; лутфан дертар дубора кӯшиш кунед” бинед.

4. Ба саҳифаи идоракунии OpenClaw гузаред
Сипас ба консоли Tencent Cloud баргардед, инстанси Lighthouse-ро, ки дар он шумо OpenClaw-ро ҷойгир карда будед, пайдо кунед, ба тафсилоти инстанс гузаред ва сипас ба саҳифаи “Идоракунии барнома” гузаред. Танзимоти минбаъдаи модел ва танзимоти канали QQ ҳама дар ҳамин ҷо анҷом дода мешаванд.

5. Аввал, моделро танзим кунед

QQ танҳо дарвозаи паёмҳои воридотӣ ва содиротӣ мебошад; моделие, ки шумо барои OpenClaw танзим кардаед, воқеан мазмунро мефаҳмад ва ба он посух медиҳад. Аз ин рӯ, пеш аз пайваст шудан ба QQ, лутфан боварӣ ҳосил кунед, ки калиди API-и модел дуруст ворид шудааст ва худи модел дуруст даъват мешавад.

Ин хеле муҳим аст, зеро бисёриҳо гумон мекунанд, ки мушкили “QQ ҷавоб намедиҳад” аз нодуруст танзим шудани канал аст; дар асл яке аз маъмултарин сабабҳо дар он аст, ки модел дуруст насб нашудааст, калид нодуруст ворид шудааст ё худи хидмати модел дастрас нест. Матни аслӣ низ махсусан таъкид мекунад, ки танзими модел қадами муҳим аст.Намоиши моделҳо | Моделҳои маъмул | Саҳифаи сабти ном。
6. Канали QQ-ро танзим кунед
Вақте ки шумо тасдиқ кардед, ки модел дуруст аст, ба танзим кардани каналҳо гузаред.
Дар саҳифаи “Идоракунии барномаҳо”, пайдо кунед Channel Дар бахши танзимот канали нави QQ илова кунед, сипас каналиеро, ки шумо ҳамагӣ захира карда будед, часпонед. AppID 和 AppSecret Маълумотро ворид кунед, захира кунед ва танзимотро татбиқ кунед. Вақте ки система тағйиротҳоро коркард карда, дар саҳифа паёми «Муваффақона захира шуд» намоиш дода мешавад, ин нишон медиҳад, ки канали QQ муваффақона ба OpenClaw ҳамгиро шудааст.

Агар дар ин марҳила параметрҳоро нодуруст ворид кунед, натиҷаи маъмултарин ин аст, ки ҳангоми баргаштан ба QQ бот ҳанӯз ҳам наметавонад дуруст посух диҳад ё паёми хаторо нишон медиҳад. Аз ин рӯ, агар раванд ноком шавад, аввалин чизе, ки бояд санҷед, ин аст, ки оё ин ду арзиш нодуруст нусхабардорӣ шудаанд, оё ягон майдон холӣ мондааст ё оё шумо Сикрети кӯҳнаро ворид кардаед.
7. Ба QQ баргардед, то бубинед, ки оё пайвастшавӣ бо муваффақият барқарор шудааст.
Вақте ки шумо танзими модел ва танзими канали QQ-ро анҷом додед, метавонед ба барномаи QQ дар телефони мобилии худ ё ба версияи мизи кории QQ баргардед ва ба бот паём фиристед, то онро санҷед. Агар он мисли ёвари зеҳни сунъӣ дуруст фаҳмад ва посух диҳад, ин маънои онро дорад, ки тамоми пайвастшавӣ бомуваффақият барқарор шудааст.

Як ҷузъиётро бояд дар назар дошт: мо тавсия намедиҳем, ки ин боти QQ-ро бевосита барои муошират ба чат-гурӯҳ илова кунед; ҳадди ақал дар шароити ҳозира бехатартар аст, ки аввал онро дар чат-и хусусӣ санҷида, сипас истифода баред.
8. Пас аз он ки шумо бо муваффақият пайваст шудед, чӣ кор карда метавонед?
Вақте ки бот ба QQ пайваст мешавад, он метавонад на танҳо матни оддиро ирсол ва қабул кунад. Имкониятҳое, ки дар матни аслӣ зикр шудаанд, инҳоро низ дар бар мегиранд:
- Матни паёмро қабул кунед
- Тасвирро бор кунед
- Ҳуҷҷатҳоро қабул кунед
- Ба паём ҷавоб диҳед
- Бо тасвир ҷавоб диҳед
- Дар формати Markdown ҷавоб диҳед
- Паём фиристед
- Паёми овозӣ
- Ҷавоб додан ба ҳуҷҷат
Аммо “истинодҳои паёмҳои таърихӣ” ҳоло дастгирӣ намешаванд.
Яке дигар нуқтаи муҳим, ки бояд дар хотир дошт, ин аст, ки QQ танҳо як канал аст; оё он воқеан метавонад тасвирҳоро шиносад, тасвирҳо эҷод кунад ё файлҳоро коркард кунад, ҳамоно ба қобилиятҳои модели заминавӣ вобаста аст.

Масалан, агар шумо хоҳед, ки робот тасвирҳоро шиносад, бояд OpenClaw-ро бо модели дастгиркунандаи дарки визуалӣ танзим кунед; агар хоҳед, ки он тасвирҳо эҷод кунад, бояд онро ба модели дастгиркунандаи эҷоди тасвирҳо пайваст кунед.

9. Ду намуди маъмултарин мушкилот
9.1. Чатбот хатогӣ гузориш медиҳад ва наметавонад гуфтугӯро идома диҳад
Агар бот бо чизе монанди “Ман ба Марс рафтаам, лутфан дертар дубора кӯшиш кунед” посух диҳад, аввал ин ду чизро тафтиш кунед:
- Оё боти QQ умуман дар OpenClaw ворид нашудааст?
AppID和AppSecret - Оё шумо нодурустро ворид кардед?
AppID或AppSecret
9.2. Ба назар мерасад, ки пайвастшавӣ барқарор шудааст, аммо бот оддӣ ҷавоб намедиҳад.
Ин мушкилот одатан аз худи Канали QQ нест, балки аз хато дар танзимоти модел сар мезанад. Масалан, калиди API нодуруст танзимшуда, модели дастрас набуда ё даъвати нокомшудаи модел метавонанд боиси он шаванд, ки бот паёмҳоро қабул кунад, аммо натавонад посух диҳад. Барои ҳалли ин масъала ба саҳифаи танзимоти модел дар OpenClaw баргардед ва ҳолати пайвастшавии моделро бозбинӣ кунед.
10. Хулоса
Пайваст кардани OpenClaw ба QQ танҳо чор қадамро дар бар мегирад:
- OpenClaw-ро насб кунед
- Дар Платформаи Озоди QQ бот эҷод кунед
- Бехатар нигоҳ доред
AppID和AppSecret - Модел ва канали QQ-ро дар панели идоракунии абрӣ танзим кунед.
Ҳангоме ки шумо ин чор қадамро дуруст иҷро кунед, ҳеҷ мушкиле нахоҳад буд, ки боти QQ-и худро ба интерфейси чатии OpenClaw табдил диҳед. Новобаста аз он ки шумо онро ҳамчун ёвари шахсӣ, барномаи коркарди ҳуҷҷатҳо, хидмати савол ва ҷавоб ё системаи хотиррасон рушд диҳед, ҳамаи рушдҳои минбаъда бар ин асос бунёд хоҳанд шуд.
