openclaw window安装转载知乎代码小郭

第一步：创建工作区目录

首先在 D 盘创建 OpenClaw 的工作区目录：

#手动或者通过mkdir命令都可以
mkdir D:\software\openclaw\workspace

💡 重要：这个目录是用户自定义的 OpenClaw 的工作空间，指定后会自动在这里存储数据。

第二步：配置环境变量（重要！）

在安装 OpenClaw 之前，必须先配置好环境变量。这样可以确保 OpenClaw 能按用户指定的目录生成相关的配置文件和数据目录。建议显示指定，否则默认安装在C盘！

2.1 打开系统环境变量设置

按 Win + R 键，输入 sysdm.cpl 并回车
点击高级选项卡
点击环境变量按钮

2.2 添加用户环境变量

在用户变量区域点击新建，添加以下四个环境变量：

变量 1：OPENCLAW_HOME

项	值
变量名	OPENCLAW_HOME
变量值	D:\software\openclaw

变量 2：OPENCLAW_WORKSPACE

项	值
变量名	OPENCLAW_WORKSPACE
变量值	D:\software\openclaw\workspace

变量 3：OPENCLAW_CONFIG_PATH

项	值
变量名	OPENCLAW_CONFIG_PATH
变量值	D:\software\openclaw\openclaw.json

变量 4：OPENCLAW_STATE_DIR

项	值
变量名	OPENCLAW_STATE_DIR
变量值	D:\software\openclaw

注意：所有环境变量的值按你自己喜好来定

2.3 验证环境变量

点击确定保存所有设置。

关闭并重新打开 Git Bash，验证环境变量是否生效：

echo $OPENCLAW_HOME
echo $OPENCLAW_WORKSPACE
echo $OPENCLAW_CONFIG_PATH
echo $OPENCLAW_STATE_DIR

应该显示刚才设置的路径。

⚠️ 注意：如果环境变量没有生效，请重启电脑后再试。

第三步：安装 OpenClaw

3.1 执行安装命令

在 Git Bash 或 PowerShell 中执行：

npm install -g openclaw

第四步：运行配置向导

使用 openclaw onboard 命令启动交互式配置向导：

openclaw onboard --workspace D:\software\openclaw\workspace --install-daemon

💡 参数说明：

--workspace: 指定工作空间目录 (如果配置好了环境变量就无需指定这个参数了)
--install-daemon: 安装为系统服务

4.1 配置步骤 1：确认安装

向导启动后，第一个配置界面默认选择 Yes，直接按回车继续。

4.2 配置步骤 2：选择配置模式

选择 QuickStart 快速开始模式，按回车继续。

4.3 配置步骤 3：选择 AI 模型

选择底层 AI 模型。你可以选择：

Anthropic Claude
OpenAI GPT
智谱 GLM (推荐国内用户)

我这里选了智谱的模型，选择后按回车继续。

4.4 配置步骤 4：配置 API Key

输入你的 API Key。

如果选择智谱，使用智谱 Coding Plan 的 API Key（我这里是国内版）

蹲队友拼智谱 Coding Plan！
国内顶流编程大模型，20+主流工具全适配，性价比拉满
立即参与「拼好模」：点此购买限时优惠

如果选择 Claude，使用 Anthropic 的 API Key

输入后按回车继续。

4.5 配置步骤 5：选择聊天平台

选择一个聊天平台。国内推荐选择飞书。

按回车后，系统可能会提示下载飞书插件，确认下载即可。

4.6 配置步骤 6：配置飞书应用

📝 创建密钥：需要在飞书开放平台创建应用来获取这些密钥。

配置飞书应用的 App Secret 和 App ID。

配置完成后继续按回车。

4.7 配置步骤 7：Web 搜索（可选）

这一步可以先跳过，选择 Skip now，按回车继续。

4.8 配置步骤 8：配置 Skills（可选）

配置可选的技能插件，根据需要选择或跳过。

4.9 配置步骤 9：其他 API 配置（可选）

其他可选的 API 配置，可以选择 No 都跳过，按回车继续。

4.10 配置步骤 10：配置Hooks(钩子)

这里我默认都选中，继续按回车完成剩余配置步骤。

4.11 配置步骤 11：网关配置

第五步：验证安装

5.1 检查版本

openclaw --version

5.2 打开桌面网页访问

先找到桌面网页访问的地址一般默认是127.0.0.1:18789, 端口如果在配置时修改过，找到openclaw工作目录下的openclaw.json文件中查看gateway配置即可：

"port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "XXXXXXX"
    },

浏览器访问127.0.0.1:18789 默认会出现一个登录页面，我们只需要在网关令牌输入框填入5.2中配置文件的token的值，然后点击登录即可：

直接在网页中给 OpenClaw 发送消息测试。

第六步：飞书配对

6.1 打开飞书

在飞书中找到对应的应用。

6.2 发送测试消息

打开手机飞书，搜索应用（配置步骤6中创建的应用名称），在飞书聊天窗口发送任意文字，获取配对代码。

6.3 完成配对

根据手机飞书回复的向导提示，在电脑桌面cmd命令行输入配对代码，完成配对：

6.4 验证是否配对成功

回到手机飞书聊天窗口，发送任意文字，如果有回复就代表配对成功：

常见问题

Q1: 环境变量设置后不生效？

解决：

确认环境变量名称拼写正确
关闭所有 Git Bash 和 PowerShell 窗口
重新打开 Git Bash
使用 echo $OPENCLAW_HOME 验证
如果还不行，重启电脑

Q2: 环境变量一定要设置吗？

强烈建议设置。虽然 OpenClaw 有默认配置，但设置环境变量可以：

明确数据存储位置
方便备份和迁移
避免配置文件分散

Q3: Node.js 版本不够怎么办？

升级到 Node.js 22 或更高版本：

访问 https://nodejs.org/
下载 LTS 版本安装

Q4: 工作空间目录必须指定吗？

不是必须的，但强烈建议指定。这样可以更好地管理 OpenClaw 的数据。

Q5: 如何获取智谱 API Key？

访问 https://www.bigmodel.cn/glm-coding?ic=CNEW3EQAJF
注册/登录账号
开通 GLM Coding Plan
创建 API Key

Q6: 飞书应用如何创建？

访问飞书开放平台
创建企业自建应用
获取 App ID 和 App Secret
配置权限和事件订阅

Q7: 如何完全卸载？

参考：OpenClaw 如何彻底卸载

总结

完整安装流程：

# 1. 创建工作区
mkdir D:\software\openclaw\workspace

# 2. 配置环境变量
# OPENCLAW_HOME = D:\software\openclaw
# OPENCLAW_WORKSPACE = D:\software\openclaw\workspace
# OPENCLAW_CONFIG_PATH = D:\software\openclaw\config
# OPENCLAW_STATE_DIR = D:\software\openclaw\state

# 3. 安装 OpenClaw
npm install -g openclaw

# 4. 运行配置向导（指定工作区）
openclaw onboard --workspace D:\software\openclaw\workspace --install-daemon

# 5. 验证安装
openclaw --version

# 6.飞书配对

一、在飞书开放平台创建应用并获取凭证

1、访问【飞书开放平台】，使用企业账号登录；
2、点击【创建企业自建应用】，填写应用名称（如：AI助手），点击确认。

3、进入应用后，在左侧菜单【凭证与基础信息】中，记录App ID和App Secret（这两个值稍后要在OpenClaw中配置）

4、在左侧菜单点击【添加应用能力】，找到【机器人】，点击【添加】；

二、在飞书开放平台配置权限和事件

1、配置权限

①、点击左侧菜单【权限管理】；
②、点击【添加权限】，搜索并添加以下权限：
im:message
im:message.p2p_msg:readonly
im:message.group_at_msg:readonly
im:message:send_as_bot
contact:user.base:readonly

2、配置事件订阅

①、点击左侧菜单【事件与回调】；
②、在【订阅方式】中，选择使用长连接接收事件，点击保存；

③、点击【添加事件】，搜索并勾选 im.message.receive_v1，确认添加。

3、发布应用

①、点击左侧菜单【版本管理与发布】；

②、点击【创建版本】，填写版本号（如 1.0.0），提交审核发布；
企业内部应用通常很快通过审核，请等待发布完成后再继续下一步。

三、在OpenClaw中安装飞书插件并配置凭证

1、安装插件

OpenClaw部署助手（官方版）

一键本地部署OpenClaw，真正能干活的AI Agent

好评率97%

下载次数：3153478

连接到安装OpenClaw的服务器，执行：
npx -y @larksuite/openclaw-lark install

2、配置 App ID 和 App Secret

方法一：使用命令行配置（推荐）

openclaw config set channels.feishu.appId "你的App ID"
openclaw config set channels.feishu.appSecret "你的App Secret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket

方法二：直接编辑配置文件

编辑 ~/.openclaw/openclaw.json，在 channels 中添加：
"channels": {
"feishu": {
    "enabled": true,
    "appId": "你的App ID",
    "appSecret": "你的App Secret",
    "connectionMode": "websocket"
}
}

3、重启OpenClaw服务

openclaw gateway restart

四、触发配对码

1、打开飞书客户端（桌面端或移动端）
2、搜索你创建的机器人名称（如：AI助手）
3、进入聊天窗口，发送任意消息，例如：Hello

4、机器人会自动回复一条消息，其中包含一个配对码（例如：123456）

五、在OpenClaw中完成配对

回到OpenClaw服务器终端，执行：
openclaw pairing approve feishu 123456
（将123456替换为机器人实际回复的配对码）
看到“✔”配对成功提示后，配对完成。

六、验证

再次向飞书机器人发送消息，例如：你好，机器人应能正常回复。如果回复正常，说明绑定成功。

常用命令参考：

操作	命令
安装插件	npx -y @larksuite/openclaw-lark install
配置 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 gateway restart
批准配对	openclaw pairing approve feishu [配对码]
查看待配对列表	openclaw pairing list feishu
查看日志	openclaw logs --follow

常见问题

Q1：机器人收不到我发的消息？

A：请检查：
①、飞书应用是否已成功发布；
②、事件订阅是否选择了“长连接”；
③、是否已添加 im.message.receive_v1 事件；
④、权限中是否包含 im:message 相关权限。

Q2：配对时提示“没有待处理的配对请求”？

A：先执行openclaw pairing list feishu查看列表。如果为空，请重新向机器人发送一条消息触发新的配对码。

Q3：配置修改后不生效？

A：每次修改配置后都必须执行openclaw gateway restart重启服务。

Q4：App Secret 填错了怎么办？

A：重新执行openclaw config set channels.feishu.appSecret "正确的App Secret"，然后重启服务。

posted @ 2026-04-09 13:28 mrt_yy 阅读(338) 评论(0) 收藏举报

刷新页面返回顶部

mrt_yy

openclaw window安装 转载知乎代码小郭

第一步：创建工作区目录

第二步：配置环境变量（重要！）

2.1 打开系统环境变量设置

2.2 添加用户环境变量

2.3 验证环境变量

第三步：安装 OpenClaw

3.1 执行安装命令

第四步：运行配置向导

4.1 配置步骤 1：确认安装

4.2 配置步骤 2：选择配置模式

4.3 配置步骤 3：选择 AI 模型

4.4 配置步骤 4：配置 API Key

4.5 配置步骤 5：选择聊天平台

4.6 配置步骤 6：配置飞书应用

4.7 配置步骤 7：Web 搜索（可选）

4.8 配置步骤 8：配置 Skills（可选）

4.9 配置步骤 9：其他 API 配置（可选）

4.10 配置步骤 10：配置Hooks(钩子)

4.11 配置步骤 11：网关配置

第五步：验证安装

5.1 检查版本

5.2 打开桌面网页访问

第六步：飞书配对

6.1 打开飞书

6.2 发送测试消息

6.3 完成配对

6.4 验证是否配对成功

常见问题

Q1: 环境变量设置后不生效？

Q2: 环境变量一定要设置吗？

Q3: Node.js 版本不够怎么办？

Q4: 工作空间目录必须指定吗？

Q5: 如何获取智谱 API Key？

Q6: 飞书应用如何创建？

Q7: 如何完全卸载？

总结

一、在飞书开放平台创建应用并获取凭证

二、在飞书开放平台配置权限和事件

1、配置权限

2、配置事件订阅

3、发布应用

三、在OpenClaw中安装飞书插件并配置凭证

1、安装插件

2、配置 App ID 和 App Secret

方法一：使用命令行配置（推荐）

方法二：直接编辑配置文件

3、重启OpenClaw服务

四、触发配对码

五、在OpenClaw中完成配对

六、验证

常见问题

Q1：机器人收不到我发的消息？

Q2：配对时提示“没有待处理的配对请求”？

Q3：配置修改后不生效？

Q4：App Secret 填错了怎么办？

公告

openclaw window安装转载知乎代码小郭