电脑配置

操作系统：Win11

内存：16GB

显存：8GB

磁盘空间：883GB

基础软件版本

Git：2.13.0

Python：3.13.12

Node.js：v24.14.1(LTS)

以下大部分命令行都以管理员身份打开PowerShell输入。

详细流程

一、基础软件安装（如已安装可跳过）

1.1 安装Git

通过以下命令行安装

winget install git.git

或到这个地址下载安装：https://git-scm.com/

以下配置git步骤为非必要

打开Git Bash，配置git的用户名和邮箱：

$ git config --global user.name "输入你的GitHub用户名"

$ git config --global user.email "输入你的GitHub注册邮箱"

打开git，输入

 $ssh-keygen -t rsa -C "your_email@youremail.com" 

后面的your_email@youremail.com是你在github上注册使用的邮箱

输入后Git要求确认路径和密码，直接回车默认设置，它会显示秘钥图像代表keys已经生成了，我们需要这串秘钥来和GitHub上的远程仓库和本地仓库进行远程连接

秘钥路径在C：\用户\你的用户名（默认是Administrator文件夹）.ssh 这个文件夹，找到打开后会看到一个id_rsa.pub文件，右键记事本或其他编辑器打开，复制全部keys。打开GitHub账号，点击右上角自己的头像，打开"setting"，左侧栏找到"SSH and GPS keys" 点击进入，右上角点击"New SSH key"，会进入一个输入界面，Title随便取一个名字，最好是你当前使用的计算机名以便区分，然后将刚刚复制的keys粘贴到key框框中，点击Add SSH key

1.2 安装Python

下载地址：https://www.python.org

1.3 安装Node.js

通过以下命令安装，自动安装适配版本

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

或去这个网站：https://nodejs.org/en/download 下载Windows的安装包，一直点击下一步选择默认安装完成。注意Node版本 >=22

强烈建议配置npm国内镜像，否则可能导致不可预知的问题

npm config set registry https://registry.npmmirror.com

通过在命令行输入npm -v可以查看到node版本

二、OpenClaw 安装与初始化

安装最新版本OpenClaw

npm install -g openclaw@latest

启动新手向导

openclaw onboard --install-daemon

在向导中，大部分选项可以直接使用默认值（直接按回车），但有几个关键地方需要我们手动配置：

 安全警告 : 当提示操作风险时，输入  Yes  继续

配置模式 : 选择  QuickStart  快速启动模式

AI 模型提供商 : 当问到“Model Provider”时， 不要选择默认的选项 。请选择  Custom Provider  (自定义提供商) 或类似选项，以便我们手动接入DeepSeek

API Base URL：默认为http://127.0.0.1:11434，这是本地自建ollama AI模型的接口，如果要接入deepseek3.2大模型，应修改为： https://api.deepseek.com/v1

API Key的提供方式1：选择 Paste API key now

API Key：此处务必粘贴您提前在DeepSeek官网生成的完整API密钥；打开浏览器，访问 DeepSeek 开放平台官网并登录/注册：https://platform.deepseek.com/。进入控制台，找到“API Keys”菜单。 点击“创建新的API Key”，为它起一个名字（例如“OpenClaw”），生成后 立即复制并保存好这个Key （它只会显示一次）

API Key的提供方式2：粘贴你的DeepSeek API Key

Endpoint compatibility：选择 OpenAI-compatible (Uses /chat/completions) ，OpenAI 兼容格式

模型 ID：deepseek-chat（这是 DeepSeek-V3 的调用 ID）

Endpoint ID：选默认custom-api-deepseek-com，也可以修改

Model alias (optional)：可以输入：DeepSeekV3.2；也可自命名

Select channel (QuickStart)：此项为选择那一个AI交互平台与openclaw交流。可以选择：Skip for now，后面通过OpenClaw自带的网页控制台直接与AI对话，非常方便。也可以选择一个你熟悉的AI交互平台，但需要提前注册账号，用免费账号交流会受API接入量限制

Search provider：默认列出的搜索引擎都是国外厂家，国内不好用，此处选择Skip for now

Configure skills now? (recommended)：选No，稍后再配置

Enable hooks? 可选的钩子，钩子是 OpenClaw 在消息处理流程中可以插入的自定义逻辑，例如处理 Markdown、加载额外文件、记录命令、会话记忆等，选session-memory

配置完毕。然后gateway服务会自动启动

在浏览器访问http://127.0.0.1:18789这个地址，就能够打开OpenClaw的TUI，这个时候如果一切正常，是可以直接进入聊天界面的。

如果遇到出现unauthorized: device token mismatch (rotate/reissue device token)报错的问题

可以尝试

openclaw gateway stop

openclaw dashboard --no-open

复制生成的URL，再执行

openclaw gateway start

等服务启动后在浏览器打开刚才复制的URL，就能正常Connect进入聊天界面

三、对话测试

在浏览器打开的OpenClaw聊天界面中，尝试向您的AI助理提问，例如“你好，请介绍一下你自己”。

跟openclaw开始聊天，如果报以下错误：

⚠️ Context limit exceeded. I've reset our conversation to start fresh - please try again.

To prevent this, increase your compaction buffer by setting `agents.defaults.compaction.reserveTokensFloor` to 20000 or higher in your config.

编辑~/.openclaw/openclaw.json增加配置reserveTokensFloor，设置为28000，修改models里的contextWindow为190000，maxTokens为128000：

之后使用

openclaw gateway stop

openclaw gateway start

重启服务令配置生效

如果一切配置正确，它将调用DeepSeek V3.2进行回答。恭喜您，部署成功！

⚙️ 管理与故障排查

• 自动在默认浏览器中打开http://127.0.0.1:18789：openclaw dashboard

• 查看服务状态： openclaw status

• 修改配置与选项：openclaw onboard

• 重启网关： openclaw gateway restart

• 停止网关： openclaw gateway stop

• 常见问题诊断：运行  openclaw doctor  可以自动检查许多常见问题

• 卸载：openclaw uninstall --all --yes --non-interactive
             npm rm -g openclaw

• Gateway启动失败 ：如果在启动gateway时遇到问题，可以尝试以管理员身份在PowerShell中依次执行以下命令进行修复  ：

  • openclaw gateway install

  • 启动网关服务: openclaw gateway start

  • openclaw gateway status

  • openclaw gateway probe 

四、对接飞书

安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

4.1 创建应用

打开 https://open.feishu.cn/app，创建应用

填写应用名称、说明，并选择应用图标的背景色和图标，点击创建

4.2 添加机器人

4.3 为机器人开通权限

contact:user.base 获取用户基本信息

im:message 消息权限，这边默认全部勾选

点击“确认开通权限” -> “确认”

4.4 发布应用

点击“创建版本”

接下来的版本详情，填写“应用版本号”，“更新说明”，然后点击“保存” -> “确认发布”

4.5 更新飞书凭证

首先获取应用凭证

通过以下命令更新：

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 config set channels.feishu.dmPolicy pairing

openclaw config set channels.feishu.groupPolicy allowlist

openclaw config set channels.feishu.requireMention true

更新如下：

4.6 重新启动OpenClaw

openclaw gateway restart

在浏览器打开 http://localhost:18789/

4.7 飞书事件配置

事件配置：订阅方式设置为：长链接，点击“保存”。必须先启动OpenClaw才能配置。

回调配置：订阅方式设置为：长链接，点击“保存”。

4.8 配置事件

点击下面“添加事件”，搜索：im.message.receive，勾选接收消息事件，然后点击“添加”。​​​

4.9 发布新版本

每一次对飞书应用更改配置，我们都需要重新发布，才能生效。点击上方“创建版本”，填写版本详情

4.10 第一次使用

第一次使用，OpenClaw会发送一个编码，让我们确认配对。

配置配对编码

openclaw pairing approve feishu 这里填写你的配对码

然后重启一下OpenClaw

openclaw gateway restart

在手机端的飞书给OpenClaw发个信息，等待片刻之后，它有回复了！这样就完成OpenClaw对接飞书了。