windows原生系统上安装OpenClaw对接DeepSeek+飞书指南

weixin_45810257

373人浏览 · 2026-03-18 15:55:50

weixin_45810257 · 2026-03-18 15:55:50 发布

第一步：环境准备 (在Windows 11中)
在开始之前，请确保您的电脑满足最低要求：Windows 10/11 64位系统，建议4GB以上内存，并拥有稳定的网络连接。
1. 安装 Node.js

这是最关键的一步。 OpenClaw 需要 Node.js 22 或更高版本才能运行。
打开浏览器，访问 Node.js 官方网站： nodejs.org 。
下载 LTS（长期支持版）的 Windows 安装包（例如 node-v22.x.x-x64.msi ）。
双击下载的安装包，在安装过程中，请务必勾选“Automatically install the necessary tools”或类似选项，这可以帮助您自动配置必要的环境。同时，确保勾选“Add to PATH”，这样系统才能识别 node 和 npm 命令。
安装完成后，重启您的电脑以确保所有环境变量生效。

2. 验证 Node.js 安装

按下 Win + R 键，输入 powershell ，然后按 Ctrl + Shift + Enter 以管理员身份打开 Windows PowerShell（以下需要在PowerShell中输入命令的操作，都需要以管理员身份打开 Windows PowerShell）。
在 PowerShell 中，依次输入以下命令并回车，查看版本号：
node --version# 应该输出类似 v22.11.0 或更高
npm --version# 应该输出类似 10.9.0 或更高，
如果都能看到版本号，说明 Node.js 安装成功。

3. 在D盘创建工作目录（如果想默认安装在C盘，此步可忽略）

在PowerShell中，输入以下命令，在F盘创建您指定的 openclaw 文件夹并进入该目录：
mkdir D:\openclaw -Forcecd F:\openclaw
-Force 参数可以确保如果父文件夹不存在也一并创建。

第二步：安装 OpenClaw
1. 设置PowerShell执行策略（如需）

为了能运行来自互联网的安装脚本，有时需要调整执行策略。在管理员身份的PowerShell中输入：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
当询问时，输入 Y 确认。

2. 运行一键安装脚本

在确保当前PowerShell路径已经位于 F:\openclaw 后，复制并粘贴以下命令，然后回车：
irm https://openclaw.ai/install.ps1 | iex
这个命令会自动下载并安装OpenClaw的最新版本。

3. 进入配置向导

安装脚本运行完毕后，通常会自动启动一个名为 onboard 的交互式配置向导。如果没有自动启动，您可以手动输入 openclaw onboard 并回车来启动它。
在向导中，大部分选项可以直接使用默认值（直接按回车），但有几个关键地方需要我们手动配置：
-  安全警告 : 当提示操作风险时，输入 Yes 继续；
-  配置模式 : 选择 QuickStart 快速启动模式；
-  AI 模型提供商 : 当问到“Model Provider”时，不要选择默认的选项。请选择 Custom Provider (自定义提供商) 或类似选项，以便我们手动接入DeepSeek ；
-  Base URL：默认为http://127.0.0.1:11434，这是本地自建ollama AI模型的接口，如果要接入deepseek3.2大模型，应修改为： https://api.deepseek.com/v1 ；
-  API Key：此处务必粘贴您提前在DeepSeek官网生成的完整API密钥；• 打开浏览器，访问 DeepSeek 开放平台官网并登录/注册： https://platform.deepseek.com/ 。 • 进入控制台，找到“API Keys”菜单。 • 点击“创建新的API Key”，为它起一个名字（例如“OpenClaw”），生成后立即复制并保存好这个Key （它只会显示一次）
-  Endpoint compatibility：选择 OpenAI-compatible (Uses /chat/completions) ，OpenAI 兼容格式；
-  模型 ID：deepseek-chat（这是 DeepSeek-V3 的调用 ID）；
-  Endpoint ID：选默认custom-api-deepseek-com，也可以修改；
-  Model alias (optional)：可以输入：DeepSeek V3.2；也可自命名；
-  Select channel (QuickStart)：此项为选择那一个AI交互平台与openclaw交流。可以选择：Skip for now，后面通过OpenClaw自带的网页控制台直接与AI对话，非常方便。也可以选择一个你熟悉的AI交互平台，但需要提前注册账号，用免费账号交流会受API接入量限制；
-  Search provider：默认列出的搜索引擎都是国外厂家，国内不好用，此处选择Skip for now；
-  Configure skills now? (recommended)：选Yes; 用空格键勾选 clawhub （技能商店）、 nano-pdf 等您需要的技能，选完后按回车确认。
-  Enable hooks? 可选的钩子，钩子是 OpenClaw 在消息处理流程中可以插入的自定义逻辑，例如处理 Markdown、加载额外文件、记录命令、会话记忆等，刚开始用不到，此处选Skip for now；
向导完成后，OpenClaw的核心环境就搭建好了。

第三步：启动与验证
1. 启动 OpenClaw 核心服务 (Gateway)

回到 PowerShell，输入以下命令启动网关服务：
openclaw gateway start
如果启动成功，您会看到相应的提示。第一次启动可能需要一些时间。

2. 打开操作面板 (Dashboard)；

服务启动后，在 PowerShell 中输入：
openclaw dashboard
这条命令会自动在您的默认浏览器中打开一个新页面，地址通常是 http://127.0.0.1:18789

3. 开始对话测试

在浏览器打开的OpenClaw聊天界面中，尝试向您的AI助理提问，例如“你好，请介绍一下你自己”。
如果一切配置正确，它将调用DeepSeek V3.2进行回答。恭喜您，部署成功！

⚙️ 管理与故障排查

 查看服务状态： openclaw status
 修改配置与选项：openclaw onboard
 重启网关： openclaw gateway restart
 停止网关： openclaw gateway stop
 常见问题诊断：运行 openclaw doctor 可以自动检查许多常见问题。
 Gateway启动失败：如果在启动gateway时遇到问题，可以尝试以管理员身份在PowerShell中依次执行以下命令进行修复：
 openclaw gateway install
 openclaw gateway start
 openclaw gateway status
 openclaw gateway probe

以上就是在Windows 11系统中部署OpenClaw并接入DeepSeek V3.2的详细步骤！

第四步，连接飞书
已安装并配置好 DeepSeek 3.2 后，对接飞书全程在本地终端与【飞书开放平台】完成， 10 分钟即可上线。

安装飞书插件（必需），以管理员身份打开 Windows PowerShell在终端执行： openclaw plugins install @openclaw/feishu
安装完成后重启网关：openclaw gateway restart
飞书开放平台注册账号，创建【企业自建应用】，填写名称与描述。

 左侧添加能力 → 启用机器人。
 进入凭证与基础信息，复制 App ID （cli_xxx）和 App Secret 。
 权限管理 → 批量导入 OpenClaw 所需权限 JSON（参考官方文档），并申请开通。
 事件与回调 → 订阅方式选长连接（WebSocket），添加事件 im.message.receive_v1 （接收消息）。
 版本管理与发布 → 创建版本并提交审核（个人开发者可快速通过）。

4. OpenClaw 配置飞书通道

以管理员身份打开 Windows PowerShell在终端执行：openclaw channels add
按提示选择 Feishu ，粘贴创建飞书机器人时获得的 App ID 与 App Secret
-  Configure DM access policies now? 现在要配置私聊的访问权限策略吗？(default: pairing) ○ Yes / ● No；选No，使用最简单安全的默认策略：pairing（配对模式）：
-  Add display names for these accounts? (optional) 要不要给账号设置显示名称？○ Yes / ● No 选No；后期需要可以再改；
-  Bind configured channel accounts to agents now? 现在把刚配好的飞书通道绑定到智能体上？ ● Yes / ○ No ；选Yes

5. 重启网关并配对：openclaw gateway restart
6. 飞书向机器人发消息，机器人会回复 “配对码” ：

OpenClaw: access not configured.

Your Feishu user id: ou_XXXXXXXXXXXXXXXXXXXX

Pairing code: *************

Ask the bot owner to approve with:

openclaw pairing approve feishu *********

7. 在powershell终端执行：
openclaw pairing approve feishu <**配对码***>
8. 测试与排障

飞书私聊 / 群聊 @机器人，发送 “你好” 测试回复。
如果没有回复，用记事本打开C:\Users\Fanwd\.openclaw文件夹下的openclaw.json文件，看一下groupPolicy:项是否设为 "open"

        "channels": {
        "feishu": {
        "enabled": true,
        "appId": "cli_xxxx",
        "appSecret": "xxxx",
        "groupPolicy": "open"
        }
        }