OpenClaw 安装配置指南（Windows）

老汉的微笑

224人浏览 · 2026-09-22 10:04:19

老汉的微笑 · 2026-09-22 10:04:19 发布

1. 系统要求说明

项目	要求
操作系统	Windows 10/11（64位）
Node.js	22+ 版本
内存	建议 8GB 以上
磁盘	至少 2GB 可用空间

关于 WSL2

WSL2 (Windows Subsystem for Linux 2) 是 Windows 内置的 Linux 子系统。 openclaw官方推荐windows上用WSL2安装，这里建议技术人员可以使用此环境，非技术人员不建议折腾此环境。

2.基础环境安装

2.1 Node.js

用途：JavaScript 运行环境

下载地址：Node.js — Run JavaScript Everywhere

安装步骤：

下载 LTS 版本ZIP压缩包（长期支持版，当前为 22.x）
将压缩包解压到磁盘目录
将nodejs目录添加到系统环境变量PATH
完成安装

验证安装：

node -v
npm -v

3. OpenClaw安装步骤

方式一：安装脚本（推荐）

以管理员身份打开 PowerShell，执行：

# 设置执行策略（允许运行脚本）
# Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 运行安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动：

检测 Node.js（如未安装会提示）
安装 OpenClaw CLI
启动配置向导

方式二：手动安装

# 设置执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 安装 OpenClaw
npm install -g openclaw@latest

# 如果碰到网络超时下载中断或失败，你可以试着配置 NPM 的国内镜像（防止网络超时，如果在国外则不用），执行以下命令
# npm config set registry https://registry.npmmirror.com

运行配置向导

openclaw onboard --install-daemon

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

向导会引导你：

选择聊天渠道（飞书/Telegram/WhatsApp 等）
配置模型提供商（智谱/OpenAI/Anthropic 等）
安装 Gateway Windows 服务

4. 基础配置

配置文件位置：C:\Users\{用户名}\.openclaw\openclaw.json

4.1 配置文件结构

{
  "models": {
    "providers": {
      "zhipu": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4/",
        "apiKey": "your-zhipu-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "glm-4.6v", "name": "GLM-4.6V" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "zhipu/glm-5",
      "imageModel": "zhipu/glm-4.6v",
      "workspace": "E:\\openclaw\\coder_workspace"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket"
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "your-gateway-token"
    }
  }
}

4.2 模型提供商配置示例

智谱 GLM：

{
  "models": {
    "providers": {
      "zhipu": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4/",
        "apiKey": "your-zhipu-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "glm-4.6v", "name": "GLM-4.6V" },
          { "id": "glm-4.7", "name": "GLM-4.7" }
        ]
      }
    }
  }
}

DeepSeek：

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "your-deepseek-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-chat", "name": "DeepSeek Chat" },
          { "id": "deepseek-coder", "name": "DeepSeek Coder" }
        ]
      }
    }
  }
}

OpenAI：

{
  providers: {
    models: [
      {
        id: "openai",
        provider: "openai",
        apiKey: "your-openai-api-key",
      },
    ],
  },
}

5. 飞书

5.1 创建飞书应用

步骤 1：访问飞书开放平台

访问开发者后台 - 飞书开放平台并登录

国际版 Lark 用户访问 Lark 开放平台

步骤 2：创建企业自建应用

点击「创建企业自建应用」
填写应用名称和描述
选择应用图标

步骤 3：获取凭证

在「凭证与基础信息」页面复制：

App ID（格式：cli_xxx）
App Secret

步骤 4：配置权限

在「权限管理」页面，点击「批量导入」，粘贴以下权限配置：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

步骤 5：启用机器人能力

在「应用能力」→「机器人」页面：

启用机器人能力
设置机器人名称

步骤 6：配置事件订阅

⚠️ 重要：先确保 Gateway 已启动

在「事件订阅」页面：

选择「使用长连接接收事件」（WebSocket 模式）
添加事件：im.message.receive_v1

步骤 7：发布应用

在「版本管理与发布」创建版本
提交审核并发布
等待管理员审批（企业应用通常自动通过）

5.2 OpenClaw 配置

⚠️ 重要：配置openclaw后执行5.1的《步骤 6：配置事件订阅》,然后飞书搜索机器人发送测试消息，首次需要在openclaw网关进行审批，

方式一：命令行配置

openclaw channels add

选择 Feishu，输入 App ID 和 App Secret。

方式二：编辑配置文件

编辑 C:\Users\{用户名}\.openclaw\openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket"
    }
  }
}

配置项说明：

字段	说明
`enabled`	是否启用
`appId`	飞书应用 App ID
`appSecret`	飞书应用 App Secret
`connectionMode`	连接模式：`websocket`（推荐）或 `webhook`

国际版 Lark 配置

如果使用国际版 Lark，添加 domain 配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket",
      "domain": "lark"
    }
  }
}

5.3 群聊配置（可选）

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket",
      "groupPolicy": "open",
      "groupAllowFrom": ["oc_xxx", "oc_yyy"]
    }
  }
}

群聊策略（groupPolicy）：

值	说明
`open`	允许所有群（默认）
`allowlist`	仅允许 `groupAllowFrom` 中的群
`disabled`	禁用群聊

### 5.4 私聊配对

默认私聊需要配对才能使用：

1. 在飞书中给机器人发送消息
2. 机器人会返回一个配对码
3. 批准配对：

```powershell
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

5.4 获取群/用户 ID

群 ID（格式：oc_xxx）：

在群里 @机器人
查看日志：openclaw logs --follow
在日志中找 chat_id

用户 ID（格式：ou_xxx）：

私聊机器人
查看日志：openclaw logs --follow
在日志中找 open_id

5.5 测试与配对使用

1、在飞书搜索你的机器人，发起单聊或拉进群。机器人会回复一段配对码（如 PAIR-ABC123）

2、在终端审批配对（仅首次 DM 需要）

openclaw pairing list feishu          # 查看待审批openclaw pairing approve feishu PAIR-ABC123

6. 钉钉

目前OpenClaw官方并未支持钉钉，钉钉插件由钉钉官方提供。

钉钉开发者平台添加了OpenClaw的各种能力集成；详情点击入口

6.1 钉钉配置

⚠️ 重要：在权限管理添加Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg

详细配置参考钉钉文档说明

6.2 OpenClaw安装钉钉插件

详细配置参考OpenClaw集成钉钉说明

首先安装钉钉官方插件，输入以下命令直接运行 OpenClaw 插件安装命令，OpenClaw 会自动处理下载、安装依赖和注册。

openclaw plugins install @dingtalk-real-ai/dingtalk-connector

深度集成MCP AI技能

访问钉钉官网介绍：入口

常用命令

Gateway 管理

命令	说明
`openclaw gateway status`	查看 Gateway 状态
`openclaw gateway start`	启动 Gateway 服务
`openclaw gateway stop`	停止 Gateway 服务
`openclaw gateway restart`	重启 Gateway 服务
`openclaw gateway install`	安装 Gateway 服务
`openclaw gateway --port 18789`	指定端口启动
`openclaw logs --follow`	查看实时日志

渠道管理

命令	说明
`openclaw channels add`	添加新渠道
`openclaw channels login`	渠道登录（如 WhatsApp 扫码）

配对管理

命令	说明
`openclaw pairing list <channel>`	查看待批准配对
`openclaw pairing approve <channel> <CODE>`	批准配对

系统命令

命令	说明
`openclaw --version`	查看版本
`openclaw status`	查看系统状态
`openclaw doctor`	诊断配置问题
`openclaw dashboard`	打开 Web 控制台

聊天命令（发送给机器人）

命令	说明
`/status`	查看会话状态
`/reset`	重置会话
`/model`	查看/切换模型

技能名称	技能简介	安装命令
Clawsec	安全防护第一道防线，扫描Skill代码检测权限、网络请求、代码混淆等风险，给出SAFE/CAUTION/DANGEROUS评级	`npx clawhub@latest install -g clawsec`
Multi Search Engine	集成17个搜索引擎（8国内+9国际），无需API Key，智能分流、结果去重，支持站内搜索和文件类型搜索	`npx clawhub@latest install multi-search-engine`
Self-Improving Agent	让AI记住错误、学习经验、响应用户纠正，自动写入`.learnings/`目录，越用越聪明	`npx clawhub@latest install self-improving-agent`
Proactive Agent	从被动响应到主动服务，心跳机制每15分钟唤醒，生成7个配置文件定义Agent行为准则	`npx clawhub@latest install proactive-agent`
Ontology	构建结构化知识图谱，从对话中抽取实体、建立关系、标注类型，跨对话记住用户偏好	`npx clawhub@latest install ontology`
Find-Skills	元Skill，帮你搜索ClawHub上11600+个Skills，根据需求描述推荐最合适的技能	`npx clawhub@latest install find-skills`
GitHub	用自然语言管理GitHub仓库，搜索项目、管理Issues、代码审查、生成进展报告	`npx clawhub@latest install github`
Office Document Specialist Suite	用于创建、编辑和分析 Microsoft Office 文档（Word、Excel、PowerPoint）的高级套件	`npx clawhub@latest install Office Document Specialist Suite`
Systematic-Debugging	强制执行5步结构化调试流程：问题定义→信息收集→假设生成→测试验证→修复实施	`npx clawhub@latest install systematic-debugging`
news-summary	从可信的国际RSS源获取新闻，并可生成语音摘要
Tavily Web Search	通过 Tavily API 实现 AI 优化的网络搜索。为 AI 代理返回简洁、相关的搜索结果。`TAVILY_API_KEY`来自https://tavily.com的需求
Nano Pdf	使用 nano-pdf CLI 通过自然语言指令编辑 PDF

附录 A：安装文件清单

安装openclaw或后续其他技能时，可能需要以下文件：

文件	下载地址	说明
vs_BuildTools.exe	Microsoft C++ Build Tools - Visual Studio	C++ 编译器
cmake-x.x.x-windows-x86_64.msi	Download CMake	构建工具

参考链接

官方文档：OpenClaw Docs
GitHub：GitHub - openclaw/openclaw: The AI that really does things. Any OS. Any Platform. The lobster way. 🦞 · GitHub
社区：https://discord.com/invite/clawd
技能市场：ClawHub
飞书开放平台：飞书开放平台
钉钉开发者平台：开发者后台统一登录 - 钉钉统一身份认证

DAMO开发者矩阵

DAMO开发者矩阵，由阿里巴巴达摩院和中国互联网协会联合发起，致力于探讨最前沿的技术趋势与应用成果，搭建高质量的交流与分享平台，推动技术创新与产业应用链接，围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐

光感日常，电懂人心：消费电子与生活的光电融合

DAMO开发者矩阵

网页数字字母图形验证码怎么做

DAMO开发者矩阵

山东工厂西门子6RA直流调速器频繁跳闸？6RA24/6RA70/6RA80五大报警代码故障定位维修指南

维修品类覆盖大功率进口变频器、高压变频器、直流调速器、大功率伺服驱动器、伺服电机、进口触摸屏、功率单元、软启动器、工业机器人，并可承接空压机变频器控制系统维修。跳闸报警时，不同系列的代码体系并不完全相同：6RA24与6RA70采用一致的F0xx代码，6RA80改为F60xxx代码，6RA23/6RA28/6RA27则是更早的代码体系。缺相 F004（电枢缺相） F60004（电枢缺相）、F6000

DAMO开发者矩阵

所有评论(0)

查看更多评论

老汉的微笑

@qi_dabin

已为社区贡献1条内容

OpenClaw 安装配置指南（Windows）

老汉的微笑

1. 系统要求说明

关于 WSL2

2.基础环境安装

2.1 Node.js

3. OpenClaw安装步骤

方式一：安装脚本（推荐）

方式二：手动安装

运行配置向导

4. 基础配置

4.1 配置文件结构

4.2 模型提供商配置示例

5. 飞书

5.1 创建飞书应用

步骤 1：访问飞书开放平台

步骤 2：创建企业自建应用

步骤 3：获取凭证

步骤 4：配置权限

步骤 5：启用机器人能力

步骤 6：配置事件订阅

步骤 7：发布应用

5.2 OpenClaw 配置

方式一：命令行配置

方式二：编辑配置文件

国际版 Lark 配置

5.3 群聊配置（可选）

5.4 获取群/用户 ID

5.5 测试与配对使用

6. 钉钉

6.1 钉钉配置

6.2 OpenClaw安装钉钉插件

深度集成MCP AI技能

常用命令

Gateway 管理

渠道管理

配对管理

系统命令

聊天命令（发送给机器人）

推荐skills

附录 A：安装文件清单

参考链接

所有评论(0)

温馨提示：您尚未绑定手机号

老汉的微笑