OpenClaw Windows部署，并接入飞书教程

原创 2026-03-03 10:58:13 4k 阅读 AI写同款

DValc

679粉丝2篇原创

关注

OpenClaw（windows版）部署指南 **本地 LLM 模式**: ❌ 未启用（需重新安装以启用 `node-llama-cpp`）- **API 模式**: ✅ 可用（OpenAI、Anthropic、Ollama 远程等）- **Node.js 版本**: v22.13.1 (LTS)- **目标软件**: OpenClaw v2026.1.30。- **安装完成后必须重启 PowerShell**- **包管理器**: npm v10.9.4。```powershell（管理员打开）- **最后更新**: 2026-02-02。阅读详情

AI摘要

本文提供OpenClaw在Windows 10/11系统的完整部署流程，涵盖nvm/node/npm环境配置、Git安装、GitHub SSH密钥安全设置（解决私钥权限问题）、PowerShell执行策略调整；重点实现OpenClaw原生Windows环境下安装、网关启动及TUI/Dashboard访问；并详解飞书机器人应用创建、事件订阅（im.message.receive_v1）、App凭证注入与配对码绑定，完成多端（PC/手机）消息互通与本地控制能力。

OpenClaw（社区昵称“大龙虾”）凭借其强大的本地多 Agent 架构和高度可控性，近期在开发者圈迅速走红。然而，对于广大 Windows 用户而言，官方文档对原生环境的支持尚不完善，许多人在 Node.js 版本匹配、权限配置及依赖安装等环节频频受挫。
https://openclaw.ai/
本文基于最新的 Windows 10/11 环境，整理了一份全流程保姆级部署，以及接入飞书的全流程教程。

1.基本环境

1.1 nvm node npm

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

2.管理员权限打开 PowerShell

3.安装 node.js 22.22.0 版本:

# 安装指令
nvm install 22

# 使用指令
nvm use 22.22.0

成功后会看到类似提示：**<font style="color:rgb(255, 120, 0);background-color:rgb(254, 249, 244);">Now using node v22.22.0</font>**

1.2 git

前往官方安裝：https://git-scm.com/download/win

验证：

git --version

1.3 SSH连接Github仓库

1.3.1尝试ssh连接github

ssh -T git@github.com

如果出现：

git@github.com: Permission denied (publickey).

则需要生成ssh key

1.3.2 生成ssh key

指定文件生成key，我这里在E:\Key\sshKey\id_ed25519文件中生成

ssh-keygen -t ed25519 -C "cliu8813@gmail.com" -f "E:\Key\sshKey\id_ed25519"

生成完成后，看到两个文件：

E:\Key\sshKey\id_ed25519 <-- 私鑰

E:\Key\sshKey\id_ed25519.pub <-- 公鑰

1.3.3 设置公钥私钥

1.把公钥加到 GitHub：

先打开查看公钥内容：

notepad E:\Key\sshKey\id_ed25519.pub

复制全部文字后到 GitHub → Settings → SSH and GPG keys → New SSH key → 贴上公钥→ Save

在这里插入图片描述

2.确保SSH agent正在运行：

查看确认SSH agent 正在运行：

Get-Service ssh-agent

如果 Status 是 Stopped，启动它：

Status Name DisplayName

Stopped ssh-agent OpenSSH
Authentication Agent

Start-Service ssh-agent

遇到问题
如果执行出现：

Start-Service : 由于以下错误无法启动服务“OpenSSH Authentication Agent (ssh-agent)”: 无法启动计算机“.”上的服务 ssh-a gent。所在位置行:1 字符: 1 + Start-Service ssh-agent + ~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : OpenError: (System.ServiceProcess.ServiceController:ServiceController) [Start-Service], ServiceCommandException + FullyQualifiedErrorId : CouldNotStartService,Microsoft.PowerShell.Commands.StartServiceCommand

则：

1.关闭所有PowerShell

2.以管理员身份打开PowerShell

3.执行：
Set-Service -Name ssh-agent -StartupType Automatic 
Start-Service ssh-agent
再次检查：
Get-Service ssh-agent
Status Name DisplayName

------ ---- -----------

Running ssh-agent OpenSSH Authentication Agent

3.设置私钥

ssh-add "E:\Key\sshKey\id_ed25519"
# 如果成功，输出
# Identity added: E:\Key\sshKey\id_ed25519 (cliu8813@gmail.com)

遇到问题

Bad permissions. Try removing permissions for user: NT AUTHORITY\\Authenticated Users (S-1-5-11) on file E:/Key/sshKey/id_ed25519. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ WARNING: UNPROTECTED PRIVATE KEY FILE! @ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Permissions for 'E:\\Key\\sshKey\\id_ed25519' are too open. It is required that your private key files are NOT accessible by others. This private key will be ignored.

原因：

遇到的是 私钥权限过宽 导致 ssh-add 无法加载的问题，这在 Windows 上比较常见，尤其是当私钥保存在非默认用户目录（比如 E:\Key\sshKey\）时。OpenSSH 要求 私钥文件权限必须仅对当前用户可读写，其他用户不可访问。

检查：
Get-Acl "E:\Key\sshKey\id_ed25519" | Format-List
Path : Microsoft.PowerShell.Core\FileSystem::E:\Key\sshKey\id_ed25519 Owner : CHAOLIU\Chao Group : CHAOLIU\None Access : BUILTIN\Administrators Allow FullControl NT AUTHORITY\SYSTEM Allow FullControl NT AUTHORITY\Authenticated Users Allow Modify, Synchronize BUILTIN\Users Allow ReadAndExecute, Synchronize Audit : Sddl : O:S-1-5-21-2867620350-2750199115-541119882-1001G:S-1-5-21-2867620350-2750199115-541119882-513D:(A;ID;FA;;;BA)( A;ID;FA;;;SY)(A;ID;0x1301bf;;;AU)(A;ID;0x1200a9;;;BU)

会看到 Authenticated Users 或其他用户有访问权限，这就是报错原因。OpenSSH 要求私钥文件只能被当前用户访问，其他用户（包括 Authenticated Users、BUILTIN\Users 等）都不允许访问。

需要修改权限，只允许当前用户访问

修复：
# 1. 获取文件 ACL 
$acl = Get-Acl "E:\Key\sshKey\id_ed25519"
# 2. 禁用继承并移除继承权限 
$acl.SetAccessRuleProtection($true, $false)
# 3. 清空所有现有访问规则 
foreach ($rule in $acl.Access) {
    $acl.RemoveAccessRule($rule) 
}
# 4. 添加当前用户完全控制权限 
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule("$env:USERNAME","FullControl","Allow")
$acl.AddAccessRule($rule)
# 5. 应用修改 
Set-Acl "E:\Key\sshKey\id_ed25519" $acl
# 再次检查权限Get-Acl "E:\Key\sshKey\id_ed25519" | Format-List
# 应该只看到你的用户名拥有 FullControl，其他用户不在列表中
# 添加私钥ssh-add "E:\Key\sshKey\id_ed25519"
# 如果成功，输出
# Identity added: E:\Key\sshKey\id_ed25519 (cliu8813@gmail.com)
把当前私钥移动到 .ssh 目录、修复权限、并直接添加到 ssh-agent，完全避免权限问题：
# 定义源私钥路径和目标路径 
$source = "E:\Key\sshKey\id_ed25519"
$destDir = "$env:USERPROFILE\.ssh"
$dest = Join-Path $destDir"id_ed25519"
# 创建 .ssh 目录（如果不存在） 
if (-not (Test-Path $destDir)) { New-Item -ItemType Directory -Path $destDir }
# 移动私钥到默认目录 
Move-Item -Path $source -Destination $dest -Force
# 设置私钥权限：仅当前用户完全控制 
$acl = Get-Acl $dest
$acl.SetAccessRuleProtection($true, $false)   # 禁用继承 
foreach ($rule in $acl.Access) { $acl.RemoveAccessRule($rule) }  # 清空现有规则 
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule("$env:USERNAME","FullControl","Allow")
$acl.AddAccessRule($rule) 
Set-Acl $dest $acl
# 添加私钥到 
ssh-agent ssh-add $dest
# 输出结果提示 
Write-Host "私钥已移动到 $dest 并添加到 ssh-agent，权限已修复。"

1.3.4 再次尝试连接

ssh -T git@github.com

输出：

Hi XXX! You’ve successfully authenticated, but GitHub does not provide shell access.

2 安装openClaw

在管理员 PowerShell 中运行

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

遇到的问题

首次运行脚本可能会出现

无法加载文件 C:\Path\To\Your\Script.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。 + CategoryInfo : SecurityError: (:) []，PSSecurityException + FullyQualifiedErrorId : UnauthorizedAccess

原因：

在默认的 Windows 配置中（尤其是 Windows 10/11 的客户端版本），PowerShell 的默认执行策略通常是 Restricted（受限）。

修复：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

这条命令的意思是，“允许当前用户运行本地编写的 PowerShell 脚本，但要求从网络下载的脚本必须有可信签名，且此设置仅对当前用户有效，无需管理员权限。”

开始安装：

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

openclaw onboard --flow quickstart

配置过程就按照步骤走就行

注意几个地方：

选模型这一步，根据自己情况选择就行，主要就是选择后要输入对应的Key,去对应的官网申请一个key就行，有些模型会送账户额度：

配置通讯工具这一步，虽然官方这里直接可以选飞书，但官方文档明确建议 Windows 通过 WSL2 运行，并且提到原生 Windows 未测试、更容易出问题。所以这里先跳过，后续再安装。

skill这一步也先跳过，后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。

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

配置完成，可以用了

可以设置他的形象：

可以让他分析电脑上的文件，只需给他说路径：

一些指令

开启openclaw：打开一个powershell,然后输入下面的指令：

openclaw gateway

这时可以直接用下面的地址来访问：

http://127.0.0.1:18789/#token=XXXXXXXXX...

token可以在下面的文件中看：C:\Users\Chao.openclaw\gateway.cmd

如果不想找token，那么另外再单独开一个powershell，然后选择下面的方式之一：

上面运行了openclaw gateway的powershell别关

在tui打开openclaw：

openclaw tui

退出：连续 ctrl C 两次

在前端页面[dashboard]打开openclaw(无需token)：

openclaw dashboard

3.接入飞书

3.1先让openclaw自己安装飞书的plugin：

直接把下面的指令发给openclaw让他帮忙处理：

openclaw plugins install @m1heng-clawd/feishu

遇到错误他自己会处理：

3.2去飞书建一个应用-机器人

飞书开放平台地址：https://open.feishu.cn/

3.3OpenClaw接入飞书

进入这个创建的应用，复制App ID和App Secret:

将复制后的App ID与App Secret贴给openclaw,让他配置：

在这里插入图片描述

权限管理：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu: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"]
  }
}