正文

Windows下载OpenClaw源码，启动和安装攻略

haitao
haitao V管理员 /2阅读/0评论
0319
文章最后更新时间2026年03月19日，若文章内容或图片失效，请留言反馈！

从没有任何基础开始去配置用于开发的环境，最害怕的便是卡在某一个命令行出现错误提示而半天都没办法解决，特别是像“node not found”这种类型的提示，实际上往往仅仅只是存在一个系统变量没有设置妥当而已。

全局命令的打通

不少 developer 在完成工具链安装之后，发觉径直于命令行键入命令却没效果，这一般是由于系统寻觅不到可执行文件的路径所致。就以 pnpm 来说，当你开展安装完毕后，要运行 pnpm link --global 去构建全局链接，此操作会把命令登记到系统的环境变量目录里。

要验证这一步是不是成功，其实挺简单的，只需直接在新打开的命令行窗口里输入pnpm --version。要是能够看到版本号提示，那就表明全局命令已然打通；要是仍然提示“不是内部或外部命令”，那就得去检查环境变量PATH当中有没有添加npm或者pnpm的全局模块路径。

安装器的精准配置

当运行安装器之时，面对着数量众多的工作负载选项极易使人的眼睛产生缭乱之感。就基础性的C++开发编译环境而言，我们仅仅需要于列表之中勾选“使用C++的桌面开发”这一选项，其他诸如.NET或者UWP开发工具暂时都不需要去勾选，以此避免造成硬盘空间以及安装时间的浪费。

先进行选择，之后点击安装，此过程一般需十几分钟，结束之际必须依照提示重启电脑，这是为使系统环境变量及注册表更新得以生效，若跳过此步骤常常会致使后续编译步骤出现各类怪异的链接错误。

Windows下载OpenClaw源码，启动和安装攻略

依赖的清理与重建

要是项目运行“pnpm build”的时候出现报错，而且错误所指向的是“/xxx.sh: line 31: node: not found”，那么此时问题极有可能是出在了依赖包检测不到Node环境这件事情上。此时，不妨先把项目根目录下边的node_modules文件夹给删除掉，同时还要把pnpm-lock.yaml文件也删除掉，接下来再去执行pnpm store prune，以此来进行缓存的清理。

完成清理操作之后，再次运行 pnpm install 去安装依赖，这个过程会再度依据 package.json 去解析依赖树，进而生成全新的 lock 文件，如此能够有效地解决因依赖包版本混乱或者二进制文件缺失而致使的编译失败问题。

新手向导的初次启动

针对刚开始接触这一整套工具链的新手而言，配置向导给予了友善的入门体验，首先应挑选 Setup mode 配置模式，一般新手推荐直接采用默认选项，其能够自动处理大部分底层设置，规避手动修改配置文件的繁杂。

跟着进入Model/auth这个环节，在此处你得去挑选执行模型以及对应的供应商，就像去选那种OpenAI格式的API一样。在确认好模型名称以及认证信息之后，界面上所有的配置项都呈现出具体的数值，这也就意味着初始化配置成功了，如此便能够进入到下一步了。

本地网关的启动验证

当配置达成之后，要开启本地网关服务以实现前后端的连接。于命令行当中执行/gateway set mode去设置运行模式，接着键入/gateway start来开启服务。在启动成功以后，控制台会给出监听地址的提示，一般而言是http://localhost:18789。

最为关键的那一步是于浏览器之中打开此地址，要是能够看到初始化连接的配置界面，那就表明网关已然正常运作。在这个网页界面之上，你还得填入先前配置好的token以及模型参数，以此完成最后的连接握手。

Windows下载OpenClaw源码，启动和安装攻略

报错的快速定位思路

撞见报错别慌乱，先瞅错误提示起始的头几行。就像/bin/sh: line 31: node: not found这般，它清晰地告知你是于执行shell脚本的第31行处寻觅不到node命令，这一般是在指示环境变量PATH未被继承，能够试着于命令行里先键入echo %PATH%去瞧瞧是不是涵盖了Node.js的安装路径。

要是属于编译相关的报错情形，像缺失Windows SDK或者C++工具集这种情况，那就得回过头去检查第一步的安装器，要确认“使用C++的桌面开发”组件确实已经进行安装，而且还重启过电脑。很多时候，再次依照步骤完整走一遍便能够解决问题。

配置开发环境之际，碰到最多的究竟是路径方面的问题，还是权限这块的问题呢？欢迎于评论区去分享你那遭遇困难的经历，点赞并且收藏这篇文章，下次配置环境时直接依照这样子去做便可以了。

// openclaw.json
{
  // ...,
  "models": {
    "providers": {
      "DeepSeek": {
        "baseUrl": "xxx", // 替换即可
        "apiKey": "xxx", // 替换即可
        "api": "openai-completions",
        "models": [
          {
            "id": "xx", // 替换即可
            "name": "DeepSeek-V3.2 (非思考模式)",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}