乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenCLaw windows 完整安装教程(含环境配置、报错问题解决,超详细保姆级小学生教程)养龙虾

OpenCLaw windows 完整安装教程(含环境配置、报错问题解决,超详细保姆级小学生教程)养龙虾

当前时间： 2026-03-12 15:45:34 分类：办公文件 评论(0)
OpenCLaw windows 完整安装教程(含环境配置、报错问题解决,超详细保姆级小学生教程)养龙虾

一：前置环境准备

安装 Node.js

OpenCLaw 基于 Node.js 运行，需要安装 Node.js 18 或更高版本。

# nodejs官网下载地址https://nodejs.org/zh-cn/download

安装git

# git下载地址https://git-scm.cn/

PS：一路默认安装即可

安装wsl2

wsl --install
解决wsl --install报错：
# win10更新系统到最新版本，然后再尝试安装wsl --set-default-version 2wsl --install -d Ubuntu
如果还不能解决的话请手动下载安装
# 手动安装WSL2 ubuntu# WSL2 ubuntu下载地址https://releases.ubuntu.com/24.04.4/ubuntu-24.04.4-wsl-amd64.wsl
设置用户名和密码
解决node命令报错：

你在运行 npm -v 时遇到的这个错误，是 Windows 系统为了保护安全而禁止运行 PowerShell 脚本（比如 npm.ps1）导致的。这是 PowerShell 的执行策略在起作用，并不是 npm 本身安装失败或损坏。

解决这个问题不需要复杂的操作，你可以按照以下步骤轻松修复：

操作步骤如下：

  1. 以管理员身份打开 PowerShell：

    • 点击 Windows 开始菜单，搜索 PowerShell。

    • 在结果中右键点击 Windows PowerShell，选择 “以管理员身份运行”。

  2. 输入并运行命令：

    • 在打开的 PowerShell 窗口中，复制并粘贴以下命令，然后按回车：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

二：安装OpenClaw

安装openclaw:

curl -fsSL https://openclaw.ai/install.sh | bash

 安全警告阅读与确认

  • 启动后首先会看到安全警告：

    • OpenCLaw 默认是个人使用，仅限单一可信用户。

    • 若开启工具权限（如读写文件、执行命令），需防范恶意提示词攻击。

    • 若要让多人使用，必须进行安全加固（如白名单、隔离会话、最小权限等）。

  • 阅读后选择：Yes 表示理解并继续。

选择安装模式

  • 选择：Manual（手动配置）

  • 安装目标：Local gateway (this machine)

设置工作目录

  • 默认路径：/home/openclaw/.openclaw/workspace█

  • 可接受默认值，直接下一步。

选择模型/认证提供商

  • 选择：Qwen（通义千问），使用 OAuth 认证。

  • 系统会提示你打开浏览器访问：

 https://chat.qwen.ai/authorize?user_code=XXXXXDDDT&client=qwen-code
  • 输入显示的授权码 AAFFABZL完成 OAuth 认证

认证成功后，默认模型设置为：qwen-portal/coder-model

配置网关

  • Gateway port：9999

  • Gateway bind：选择 LAN (0.0.0.0)，允许局域网访问

  • Gateway auth：选择 Token 认证

  • Tailscale exposure：选择 off，暂不启用 Tailscale

设置网关 Token

  • 选择：Generate/store plaintext token

  • 系统会自动生成一个 Token，用于后续多机或非本地访问认证。请妥善保存此 Token。

    选择消息通道（Channel）

    • 选择你想要接入的平台，例如飞书：Feishu/Lark（👩‍💻）

    • 系统会提示安装 Feishu 插件，选择使用本地路径。

      配置飞书（Feishu）凭证

      • App Secret

      • App ID

      1. 前往 飞书开放平台 创建自建应用

        https://open.feishu.cn/?lang=zh-CN

      2. 获取 App ID 和 App Secret

      3. 在 OpenCLaw 中依次输入：

      4. 系统会自动测试连接，显示：

        Connected as ou_xxx

        飞书应用权限配置：在飞书开放平台的应用中，需要开启以下权限：

        设置飞书连接选项

        • 连接模式：websocket (default)

        • 飞书域名：选择 Feishu (feishu.cn) - china

        • 群聊策略：选择 Allowlist-only（仅允许特定群聊）

        • 群聊白名单：输入允许响应的群 ID（如 oc_xxxxx, oc_yyyyy）

        • im:message

        • im:chat

        • contact:user.base:readonly

Device Management (DM) 设备管理访问策略的配置

❓ 常见问题排查

1. Node.js 版本问题

# 检查版本node--version # 需要 18+

2. 端口占用

# 检查 9001 端口netstat-tlnp|grep 9999# 修改配置文件中的端口

3. 飞书连接失败

  • 确认 App ID 和 Secret 正确

  • 确认应用已发布或添加到测试组

  • 检查网络是否能访问飞书 API