乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw Windows安装配置避坑指南:新手小白也能轻松上手

OpenClaw Windows安装配置避坑指南:新手小白也能轻松上手

当前时间： 2026-08-16 03:02:54 分类：办公文件 评论(0)
OpenClaw Windows安装配置避坑指南:新手小白也能轻松上手

最近AI圈有个东西特别火——OpenClaw。

相信大部分人都听说过，也有很多人已经在用了。但对于没有技术背景的人来说，想用它却有点难——大概率卡在第一步：安装。

所以，今天这篇避坑版安装指南 ，保证你看完就能装好，哪怕你是第一次碰技术的小白；再按照文中的配置流程操作，相信你也很快有一只自己的"龙虾"了。

一、什么是OpenClaw？先搞懂再动手

在正式安装之前，先简单科普一下这个“龙虾”，省得后面晕头转向。

OpenClaw本质上是一个AI网关，它帮你把AI能力接到日常用的聊天软件里。

它能干啥？

    - 在QQ/Telegram里和AI直接聊天，就像有个私人助手

    - 早上起床问一句"昨天邮件处理得怎么样"，它帮你总结

    - 说一声"帮我每周五整理本周的浏览记录"，它自动定时执行

    - 用久了之后，它记得你的习惯，下次不用重复交代

    核心优势：

    • ✅全平台接入
    • ✅ 智能定时任务
    • ✅ 长期记忆进化
    • ✅ skills 加持,打造专属“数字员工”

    三个核心概念：

    • Gateway：网关，你控制AI助手的远程后台
    • Onboard：入职，相当于"启动"智能助手
    • Channels：渠道，接入的聊天软件（QQ、Telegram、飞书等）

    二、为什么这篇只讲Windows？

    在开始之前，先回答一个问题：为什么不讲Mac/Linux？

    原因很简单：

    1. 大多数人电脑用的就是Windows。对初次接触的人来说，会为了装一个工具，专门去重装系统吗？更重要的是，Windows上养龙虾，要踩坑是最多的，最需要避坑。

    2. 如果你已经在用Linux/Mac，那大概率已经是技术玩家了，养龙虾对你来说早就不在话下，也不用看这篇教程了。

    所以这篇就专注于Windows用户，帮助大家最快，最省事的方法在自己的主力系统上把OpenClaw跑起来，体验一下。

    三、安装前必看！这些准备工作不做等于白装

    正式开始安装前，有几件事必须先做好，否则分分钟踩坑。

    1. 必须安装的工具

    如果你的Windows只是用来办公，刷刷剧，大概率是没有下面的这三个工具的，所以用户需要提前下载并安装上这三个工具：

    工具
    干嘛用的
    去哪下载
    Node.js
    OpenClaw运行的基础
    官网 nodejs.org
    Git
    版本控制，很多操作需要它
    官网 git-scm.com
    VC++运行时库
    运行环境必备
    文末有直链

    避坑提示：Node.js建议选22版本，下载时选"LTS"长期支持版。

    2. 网络环境

    这可能是最容易被忽略的一点：

    • Telegram等软件需要国际网络
    • 调用ChatGPT模型也需要良好的网络环境

    建议：提前准备好稳定的国际网络代理。

    四、Windows安装步骤：两种方法任选

    好了，准备工作做完，正式进入安装环节。

    第一步：设置PowerShell权限

    Windows用户先不要急着安装，按下面步骤来，否则安装过程中脚本可能会闪退。

    打开PowerShell（右击开始菜单，选"Windows PowerShell(管理员)"），依次执行：

    # 1. 设置执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser# 2. 绕过执行策略Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass

    第二步：执行安装

    在PowerShell中执行：

    powershell -c"irm https://openclaw.ai/install.ps1 | iex"

    如果卡住了，按Ctrl+C终止，然后重试一次。

    避坑提示：

    • 安装过程会有很多红色警告，别慌，只要不是致命错误就问题不大
    • 耐心等待，出现"success"或者完成提示才算成功

    如果你上面的安装失败，大概率是一个叫llama东东装不上，这个其实可以跳过，可以改用这个方法，更快更精简。

    第二步：执行安装（改）

    # 1. 跳过 llama 的安装$env:NODE_LLAMA_CPP_SKIP_DOWNLOAD="true"# 2. 强制安装并忽略报错的后续脚本npm install -g openclaw@latest --ignore-scripts

    ⚠️ 安装过程会出现若干警告，不必担心，耐心等待安装完成。

    第三步：验证安装

    装好了？验证一下：

    openclaw help

    如果弹出帮助信息，说明安装成功。

    五、配置流程：入职操作

    装好了不算完，还得"入职"才能用。

    启动入职流程

    openclaw onboard

    这里选择"Quick Start"快速配置，按照指引一步一步来，省时省力，主要关注的有两点：一是模型的配置；一是接入平台（channel）的配置。

    如果你有能力的话，完全可以通过修改配置文件的方式进行配置，配置文件在哪？

    %USERPROFILE%\.openclaw\openclaw.json

    六、模型配置

    最关键的一步来了——让你的AI能回答问题。

    使用Nvidia NIM免费模型

    不需要花冤枉钱，Nvidia提供免费API Key！

    1. 访问 https://build.nvidia.com/
    2. 注册账号
    3. 获取免费API Key

    配置示例（把下面的内容复制到配置文件里）：

    {"agents":{"defaults":{"model":{"primary":"nvidia/stepfun-ai/step-3.5-flash","fallbacks":["nvidia/moonshotai/kimi-k2.5"]}}},"gateway":{"port":18789,"bind":"loopback","auth":{"mode":"token","token":"你自定义的token"}},"models":{"mode":"merge","providers":{"nvidia":{"baseUrl":"https://integrate.api.nvidia.com/v1","apiKey":"你申请的nvapi-key","api":"openai-completions","models":[{"id":"stepfun-ai/step-3.5-flash","name":"stepfun-ai/step-3.5-flash","reasoning":true,"input":["text"],"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite":0},"contextWindow":128000,"maxTokens":8192}]}}}}

    避坑提示：保存配置文件时，务必保留Gateway部分的token，否则你会连不上自己的AI。

    如果觉得免费模型不够用，也可以换成国内的模型，比如Kimi、Minimax等，价格不贵，额度也充足。

    七、接入平台：QQ/飞书

    到这一步，你的AI已经能"说话"了。现在需要把它接到聊天软件里。

    接入QQ

    1. 去QQ官方创建机器人QQBot
    2. 登录你的QQ账号
    3. 按照页面提示创建QQ机器人
    4. 获取对接参数和一键对接命令
    5. 执行对接命令
    接入飞书

    飞书稍微复杂一点，按步骤来也能搞定：

    第一步：安装插件

    openclaw plugins enable feishu

    验证状态：

    openclaw plugins list
    • disabled
       = 禁用
    • loaded
       = 启用

    第二步：创建飞书应用

    1. 打开 飞书开放平台
    2. 点击「创建企业自建应用」
    3. 填写应用名称（如"我的OpenClaw AI"）、描述、图标
    4. 保存App ID和App Secret

    第三步：配置Channel

    openclaw channels add

    按提示选择：

    • 选择 "Feishu/Lark (飞书)"
    • 输入 App Secret 和 App ID
    • 连接模式选国内域名
    • 群聊策略选 Open

    第四步：开启机器人能力

    1. 飞书应用界面 → 添加应用能力 → 机器人
    2. 点击「添加」开启机器人能力

    第五步：配置权限

    权限管理 → 批量导入/导出权限，粘贴JSON（详见原文）。

    第六步：配置事件订阅

    事件与回调 → 事件配置，添加：

    • im.message.receive_v1
       - 接收消息
    • im.message.message_read_v1
       - 消息已读回执
    • im.chat.member.bot.added_v1
       - 机器人进群
    • im.chat.member.bot.deleted_v1
       - 机器人被移出群

    第七步：发布应用

    版本管理与发布 → 创建版本 → 提交审核 → 发布

    八、启动与测试

    所有配置完成，启动服务：

    openclaw gateway

    或指定端口：

    openclaw gateway --port 18789

    测试一下：

    • 在对应平台建个测试群
    • 把机器人拉进群
    • @它让自我介绍，能正常回复就算跑通了！

    九、写在最后

    OK，以上就是OpenClaw的避坑安装指南。

    这篇主要讲Windows平台的安装，其他平台（Mac、Linux）的思路差不多，安装命令稍微有点区别。如果有需要，后面再单独出。

    安装过程中遇到任何问题，随时来问。

    📎 工具下载汇总

    Node.js： https://nodejs.org/zh-cn/download

    Git： https://git-scm.com/download/win 或 https://gitforwindows.org/

    VC++运行时库： https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170