Windows下OpenClaw安装指南:对接ollama版GLM-4.7-Flash

1. 为什么选择这个组合?

去年我在尝试自动化办公流程时,发现市面上的AI助手要么功能受限,要么需要将敏感数据上传到云端。直到遇到OpenClaw这个开源框架,它让我能在本地电脑上实现真正的自动化操作。最近ollama平台发布了GLM-4.7-Flash模型,这个轻量级模型特别适合本地部署场景。今天我就来分享如何在Windows系统上搭建这套组合。

这个方案有几个明显优势:首先,所有数据处理都在本地完成,不用担心隐私泄露;其次,GLM-4.7-Flash模型响应速度快,Token消耗相对较低;最重要的是,OpenClaw可以直接操控我的办公软件和浏览器,实现真正的端到端自动化。

2. 环境准备与基础安装

2.1 系统要求检查

在开始前,请确保你的Windows系统满足以下条件:

  • Windows 10或更高版本(建议使用Windows 11)
  • PowerShell 5.1+(可通过$PSVersionTable.PSVersion命令查看)
  • 至少8GB内存(GLM-4.7-Flash模型运行需要约4GB内存)
  • 稳定的网络连接(用于下载依赖包)

2.2 管理员权限处理

OpenClaw需要系统级权限来操作鼠标键盘和文件系统。右键点击PowerShell图标,选择"以管理员身份运行"。这是很多新手容易忽略的关键步骤,没有管理员权限会导致后续安装失败。

# 验证当前是否为管理员会话
([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

如果返回False,请关闭当前窗口重新以管理员身份启动PowerShell。

2.3 Node.js环境配置

OpenClaw基于Node.js开发,我们需要先安装Node环境:

# 检查现有Node版本
node -v
npm -v

# 如果没有安装,使用winget安装最新LTS版本
winget install OpenJS.NodeJS.LTS

安装完成后,建议设置npm的全局安装路径到当前用户目录,避免权限问题:

npm config set prefix "$env:APPDATA\npm"

3. OpenClaw核心安装流程

3.1 通过npm安装主程序

在管理员PowerShell中执行以下命令:

npm install -g openclaw@latest

这个步骤可能会花费几分钟时间,取决于你的网络速度。我第一次安装时因为公司网络代理问题失败了三次,后来发现需要先配置npm代理:

npm config set proxy http://your-proxy-address:port
npm config set https-proxy http://your-proxy-address:port

安装完成后验证版本:

openclaw -v

3.2 初始化配置向导

运行配置向导,这里我推荐选择Advanced模式以便自定义模型连接:

openclaw onboard

在向导中需要注意几个关键选项:

  1. Mode选择:选Advanced以获得更多控制权
  2. Provider选择:选Skip for now(我们稍后手动配置GLM-4.7-Flash)
  3. Channels选择:初次使用建议跳过,熟练后再配置飞书等通讯工具
  4. Skills选择:根据需求勾选,建议至少选择File OperationsWeb Browser

4. 对接ollama版GLM-4.7-Flash

4.1 获取模型服务地址

假设你已经按照ollama的文档部署了GLM-4.7-Flash模型,默认服务地址通常是:

http://localhost:11434

可以通过以下命令测试模型是否正常运行:

curl http://localhost:11434/api/generate -d '{
  "model": "GLM-4.7-Flash",
  "prompt":"你好"
}'

4.2 修改OpenClaw配置文件

找到OpenClaw的配置文件,通常位于:

C:\Users\<你的用户名>\.openclaw\openclaw.json

用文本编辑器打开,在models.providers部分添加以下配置:

{
  "models": {
    "providers": {
      "ollama-glm": {
        "baseUrl": "http://localhost:11434",
        "apiKey": "ollama",  // ollama通常不需要真实API Key
        "api": "openai-completions",
        "models": [
          {
            "id": "GLM-4.7-Flash",
            "name": "GLM-4.7-Flash (Ollama)",
            "contextWindow": 32768
          }
        ]
      }
    }
  }
}

保存文件后,需要重启网关服务使配置生效:

openclaw gateway restart

4.3 验证模型连接

使用以下命令检查模型是否成功连接:

openclaw models list

你应该能看到类似这样的输出:

✔ Loaded 1 model provider(s)
- ollama-glm (1 model)
  └── GLM-4.7-Flash (alias: GLM-4.7-Flash (Ollama))

5. 网关服务与端口配置

5.1 启动网关服务

默认情况下,OpenClaw网关使用18789端口。启动命令如下:

openclaw gateway --port 18789

如果想在后台运行,可以使用:

openclaw gateway start

5.2 处理端口冲突

如果遇到端口冲突错误(比如18789被占用),有两种解决方法:

方法一:指定其他端口号

openclaw gateway --port 18790

方法二:找出并关闭占用进程

netstat -ano | findstr :18789
taskkill /PID <进程ID> /F

5.3 访问Web控制台

成功启动网关后,在浏览器访问:

http://localhost:18789

第一次访问时,系统会提示你设置管理员密码。这个控制台是管理OpenClaw任务和查看执行记录的主要界面。

6. 常见问题排查

6.1 npm安装失败问题

如果遇到npm安装错误,可以尝试以下步骤:

  1. 清理npm缓存:
    npm cache clean --force
    
  2. 删除node_modules目录(如果存在)
  3. 重新运行安装命令

6.2 模型连接超时

当模型服务正常但OpenClaw无法连接时,检查:

  1. 防火墙设置,确保18789和11434端口开放
  2. 模型服务是否正常运行(用curl测试)
  3. 配置文件中的baseUrl是否正确

6.3 权限不足错误

如果遇到文件操作或系统调用权限错误:

  1. 确保全程使用管理员PowerShell
  2. 检查OpenClaw服务运行账户权限
  3. 对于特定文件夹,可能需要手动设置写入权限

7. 第一个自动化任务测试

现在我们可以测试一个简单的自动化流程:让OpenClaw使用GLM-4.7-Flash生成一段文本并保存到本地文件。

在Web控制台的"任务"页面,输入以下指令:

请用GLM-4.7-Flash生成一篇关于人工智能未来发展的短文,字数约300字,然后将结果保存到C:\Temp\AI_Article.txt

如果一切配置正确,你应该能在指定路径找到生成的文件。这个简单的测试验证了整个流程的连通性。


获取更多AI镜像

想探索更多AI镜像和应用场景?访问 CSDN星图镜像广场,提供丰富的预置镜像,覆盖大模型推理、图像生成、视频生成、模型微调等多个领域,支持一键部署。

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐