OpenClaw windows本地搭建与连接白山智算

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ,讲透 AI 如何接管脏活累活

前言

OpenClaw 是目前极具潜力的本地 AI Agent(智能体)框架。与传统的“对话框 AI”不同,它能够深度接管本地环境,帮你直接操作文件、执行终端命令以及完成复杂的自动化任务。

之前也在本地折腾过deepseek和comfyui,看目前小龙虾这么火,我也想在本地折腾一下,网上的教程大多推荐使用 WSL2(Windows 下的 Linux 子系统)进行隔离安装,我这边写一份windows11 的,也以此记录一下。

直接购买国内外(特指国外)模型价格较高,之前也在不少网站上薅过第三方的羊毛,这次就以OpenClaw 对接 “白云智算”为例

一、环境准备

OpenClaw 强依赖 Node.js 环境,且需要 Windows 终端具备执行脚本的权限。

安装带编译工具的 Node.js

  1. 前往 Node.js 官方网站。
  2. 下载最新的 Windows LTS 版本(推荐 Node.js 22 或以上版本的 .msi 安装包)。
  3. 双击运行安装。【关键细节】:在安装向导中,如果出现 Automatically install the necessary tools(自动安装必要的工具,包含 Python 和 Visual Studio Build Tools)的复选框,请务必勾选! 这是为了防止后续 OpenClaw 在编译底层原生模块时发生报错。
  4. 安装完成后,重启电脑使环境变量生效。

解除 PowerShell 脚本执行限制

Windows 11 默认的系统安全策略会拦截通过 npm 安装的全局脚本运行,必须手动放行。

  1. 右键点击 Windows 任务栏的“开始”图标,选择 “终端 (管理员)” 或 “Windows PowerShell (管理员)”。
  2. 在终端内输入以下命令并回车:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  1. 系统提示确认时,输入 Y 并回车。
  2. 验证环境:输入 node -v 和 npm -v,若均能正常打印版本号,说明准备就绪。

二、核心组件安装与初始化向导

全局安装 OpenClaw

  1. 全局安装 OpenClaw
    在刚才的 PowerShell 窗口中,执行以下 npm 命令进行全局安装:
npm install -g openclaw@latest

(注:根据网络情况可能需要 1-3 分钟,安装完毕后可通过 openclaw --version 检查是否成功。)

  1. 初始化配置 (Onboard) —— 极简流
    第一次运行需要进行初始化。强烈建议不要在命令行黑框里做任何实质性的配置,一路跳过,优先把本地图形化服务跑起来。
    在终端输入启动命令:
openclaw onboard

向导选择策略:

  • Mode (模式): 选择 > QuickStart。
  • Model/auth provider (模型供应商): 滚动到最底部,选择 > Skip for now。
  • Filter models (模型过滤): 选择 > All providers。
  • Default model (默认模型): 直接保持默认,按回车(仅作占位符)。
  • Channel (聊天频道): 滚动到最底部,选择 > Skip for now。
  • Skills/Hooks (技能与钩子): 均选择 > No 或 > Skip for now。

向导最后一步 How do you want to hatch your bot?,务必选择 > Open the Web UI。
此时,程序会在后台启动本地网关,并自动打开浏览器(或在终端输出控制台网址,通常为 http://localhost:18789)。

接入第三方大模型(以白山智算为例)

进入 Web UI 仪表板后,我们需要为 OpenClaw 注入“大脑”。对于提供兼容接口的第三方平台,配置步骤如下:

  1. 在 Web UI 左侧导航栏找到 “设置 (Settings)” -> “模型 (Models)”。

  2. 页面滚动到底部找到 Model Providers (模型供应商) 板块,点击 + Add Entry。

  3. 在弹出的表单中进行精准配置:
    Provider ID: 填入自定义名称,必须为纯英文(如 custom)。
    Model Provider Base URL: 填入第三方平台提供的接口地址,必须以 /v1 结尾(例如:https://api.edgefn.net/v1)。
    Model Provider API Key: 粘贴平台生成的密钥(通常为 sk-…)。
    Api Adapter (极其重要): 下拉菜单选择 openai-completions。
    在这里插入图片描述

  4. 在下方的 Model List 中,点击 + Add。
    Id: 精确填入平台上的模型名称(如 DeepSeek-V3.2)。
    Api: 同样选择 openai-completions。

  5. 点击页面底部或右上角的 Save (保存)。

  6. 前往左侧导航栏的 “代理 (Agents)”,点击默认代理 main。将其首选模型(Primary Model)下拉菜单切换为你刚才配置的 custom/DeepSeek-V3.2 并保存。

以上所有配置都能在 C:\Users\你的名称.openclaw\openclaw.json 中找到,注意还需要同步修改C:\Users\你的名称.openclaw\agents\main\agent\models.json 文件

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ,讲透 AI 如何接管脏活累活

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值