OpenClaw 部署全攻略：Windows WSL2 Ubuntu + Kimi/MiniMax + QQ 机器人

OpenClaw 是一个开源的 AI 智能体（Agent）平台。在 Windows 的 WSL2 (Ubuntu) 环境下运行它性能更稳。

第一阶段：准备工作（获取“通行证”）

在动代码之前，你需要先拿到模型和机器人的密钥。

1. 获取模型 API Key（任选其一）

• Kimi (Moonshot AI)：点击前往开放平台
  • 注册并实名后，在“API Key 管理”中创建一个密钥。
• MiniMax：点击前往开放平台
  • 进入控制台，在“账户管理”->“接口密钥”中创建 API Key。

2. 申请 QQ 机器人

• 官方入口：QQ 开放平台 (机器人)
• 核心操作：
  1. 扫码登录后点击“创建机器人”。
  2. 在“开发设置”中获取 AppID 和 Token（这是联调的关键）。
  3. 确保在后台开启了“消息推送”权限。

第二阶段：环境搭建 (Windows WSL2 Ubuntu)

打开你的 Ubuntu 终端，依次执行以下操作：

1. 安装 Node.js (建议使用 nvm 管理)

# 下载并执行 nvm 安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 刷新环境配置
source ~/.bashrc
# 安装最新的 Node.js v22
nvm install 22

2. 安装 OpenClaw

执行官方一键安装脚本：

curl -sSL https://openclaw.ai/install.sh | bash

• 初始化提示：安装后若自动弹出引导，输入 Yes 同意协议，模式选 QuickStart，其余配置可以一路回车跳过，或者 Ctrl+C 强制退出配置过程，我们稍后手动精确配置。

第三阶段：配置模型与插件

1. 填入模型密钥

输入命令：openclaw configure

• 如果你选 Kimi：Provider 选择 Moonshot AI，填入 sk-xxx 密钥，Base URL 保持默认或填 https://api.moonshot.cn/v1。
• 如果你选 MiniMax：Provider 选择 MiniMax，填入对应密钥。

2. 安装并绑定 QQ 机器人

在终端执行：

# 1. 安装 QQ 机器人插件
openclaw plugins install @sliverp/qqbot@latest

# 2. 绑定你的机器人 Token
# 注意：YOUR_BOT_TOKEN 替换为你申请到的真实 Token
openclaw channels add --channel qqbot --token "YOUR_BOT_TOKEN"

# 3. 重启网关使配置生效
openclaw gateway restart

第四阶段：启动、测试与排错

1. 检查运行状态

openclaw status

如果 Gateway 和 Core 显示为 running，说明服务已启动。

2. 联调测试

给你的 QQ 机器人发送消息（如：你好）。

• 成功：机器人调用 Kimi/MiniMax 并回传消息。
• 失败：如果机器人没反应，请执行 openclaw logs -f 查看实时报错日志。

💡 给“小白”的进阶建议

1. 如何在 Windows 下修改配置？

如果你不习惯用 Linux 命令修改文件，可以在 Windows 资源管理器地址栏输入以下路径直接打开：
\\wsl$\Ubuntu\home\你的用户名\.openclaw\
在这里可以直接用记事本编辑 openclaw.json。

2. 保持后台运行

当你关闭 Ubuntu 窗口时，程序可能会停止。建议安装 pm2 来守护进程：

npm install -g pm2
pm2 start openclaw

3. 安全提醒

绝对不要把包含 API Key 的 openclaw.json 文件发给他人或上传到公开的 GitHub 仓库。

结语：到这里，你的 AI 智能体已经“入驻” QQ 了。下一步，你可以尝试在 OpenClaw 中编写自定义插件，让它实现更复杂的功能。