OpenClaw

1.安装教程视频版

---- 《OpenClaw小龙虾保姆级安装教程！小白10分钟搞定本地部署【Windows系统 + 接入飞书】》

2.安装教程文字版

前置准备（必看）系统：Windows 10 / Windows 11 64 位临时关闭：360、火绒、Windows Defender 实时防护（防止拦截安装）所有安装路径必须纯英文，不能有中文、空格全程使用管理员身份打开 PowerShell

步骤 1：手动安装 Node.js（运行核心环境）

1.1 下载安装包官网下载：https://nodejs.org/zh-cn/download/ 选择：长期支持版 (LTS) 64 位 Windows (.msi)（推荐 22.x 版本）双击安装包，全程默认下一步，务必勾选 Add to PATH（添加环境变量），默认安装 C 盘即可

1.2 验证 Node.js 安装成功关闭所有旧 PowerShell 窗口，重新以管理员身份打开 PowerShell 依次输入以下两条命令，每条输完按回车 powershell node —version npm —version ✅ 成功标准 node 输出：v22.x.x（22 开头版本） npm 输出：10.x.x 左右版本号

步骤 2：手动安装 Git（可选，用于拉取代码）

2.1 下载安装官网下载：https://git-scm.com/download/win 下载 64 位安装包，全程默认下一步安装

2.2 验证 Git 安装成功管理员 PowerShell 输入命令，回车 powershell git —version ✅ 成功标准：输出 git version 2.4x.x 版本号

步骤 3：设置国内 npm 镜像（解决下载慢、失败）

管理员 PowerShell 依次复制下面 2 条命令，回车执行 powershell npm config set registry https://registry.npmmirror.com npm config get registry ✅ 成功标准：输出 https://registry.npmmirror.com

步骤 4：全局手动安装 OpenClaw（小龙虾本体）

4.1 执行安装命令管理员 PowerShell 输入，回车（等待 2–5 分钟） powershell npm install -g openclaw@latest

4.2 验证 OpenClaw 安装成功再次关闭旧窗口，新开管理员 PowerShell，输入 powershell openclaw —version ✅ 成功标准：输出版本号（如 v2026.x.x）

步骤 5：启动 OpenClaw + 访问网页控制面板

5.1 首次初始化（必须做）管理员 PowerShell 输入，回车 powershell openclaw onboard —install-daemon 按提示回车，选择本地网关，填入你的 AI 密钥（DeepSeek / Kimi / 通义千问均可）

5.2 启动网关服务 powershell openclaw gateway start ✅ 成功标准：出现 Gateway listening on http://127.0.0.1:18789

5.3 访问 Web 控制台

方式 1：一键自动打开浏览器（小白首选） powershell openclaw dashboard

方式 2：手动浏览器访问打开任意浏览器，输入地址： plaintext http://127.0.0.1:18789 小白每步验证核对清单（可直接对照） Node.js：node —version → v22.x ✔ Git：git —version → 输出版本 ✔ npm 镜像：npm config get registry → 国内镜像 ✔ OpenClaw 本体：openclaw —version → 输出版本 ✔ 网关启动：openclaw gateway start → 监听 18789 端口 ✔ 网页访问：http://127.0.0.1:18789 正常打开 ✔

官方版本配置

编辑配置文件：

vim ~/.openclaw/openclaw.json

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "DeepSeek-V3.1"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "gptgod": {
        "baseUrl": "https://www.zeroopc.com/v1",
        "apiKey": "申请的 api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "DeepSeek-V3.1",
            "name": "DeepSeek-V3.1"
          }
        ]
      }
    }
  }
}

参数	说明
provider	自定义标识（如 my‑zeroopc）
base_url	https://www.zeroopc.com/v1
api	openai‑completions
api_key	从后台获取（ https://doc.zeroopc.com/zh/home/guide/api‑token ）
model.id	参考 https://www.zeroopc.com/pricing 填入
model.name	同上