OpenClaw 在 Windows 上安装、配置 Kimi，并接入 QQ 机器人的保姆级教程

介绍

OpenClaw 是一个开源的 AI 智能体(Agent) 平台，支持接入多种大语言模型，并通过插件连接不同的消息渠道。

本文将带你在 Windows 环境下完成以下事情：

1. 安装 OpenClaw
2. 配置 Kimi（Moonshot AI）模型
3. 接入 QQ 机器人
4. 完成启动、联调和基础排错

先决条件

在开始前，请先准备好以下环境：

• 操作系统：Windows 11
• 安装 Node.js：建议 v22.x 或更高版本
• 安装 Git：用于插件管理与后续更新
• 获取 Kimi API Key：从 Moonshot AI 开放平台 获取

相关下载地址：

• Node.js：https://nodejs.org/
• Git：https://git-scm.com/

安装 OpenClaw

1. 右键点击开始菜单搜索或者找到“终端”，右键“以管理员身份运行” “终端”或 PowerShell。
2. 执行命令打开 PowerShell 执行策略（Execution Policy）防止系统阻止脚本运行，终端输入下面命令后回车。

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 执行安装脚本，终端输入下面命令后回车。：

iwr -useb https://openclaw.ai/install.ps1 | iex

4. 根据首次启动引导完成初始化，安装流程是英文很多地方可以先跳过(skip for now)：
   - 输入 Yes 同意协议
   - 模式选择 QuickStart 后面配置如果不熟悉都跳过(skip for now)，也可以 Ctrl + C 退出配置过程

5. 安装完成后，检查版本，终端输入下面命令后回车。：

.\AppData\Roaming\npm\openclaw.cmd --version

正常会返回版本号，如：2026.3.7 ，说明安装成功。

步骤 2：配置 Kimi（Moonshot AI）模型

Kimi 提供 OpenAI 兼容接口，因此在 OpenClaw 中接入通常比较直接。

2.1 进入配置向导

.\AppData\Roaming\npm\openclaw.cmd configure

在交互菜单中进入模型或认证相关配置项，通常是 Model/auth 一类的入口。

2.2 推荐配置项

按以下思路填写：

• Provider：选择 Moonshot AI
• 如果没有内置 Moonshot AI 选项，也可以选择 OpenAI-Compatible
• API Key：填写你在 Moonshot 后台获取的 sk-xxxxxxxxxxxx
• Base URL：https://api.moonshot.cn/v1
• Default Model：可先使用 moonshot-v1-8k

如果你对上下文长度有更高需求，也可以根据账号权限选择更大上下文版本，例如 32k 或 128k 对应型号。

2.3 手动检查配置文件

如果你不放心，可以在本地直接检查配置文件，用文本编辑器打开修改。

• Windows 路径：%USERPROFILE%\.openclaw\openclaw.json

其中与 Moonshot 相关的配置大致可以参考下面的结构：

{
  "moonshot": {
    "apiKey": "你的_KIMI_API_KEY",
    "baseUrl": "https://api.moonshot.cn/v1",
    "models": [
      {
        "id": "moonshot-v1-8k",
        "name": "Kimi 8k"
      }
    ]
  }
}

步骤 3：配置 QQ 机器人

3.1 申请 QQ 机器人，获得机器人 BOT_TOKEN

1. 官方入口： 访问 q.qq.com/qqbot/openclaw/login.html，使用手机 QQ 扫码。

2. 创建机器人： 在开放平台点击“创建机器人”，系统将自动生成 AppID 与 AppSecret。

3.2 安装 QQ 机器人官方插件

终端执行命令：

.\AppData\Roaming\npm\openclaw.cmd plugins install @sliverp/qqbot@latest

3.3 绑定渠道（替换为你获得的 token）

终端执行命令：

.\AppData\Roaming\npm\openclaw.cmd channels add --channel qqbot --token "YOUR_BOT_TOKEN"

3.4 重启网关生效

终端执行命令：

.\AppData\Roaming\npm\openclaw.cmd gateway restart

步骤 4：启动与联调

4.1 查看 OpenClaw 运行状态

.\AppData\Roaming\npm\openclaw.cmd status
.\AppData\Roaming\npm\openclaw.cmd gateway status

4.2 测试 QQ

完成 OpenClaw 启动后，给 QQ机器人 发送消息进行测试
如果机器人能回消息，说明 QQ机器人 与模型链路都已经打通。

安全与使用建议

正式使用前，建议注意以下几点：

• 不要把 API Key 直接发给别人
• 尽量不要把完整配置文件截图发到公开群里

结语

到这里，你已经完成了一个基础版的 OpenClaw + Kimi + QQ 机器人部署流程。

最关键的思路其实只有三步：

1. 先让 OpenClaw 本体跑起来
2. 再让 Kimi 模型单独验证通过
3. 最后 QQ 机器人 渠道接上来

只要按照这个顺序排查，大多数问题都能比较快定位。