OpenClaw快速部署与使用实战指南（智谱AI）

面对日益丰富的AI开发工具，OpenClaw凭借灵活的插件体系与跨平台兼容性，正成为开发者构建自动化工作流的首选方案。本指南将从零开始，带您完成环境部署、基础配置及智谱AI模型接入，确保一站式搞定。

部署快速指南

第一步：搭建核心运行环境

OpenClaw的运行依赖Node.js，而nvm是管理Node.js版本的最优工具，能够彻底规避版本冲突问题。

0. 下载并安装 Windows 版 nvm
   • 前往 nvm-windows GitHub Releases 页面获取安装包
   • 运行 nvm-setup.exe，保持默认设置即可完成安装
1. 以管理员权限启动 PowerShell
   • 按下 Win 键，输入 PowerShell
   • 右键点击搜索结果，选择 "以管理员身份运行"
2. 安装并切换至 Node.js 22 版本

   # 安装 Node.js 22 的最新版本
   nvm install 22
   
   # 使用指定版本
   nvm use 22.22.0

   终端输出 "Now using node v22.22.0" 即表示版本切换成功。

第二步：安装 OpenClaw

推荐使用官方一键安装脚本：

# 在 PowerShell 中执行
iwr -useb https://openclaw.ai/install.ps1 | iex

或通过 npm 全局安装：

npm install -g openclaw@latest

执行初始配置向导

首次安装后，OpenClaw 会自动启动配置向导。以下是经过验证的推荐配置方案：

第三步：接入智谱AI模型

智谱AI为开发者提供免费模型API，注册后即可获取API Key，对初期测试尤为友好。

# 编辑配置文件
notepad $env:USERPROFILE.openclawconfig.json

在配置文件的 models.providers 部分追加以下内容：

 "models": {
        "providers": {
          "zhipu": {
            "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
            "apiKey": "apiKey",
            "api": "openai-completions",
            "models": [
              {
                "id": "glm-4.5-air",
                "name": "GLM-4.5-Air",
                "reasoning": false,
                "input": [
                  "text"
                ],
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                },
                "contextWindow": 202000,
                "maxTokens": 8192
              }
            ]
          }
        }
      },
      "agents": {
        "defaults": {
          "model": {
            "primary": "zhipu/glm-4.5-air"
          },
          "models": {
            "zhipu/glm-4.7-flash": {
              "alias": "GLM-4.5-Air"
            }
          },
          "workspace": "你的工作路径",
          "compaction": {
            "mode": "safeguard"
          },
          "maxConcurrent": 4,
          "subagents": {
            "maxConcurrent": 8
          }
        }
      }

第四步：启动使用

命令行界面模式

# 启动命令行界面
openclaw tui

Web界面模式

# 启动Web界面
openclaw dashboard

推荐安装的 Skills

核心工具安装完毕后，这三款官方技能值得优先体验，它们能显著扩展OpenClaw的能力边界。

1. Code 编程技能

用途：集成高效的代码编写、调试与测试功能

openclaw skills install code

2. Beautiful-Mermaid 图表技能

用途：生成Mermaid格式图表，支持渲染展示

openclaw skills install beautiful-mermaid

3. Find-Skills 技能发现助手

用途：帮助发现并安装更多可用技能

openclaw skills install find-skills

高频命令速查

会话管理

# 列出所有活跃会话
openclaw sessions list
# 删除指定会话
openclaw sessions delete --name "项目名称"

文件操作

# 读取文件内容
openclaw read --path "C:\项目路径\README.md"
# 写入文件内容
openclaw write --path "C:\项目路径\notes.txt" --content "笔记内容"

浏览器控制

# 打开指定网页
openclaw browser --action=open --url="https://github.com"
# 截取当前页面
openclaw browser --action=screenshot

更多资源

官方文档

• ???? 完整文档指南
• ???? 工具配置参考
• ???? 技能开发教程
• ???? 社区支持渠道

获取智谱AI API Key

0. 访问 智谱AI开放平台
1. 注册账号并创建API Key
2. 将Key填入配置文件对应字段

快速帮助入口

# 查看命令帮助信息
openclaw --help
# 检查服务运行状态
openclaw gateway status
# 查看当前版本号
openclaw --version

总结

从环境搭建到模型对接，再到命令实操与技能扩展，本流程覆盖了日常开发中的高频应用场景。实际部署后，你会发现OpenClaw真正的优势在于其可灵活扩展的生态体系——深入掌握Skills模块，是最大化生产效率的核心。