更新時(shí)間:2026-03-11
適配版本:預(yù)裝 centos-stream9 OpenClaw及以上版本的新網(wǎng)云主機(jī)應(yīng)用鏡像
正式配置前需完成以下兩項(xiàng)準(zhǔn)備,缺一不可:
1. 擁有完成實(shí)名認(rèn)證的騰訊 QQ 賬號;
2. 已購買新網(wǎng)云主機(jī),且主機(jī)預(yù)裝 OpenClaw 鏡像。
1. 前往 QQ 開放平臺,不可直接用 QQ 賬號登錄,需點(diǎn)擊「注冊」,輸入郵箱創(chuàng)建賬號(一個(gè)郵箱僅能注冊一個(gè),建議用公共 / 企業(yè)郵箱),設(shè)置 8 位及以上、含數(shù)字 + 字母(區(qū)分大小寫)的登錄密碼;
2. 首次注冊后,按指引設(shè)置超級管理員:填寫姓名、身份證號、手機(jī)號并完成驗(yàn)證碼驗(yàn)證,輸入超級管理員 QQ 號,用該手機(jī)號綁定的手機(jī) QQ 掃碼驗(yàn)證,驗(yàn)證后該 QQ 號為賬號最高權(quán)限管理員;
3. 選擇主體類型(本文以「個(gè)人」為例),填寫主體信息并完成人臉認(rèn)證:使用超級管理員姓名綁定的手機(jī) QQ 掃碼人臉識別,審核通過后完成 QQ 開放平臺入駐。
1. 登錄 QQ 開放平臺,進(jìn)入機(jī)器人板塊,點(diǎn)擊「創(chuàng)建機(jī)器人」(單賬號可創(chuàng)建多個(gè));
2. 按要求填寫機(jī)器人信息,填寫完成后點(diǎn)擊「確認(rèn)」,進(jìn)入機(jī)器人管理頁面:
● 名稱:4-30 個(gè)字符(1 個(gè)中文字 = 2 個(gè)字符),需先檢測名稱可用性;
● 頭像:上傳 png/bmp/jpeg/jpg 格式圖片,無政治敏感、色情內(nèi)容;
● 描述:限 120 個(gè)字。
1. 在 QQ 機(jī)器人管理頁面的「開發(fā)管理」板塊,找到AppID(機(jī)器人 ID)和AppSecret(機(jī)器人密鑰);
2. 分別點(diǎn)擊復(fù)制,將兩個(gè)參數(shù)保存至記事本 / 備忘錄(注意數(shù)據(jù)安全,勿泄露);
3. 重要提示:AppSecret 不支持明文保存,首次查看后若遺忘,需重新生成;本教程創(chuàng)建的 QQ 機(jī)器人無需發(fā)布上架。
1. 登錄新網(wǎng)云主機(jī)產(chǎn)品控制臺,復(fù)制部署 OpenClaw 的云主機(jī)公網(wǎng) IP 地址(注意保護(hù),勿對外暴露);
2. 返回 QQ 機(jī)器人開發(fā)管理頁面,在「IP 白名單」輸入框中添加該公網(wǎng) IP,點(diǎn)擊「保存」;
3. 關(guān)鍵提示:提審及上線前 IP 白名單不可為空;若與機(jī)器人對話提示「該機(jī)器人去火星了,稍后再試吧」,優(yōu)先排查 IP 白名單配置是否正確。
1. 2026 年 1 月 31 日后 QQ 開放平臺暫不支持 QQ 群配置,僅支持單獨(dú)聊天配置,在 QQ 機(jī)器人開發(fā)管理的「沙箱配置」板塊,選擇「在消息列表配置(單獨(dú)聊天場景)」;
2. 點(diǎn)擊「添加成員」,設(shè)置成員角色(管理員 / 普通成員),添加后使用該成員的 QQ 掃碼確認(rèn)添加機(jī)器人;
3. 掃碼成功后,該成員的 QQ 消息列表中將出現(xiàn)機(jī)器人節(jié)點(diǎn),機(jī)器人進(jìn)入沙箱測試環(huán)境;
4. 可選操作:可繼續(xù)添加更多成員,所有成員均需通過 QQ 掃碼完成機(jī)器人添加。
通過http://IP:18789/ 打開openclaw管理界面,點(diǎn)擊右上角設(shè)置-claw設(shè)置;
1. 已獲取有效的 API Key(從對應(yīng)大模型平臺申請,如 OpenAI 官網(wǎng)、UCloud UModelVerse 控制臺)
2. OpenClaw 網(wǎng)關(guān)已啟動(openclaw gateway status 確認(rèn)狀態(tài)為 running)
3. 通過終端命令引導(dǎo)配置,無需手動改文件,步驟如下::
執(zhí)行模型配置命令:openclaw models add
按終端提示逐步填寫(以 OpenAI 兼容接口為例)
配置項(xiàng) | 示例值 | 說明 |
模型名稱(自定義) | gpt-4o | 便于識別,如 gemini-pro |
API 類型 | openai(回車默認(rèn)) | 可選 openai/gemini |
API Base URL | 第三方接口填對應(yīng)地址 | |
API Key | sk-xxxxxx | 你的平臺 API Key |
默認(rèn)模型 ID | gpt-4o | 如 gemini-1.5-pro |
最大上下文長度 | 8192(回車默認(rèn)) | 按需調(diào)整,不超模型限制 |
溫度(temperature) | 0.7(回車默認(rèn)) | 0-2,值越高回復(fù)越隨機(jī) |
配置完成后,終端會提示 Model [名稱] added successfully,執(zhí)行以下命令生效:openclaw gateway restart
4. 通道類型選擇QQ,在輸入框中填寫前文保存的QQApp ID和App Secret;
5. 點(diǎn)擊確定并確認(rèn)操作,等待數(shù)十秒完成配置;
6. 配置完成后查看通道狀態(tài),確保QQ通道顯示運(yùn)行中。
7. 完成上述模型配置和通道配置后,即可在 QQ 端與接入 OpenClaw 的 QQ 機(jī)器人進(jìn)行互動;
8. 重要限制:目前僅支持單獨(dú)聊天場景,群聊配置暫被 QQ 開放平臺限制。