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