OpenClaw 在 Windows10下部署安装

第一步：安装前置依赖
1.1 安装 Node.js 
方法一：官方安装程序（推荐）

访问 https://nodejs.org/
下载 Windows 安装程序 (.msi)
运行安装程序，选择 LTS 版本，22版本以上
勾选"Automatically install necessary tools"（包括 npm 和 chocolatey）
完成安装后重启终端
方法二：使用 Chocolatey

# 以管理员身份运行 PowerShell
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
 
# 安装 Node.js
choco install nodejs-lts -y

方法三：使用 Winget

winget install OpenJS.NodeJS.LTS

1.2 安装 Git

方法一：官方安装程序

1. 访问 https://git-scm.com/download/win
2. 下载并运行安装程序
3. 使用默认选项即可

方法二：使用 Chocolatey

choco install git -y

安装openclwd 

用国内阿里源

使用 cnpm 

如果希望快速绕过配置问题，可以安装淘宝团队提供的 cnpm 命令行工具，它会默认使用淘宝镜像 -1-8。

# 全局安装 cnpm npm install -g cnpm --registry=https://registry.npmmirror.com/ #

之后使用 cnpm 命令代替 npm cnpm install -g openclaw-cn

安装完后配置

详细配置步骤说明

初次运行 openclaw-cn onboard 命令后，会出现一个交互式的配置向导。根据多位网友的经验 -3-5-7，你需要依次处理以下几个核心配置项：

1. 风险确认：你会看到一个关于 AI 智能体权限的风险提示，选择 YES 继续 -5-6。

2. 选择配置模式：新手请毫不犹豫地选择 QuickStart（快速开始），这将引导你完成最精简的配置 -3-5。

3. 配置 AI 模型（核心）：

   • 向导会列出支持的模型平台，如阿里云百炼（通义千问）、DeepSeek、智谱、MiniMax 等 -6。使用方向键选择你拥有 API Key 的平台。

   • 接下来，系统会提示你输入 API Key -4-7。复制粘贴即可（粘贴时可能不显示字符，是正常现象）。

4. 配置通信渠道：这一步可以先选 Skip（跳过）-3-5。这样能最快地完成配置，让你先通过 Web 界面体验核心功能。

5. 配置技能和钩子：

   • 技能 (Skills)：建议选择 YES 安装默认技能包 -6。

   • 钩子 (Hooks)：根据提示，可以使用空格键选择你需要的功能 -4。

6. 完成与启动：所有配置完成后，向导最后一步通常会询问你如何启动。选择 Open the Web UI，浏览器就会自动打开管理界面 -3-7。

💡 常用命令与下一步

完成配置并启动网关后，你就可以在 Web 界面（http://127.0.0.1:18789）与 AI 助手对话了 -4-7。其他常用命令如下：

• 查看网关状态：openclaw-cn gateway status -3-8

• 重启网关：openclaw-cn gateway restart -3

• 运行诊断工具：openclaw-cn doctor -4（遇到问题时首先运行这个）

• 修改配置：openclaw-cn configure -4

完成配置向导并成功启动服务后，你希望接下来接入哪个平台来使用你的 AI 智能体呢？比如飞书、钉钉，还是保持网页版使用？告诉我你的想法，我可以为你提供后续的具体配置步骤。

免费的key

如何选择你的第一个免费 API？

根据你的需求，可以从下面几个“第一梯队”里选 -3：

通用申请三步走（以阿里云百炼为例）

不管选哪个平台，申请流程都大同小异，基本分为三步：

1. 注册/登录：访问你选择的平台官网，注册账号并登录。

2. 实名认证：这是获取免费额度的关键一步。绝大部分国内平台都需要实名认证才会发放免费额度 -1-9。根据提示上传身份证信息即可，通常很快就能通过。

3. 创建 API Key：进入控制台的“API-KEY管理”或类似页面，点击“创建新的 API Key”，复制并保存好生成的密钥。注意：这个密钥通常只显示一次，一定要保存好！

以 阿里云百炼 为例，流程如下 -7：

1. 进入阿里云百炼平台，点击“管理控制台”。

2. 如果是第一次使用，点击“开通服务”并领取免费额度。

3. 鼠标悬停在右上角头像上，选择“API-KEY”，点击“创建我的API-KEY”，复制保存即可。

💡 重要提醒与省钱小贴士

• 额度刷新：像百度千帆、阿里魔搭社区等平台提供的是每日刷新的免费额度，比如每天2000次调用，适合长期、持续的小流量使用 -9。

• 用完即停：在平台控制台，建议开启“免费额度用完即停”功能，防止免费额度用完后，因程序bug或高并发等原因无意中产生扣费 -2。

• 多备几个Key：建议同时注册2-3个平台的免费Key，一方面可以对比不同模型的效果，另一方面当一个平台的免费额度用尽或遇到故障时，可以随时切换 -6。

• 配置到OpenClaw：拿到 API Key 后，在 OpenClaw 的配置向导 (openclaw-cn onboard) 中选择对应的模型提供商，粘贴你的 Key 就可以了。

你是打算主要在国内网络环境下使用，还是想优先尝试国外的模型？这两个方向主推的平台不太一样，告诉我你的想法，我帮你锁定最合适的一个。

添加QQ机器人：

第一步：在QQ开放平台创建机器人

1. 访问QQ开放平台：用手机QQ扫码登录 QQ开放平台-3-4。

2. 一键创建机器人：登录后，页面会有一个显眼的【创建机器人】按钮，点击一次即可快速生成一个新的机器人账号-3-6。每个QQ号最多可以创建5个机器人-3-6。

3. 获取接入密钥：创建成功后，页面会直接显示三行配置命令和你的机器人密钥（格式是 AppID:AppSecret）-3-4。先复制保存好这个密钥，下一步要用。

4. 把机器人加为好友：创建页面通常会有【扫码聊天】或直接添加的入口，记得把刚创建的机器人添加到你的QQ好友列表里-4。

💻 第二步：在OpenClaw中安装QQ插件并配置

打开你的OpenClaw运行环境（终端或命令行），依次执行以下三条命令：

# 1. 安装QQ机器人官方插件
openclaw plugins install @sliverp/qqbot@latest
# 2. 添加QQ频道（将命令中的token替换成你刚才复制的 "AppID:AppSecret"）
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"
# 3. 重启网关，使配置生效
openclaw gateway restart
[citation:3][citation:4]

🧪 第三步：测试QQ机器人

1. 打开手机QQ或电脑QQ，找到你刚才添加的机器人好友-6-7。

2. 给它发一条消息，比如“你好”。

3. 如果机器人正常回复你，恭喜你，接入成功！你的QQ已经变成了OpenClaw的AI入口。

🔧 如果遇到问题openclaw doctor

• openclaw doctor --fix

  或者手动重启网关：openclaw gateway restart-4

• 担心密钥泄露：可以在QQ开放平台随时重置机器人密钥，然后在OpenClaw中更新配置即可-3。

• 使用体验：接入后，QQ机器人支持Markdown、图片、语音、文件等多媒体消息收发，手机端和电脑端都可以正常使用-3-6-7。

出现的问题

权限问题

镜像源问题等等