菜鸟AI
菜鸟AI AI提示词 · 教程 · 资讯
首页>新手教程

Windows部署OpenClaw接入DeepSeek与飞书全流程

2026-06-20阅读 0热度 0
ai

电脑配置

先交代一下本文的运行环境：

操作系统：Win11

内存：16GB

显存：8GB

磁盘空间：883GB

基础软件版本

Git：2.13.0

Python：3.13.12

Node.js：v24.14.1(LTS)

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

详细流程

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

1.1 安装Git

用winget直接装，速度最快：

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 Bash输入：

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

后面的your_email@youremail.com换成你在GitHub注册用的邮箱。确定路径和密码时直接回车，保持默认设置。密钥生成后，我们需要把它配到GitHub上，实现远程仓库和本地仓库的连接。

密钥文件藏在C:用户你的用户名（默认是Administrator文件夹）.ssh这个目录里，找到id_rsa.pub，用记事本打开，复制全部内容。然后登录GitHub，点击右上角头像→"Setting"→左侧的"SSH and GPS keys"→右上角的"New SSH key"。Title可以随便写个名字，方便识别是哪台电脑就行，把刚才复制的密钥粘贴到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可以确认版本号。

二、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用的。如果要接DeepSeek V3.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”），生成后 立即复制并保存好（它只显示一次）。

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对话，非常方便。如果选其他平台，需要提前注册账号，而且免费账号的API调用量有限。

Search provider：默认列出的都是国外搜索引擎，国内不好用，直接Skip for now

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

Enable hooks? 可选钩子，钩子可以在消息处理流程中插入自定义逻辑，比如处理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，就能正常进入聊天界面了。

三、对话测试

在聊天界面试着给你的AI助理打个招呼，比如“你好，请介绍一下你自己”。

如果遇到这个报错：

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对接飞书已经大功告成。

上一篇Mac M1运行DeepSeek-R1-Distill-Qwen-1.5B实战避坑指南 下一篇OpenClaw使用llama.cpp本地大模型部署完整教程
免责声明

本网站新闻资讯均来自公开渠道，力求准确但不保证绝对无误，内容观点仅代表作者本人，与本站无关。若涉及侵权，请联系我们处理。本站保留对声明的修改权，最终解释权归本站所有。

相关阅读

更多

最新教程

Stable Diffusion WebUI整合包下载与模型放置全指南HunyuanVideo安装失败排查指南：依赖、显存与工作流问题解决Runway官网入口与使用指南：下载注册及常见问题全解析Notion AI新手入门指南：从下载到模板设置的完整教程GitHub Copilot安装指南：JetBrains插件市场一键配置与激活全流程2026年ComfyUI安装与配置终极指南：从零部署到高效出图全流程解析CogVideoX安装包获取与部署指南：从下载到剪辑机配置的完整教程2024图像识别实战精选：基于EasyDL的完整案例解析与测评

最新资讯

Zep技术原理详解：AIGC长时记忆开源项目精选LangGraph Studio 调试教程：零基础配置智能体工作流全攻略程序员核心学习路径排行榜：AI时代避免淘汰指南iOS首页进度卡实战深度对比：渐变进度条与状态边界全解析AI浪潮下人类最后价值：未来十年生存指南OpenCLI 测评：将网站与工具统一为命令行界面电子书RAG问答系统实战：Milvus+LangChain从零搭建阿里云ECS OpenClaw部署及百炼模型适配完整教程
欢迎回来 登录或注册后，可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策