Windows部署OpenClaw：接入DeepSeek、飞书流程

电脑配置操作系统Win11内存16GB显存8GB磁盘空间883GB基础软件版本Git2.13.0Python3.13.12Node.jsv24.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_emailyouremail.com后面的your_emailyouremail.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 key1.2 安装Python下载地址https://www.python.org1.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 安装与初始化安装最新版本OpenClawnpm install -g openclawlatest启动新手向导openclaw onboard --install-daemon在向导中大部分选项可以直接使用默认值直接按回车但有几个关键地方需要我们手动配置安全警告: 当提示操作风险时输入 Yes 继续配置模式: 选择 QuickStart 快速启动模式AI 模型提供商: 当问到“Model Provider”时 不要选择默认的选项 。请选择 Custom Provider (自定义提供商) 或类似选项以便我们手动接入DeepSeekAPI Base URL默认为http://127.0.0.1:11434这是本地自建ollama AI模型的接口如果要接入deepseek3.2大模型应修改为 https://api.deepseek.com/v1API Key的提供方式1选择 Paste API key nowAPI Key此处务必粘贴您提前在DeepSeek官网生成的完整API密钥打开浏览器访问 DeepSeek 开放平台官网并登录/注册https://platform.deepseek.com/。进入控制台找到“API Keys”菜单。 点击“创建新的API Key”为它起一个名字例如“OpenClaw”生成后 立即复制并保存好这个Key 它只会显示一次API Key的提供方式2粘贴你的DeepSeek API KeyEndpoint compatibility选择 OpenAI-compatible (Uses /chat/completions) OpenAI 兼容格式模型 IDdeepseek-chat这是 DeepSeek-V3 的调用 IDEndpoint 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 nowConfigure 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 stopopenclaw dashboard --no-open复制生成的URL再执行openclaw gateway start等服务启动后在浏览器打开刚才复制的URL就能正常Connect进入聊天界面三、对话测试在浏览器打开的OpenClaw聊天界面中尝试向您的AI助理提问例如“你好请介绍一下你自己”。跟openclaw开始聊天如果报以下错误⚠️ Context limit exceeded. Ive 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为190000maxTokens为128000之后使用openclaw gateway stopopenclaw gateway start重启服务令配置生效如果一切配置正确它将调用DeepSeek V3.2进行回答。恭喜您部署成功⚙️ 管理与故障排查自动在默认浏览器中打开http://127.0.0.1:18789openclaw dashboard查看服务状态 openclaw status修改配置与选项openclaw onboard重启网关 openclaw gateway restart停止网关 openclaw gateway stop常见问题诊断运行 openclaw doctor 可以自动检查许多常见问题卸载openclaw uninstall --all --yes --non-interactivenpm rm -g openclawGateway启动失败 如果在启动gateway时遇到问题可以尝试以管理员身份在PowerShell中依次执行以下命令进行修复 openclaw gateway install启动网关服务: openclaw gateway startopenclaw gateway statusopenclaw gateway probe四、对接飞书安装飞书插件openclaw plugins install m1heng-clawd/feishu4.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 重新启动OpenClawopenclaw gateway restart在浏览器打开 http://localhost:18789/4.7 飞书事件配置事件配置订阅方式设置为长链接点击“保存”。必须先启动OpenClaw才能配置。回调配置订阅方式设置为长链接点击“保存”。4.8 配置事件点击下面“添加事件”搜索im.message.receive勾选接收消息事件然后点击“添加”。​​​4.9 发布新版本每一次对飞书应用更改配置我们都需要重新发布才能生效。点击上方“创建版本”填写版本详情4.10 第一次使用第一次使用OpenClaw会发送一个编码让我们确认配对。配置配对编码openclaw pairing approve feishu 这里填写你的配对码然后重启一下OpenClawopenclaw gateway restart在手机端的飞书给OpenClaw发个信息等待片刻之后它有回复了这样就完成OpenClaw对接飞书了。