OpenClaw windows安装菜鸟小白保姆教程

OpenClaw小白菜鸟教程

Defry

937人浏览 · 2026-03-07 15:55:28

Defry · 2026-03-07 15:55:28 发布

安装之路有多种，坑也有，最好是新系统；实在装不上可以安装openclaw-cn

下载安装git

https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.1/Git-2.53.0-64-bit.exe

安装 nvm for Windows

Windows 用户到 GitHub Releases 下载 nvm-setup.exe：https://github.com/coreybutler/nvm-windows/releases

安装NodeJs

第一种方法

https://nodejs.org/zh-cn/download

下载后一路next

第二种方法

用 管理员权限【最好，免得权限问题】打开 PowerShell：

# 安装指令

nvm install 22

# 使用指令【应该不需要】

nvm use 22.22.0

验证nodejs是否安装成功

安装 + 配置 OpenClaw

一键安装（PowerShell）

在 管理员 PowerShell 中运行：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果遇到执行策略报错（常见于首次运行脚本），在 PowerShell 运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

一直不动的话就按一下Enter键

正常情况安装完就直接进入初始化配置了，但是我的就卡住了；

如果不小心关闭了 PowerShell，重新打开后执行：

openclaw onboard --flow quickstart

有风险提示的话：就允许

I understand this is powerful and inherently risky. Continue?

yes

选择模型

我用的deepseek 所以选的openai 根据提示输入【没有就去对应平台申请开通下】

https://platform.deepseek.com/api_keys

OpenClaw 提供了交互式的 onboard 命令来配置服务商。

启动配置引导：

在终端执行以下命令进入配置向导：

openclaw onboard
选择提供商 (Provider)：

当询问“选择模型提供商”时，如果列表没有直接显示 DeepSeek，请选择 OpenAI 或 Custom (OpenAI Compatible)。
填入关键参数：
- API Key: 填入你刚才获取的 sk-xxx。
- Base URL: 填入 https://api.deepseek.com (注意末尾不要加 /v1)。
- Model Name: 填入 deepseek-chat【聊天】 或 deepseek-reasoner【推理】。

技术解释：由于 DeepSeek 接口格式符合 OpenAI 标准，OpenClaw 会通过 /v1/chat/completions 路径自动完成握手。

其他的配置skill什么的就先跳过，后面再配置

安装启动网关后，它会自动新开一个 PowerShell 窗口，都不要关闭。

启动服务： openclaw gateway start

浏览器会自动打开控制台。后续你也可以直接访问：http://127.0.0.1:18789/

这里你就可以正常在网页版使用了

配置连接飞书

飞书开放平台

自己本地可以先把飞书客户端打开登录上去

创建应用

进入飞书开放平台： https://open.feishu.cn/，创建一个应用，并添加机器人应用能力。

然后把 App ID 和 App Secret 复制出来备用，把这两项提供给 OpenClaw ，让它完成配置：

批量导入权限

这段贴进去

{
"scopes": {
"tenant": [
"im:message",
"im:message:send_as_bot",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:chat:readonly",
"contact:user.base:readonly"
]
}
}

安装飞书插件

PowerShell中执行：【有的让直接在OpenClaw聊天框中让自动执行需要同条件支撑】

openclaw plugins install @m1heng-clawd/feishu

‌确认飞书插件已正确安装并启用

openclaw plugins list

若 feishu 显示为 disabled，强制启用：

openclaw plugins enable feishu

启用长连接模式（无需公网 IP）【不用纠结外网啥的】

openclaw config set channels.feishu.useLongPolling true
openclaw config set channels.feishu.reconnect true

配置飞书相关参数

# 设置 App ID (请替换成你自己的)

openclaw config set channels.feishu.appId "你的_App_ID【你创建飞书应用那一步的】"

# 设置 App Secret (请替换成你自己的)

openclaw config set channels.feishu.appSecret "你的_App_Secret【你创建飞书应用那一步的】"

# 启用飞书通道

openclaw config set channels.feishu.enabled true

# 设置飞书为中国版

openclaw config set channels.feishu.domain "feishu"

# 设置连接模式为长连接 (websocket)

openclaw config set channels.feishu.connectionMode "websocket"

使用 channels add 命令交互式配置【后面没法用再执行试试】

openclaw channels add feishu main

【仅了解】配置后：C:\Users\你自己\.openclaw 的openclaw.json能看到

事件与回调

这里报红一直连不上的话就执行下下面两行代码：再重启网关试下

openclaw config set channels.feishu.useLongPolling true
openclaw config set channels.feishu.reconnect true

添加接收消息事件

在「事件配置」页面点击「添加事件」，搜索并添加：

im.message.receive_v1

不添加这个事件，机器人就无法收到你的消息。

发布版本

1.0.0

系统自动审核快的很

配对

【在飞书客户端中搜索创建的应用名称然后发送消息】：

openclaw pairing approve feishu 飞书中返回的配对码

应该差不多就可以用了，每个人环境配置不一样，有小问题多问度娘和deepseek,常见问题一般都能查到，不会@me

常用命令

网关启动：openclaw gateway start
重启网关：openclaw gateway restart

启动不了的话：openclaw gateway run

快速启动配置向导：openclaw onboard --flow quickstart

验证网关状态：openclaw gateway status

# 重置/更改 API 等配置 openclaw config

# 诊断检查 openclaw doctor

# 实时查看日志（强烈推荐：出 bug 基本都靠它定位） openclaw logs follow

配置文件地址：openclaw config path

查看已安装插件：openclaw plugins list

查看技能列表：openclaw skills list

运行官方诊断工具：在 PowerShell 中执行以下命令，它会自动检查并修复常见的环境变量、权限和依赖问题。

openclaw doctor --fix

/new（新建）：完全清空所有历史对话，从零开始。适合切换任务 不影响你已保存的长期记忆

/compact（压缩）：将旧的对话内容智能总结成一段摘要，并保留最近的消息。这样既节省了Token，又没有完全丢失前因后果，适合延续当前的长任务

/help 或 /commands 查看当前环境支持的所有命令列表

# 启用记忆自动压缩，减少Token消耗 openclaw config set agents.defaults.memory.compression.enable true --json openclaw config set agents.defaults.memory.compression.threshold 5000 --json