事情是这样的前阵子我在一台 Windows 10 专业版机器上装 OpenClaw想着把 DeepSeek 的接口接进去做一个跑在本地、能调用工具干活的智能体。本以为照着官方文档半小时能搞定结果 Windows 环境下全是坑PowerShell 执行策略拦安装脚本、Node 版本不对、Git clone 超时、配置文件的加载路径跟 Linux 完全不一样。这篇文章就是我完整走通之后的记录写给同样想在 Windows 10 上安装 OpenClaw、配置 DeepSeek 接口的朋友。这篇内容会从为什么要这么装开始一路讲到环境准备、安装命令、DeepSeek 接口配置、验证方法最后附上我踩过的几个高频问题和解决思路。不管你是第一次接触智能体框架还是已经在别的平台跑通过 OpenClaw应该都能在这里找到对得上的细节。1. 为什么要在 Windows 10 专业版上装 OpenClaw两种路线怎么选1.1 先搞清楚 OpenClaw 到底是干什么的OpenClaw 是一个开源的 AI 原生自动化框架简单说就是给大模型装上手让它不只会聊天还能读写文件、执行命令、调 API、对接日历邮箱和各种消息平台。你可以把它理解成本地版的总控助理DeepSeek 这类大模型负责思考和生成内容OpenClaw 负责把这些想法落地成实际动作。和直接用网页版 DeepSeek 聊天相比OpenClaw 的价值在于干活。比如你告诉它把某目录下所有带总结二字的文档读一遍生成一份汇总放到桌面上它能通过工具调用一步步完成。这个能力一旦接上 DeepSeek 的接口就等于把国产大模型直接嵌入到了本地自动化流程里。1.2 原生 Windows 跑还是进 WSL2 跑OpenClaw 官方文档大部分内容是围绕 Linux 环境写的很多命令和路径都假设你用的是 macOS 或 Ubuntu。到了 Windows 10 上就有两条路原生 Windows 运行直接装 Node.js、Git在 PowerShell 里跑。优点是环境简单、路径直观、适合快速验证。WSL2 里跑一个 Ubuntu更贴近官方文档的环境依赖兼容性问题少但多了一层虚拟机开销文件路径、网络访问都要绕一下。我最终选择的是原生 Windows 跑通主流程因为我的需求很明确接上 DeepSeek 接口让 OpenClaw 能干活就够了没必要为了标准环境多维护一套 WSL2。Windows 10 专业版本身对这两种方式都支持得很好尤其是 WSL2只有专业版和企业版能开 Hyper-V 虚拟化平台家庭版折腾起来反而麻烦。下面是这两条路线的对比装之前最好先想清楚对比项原生 WindowsWSL2 Ubuntu安装难度相对简单装好 Node 就能跑需要先启用 Windows 功能并下载内核更新包路径写法C:\Users\xxx\.openclaw 这类 Windows 路径/home/xxx/.openclaw和官方文档一致性能开销直接跑无额外损耗有虚拟化开销但日常使用基本无感常见报错脚本里的 Linux 路径、权限写法可能失效网络端口转发、跨系统文件访问需要额外配置适合场景只想接接口、做自动化测试、个人主力机使用想完整复刻官方教程、需要大量 Linux 工具链我的建议是如果你只是想把 OpenClaw 跑起来然后接 DeepSeek 接口直接走原生 Windows 路线如果你的目标是照着官方文档做二次开发、依赖很多 Linux 工具那就走 WSL2。下面所有步骤以原生 Windows 为主WSL2 需要额外准备的内容我会单独标出来。2. 环境准备先把 Windows 底下这几块地基打好这一节容易被人跳过但恰恰是整篇文章里最容易出问题的地方。OpenClaw 依赖 Node.js 和 Git这两样在 Windows 上装不好后面每一步都会报莫名其妙的问题。2.1 Node.js 版本怎么选这个真不能乱装OpenClaw 对 Node 有明确的版本要求一般需要 18 以上我建议直接装 20 的 LTS 版本。太老的版本跑不起来最新版又可能遇到某些依赖库还没适配的情况。LTS 是官方长期维护版稳定性有保证。安装方式很常规去 Node.js 官网下载 Windows 安装包一路下一步注意安装过程中确认勾选了Add to PATH。这一步漏掉的话后面任何终端里输入 node 都会提示不是内部或外部命令。装完之后一定要新开一个 PowerShell 窗口再验证因为旧窗口里拿不到新设置的环境变量node -v npm -v我在这里踩过一个大坑之前电脑上装过旧版 NodePATH 里残留了旧路径命令行里执行 node -v 显示的版本和实际用的根本不是一个。遇到这种情况可以用下面的命令查一下 Node 到底从哪个路径加载的Get-Command node | Select-Object Source如果发现指向的不是你的新安装目录需要手动清理环境变量里旧版本的路径。2.2 Git、PowerShell 执行策略和编码问题Git 同样是必需品因为安装 OpenClaw 通常需要从仓库拉代码或者依赖 GitHub。Windows 上装 Git 用官方安装包安装时选择Add to PATH即可。国内网络环境下直接从 Git 仓库 clone 偶尔会卡住如果失败可以找个空闲时段重试或者从发布页面直接下载源码压缩包解压不用死磕命令行 clone。接下来是 Windows 特有的一关PowerShell 执行策略。OpenClaw 的安装脚本很多是 .ps1 格式而 Windows 默认禁止运行这些脚本。需要以管理员身份打开 PowerShell执行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned执行后会问你确认输入 Y 回车即可。这个操作的意思是本地创建的脚本可以运行从网络下载的脚本必须有签名才能运行。它的目的是保护系统但在安装 OpenClaw 这种正常工具时不做这一步就只能眼睁睁看着安装脚本被拦截。还有一个小坑Windows PowerShell 默认使用 GBK 编码处理控制台输出程序里的 UTF-8 日志可能直接乱码。解决方法是在启动 OpenClaw 之前执行chcp 65001或者在 PowerShell 的 profile 里设置默认输出编码一劳永逸。这个不会影响系统本身只是让控制台显示更正常。2.3 如果选 WSL2 路线需要额外准备什么走 WSL2 的话先确保 Windows 10 专业版满足条件。需要以管理员身份打开 PowerShell依次执行下面两条命令dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完重启电脑然后去下载并安装 WSL2 内核更新包装完后在 PowerShell 里执行wsl --set-default-version 2接下来在 Microsoft Store 里装一个 Ubuntu进入 Ubuntu 后先执行sudo apt update sudo apt upgrade -y再按官方文档安装 Node.js 和 Git。WSL2 的好处是之后大部分命令都能直接照抄官方文档不需要做 Windows 和 Linux 语义之间的转换。3. 安装 OpenClaw 主程序从下载到启动的完整过程3.1 安装方式怎么选别一上来就乱执行脚本OpenClaw 的安装入口在不同版本之间不太一样我见过两种主流方式一种是官方提供的一键脚本在 PowerShell 里执行一行命令搞定另一种是 npm 全局安装命令行工具适合喜欢用包管理器管理一切的人。我的建议是走官方仓库里说明的方式因为一键脚本会帮你处理 Node 版本检测、依赖下载、初始配置生成这些脏活。具体脚本链接以你下载到的版本说明为准不同版本的安装入口有差异这里不写死一条命令。如果你和我一样更喜欢自己掌控整个安装过程也可以从开源仓库拉源码到本地手动装步骤大致如下git clone OpenClaw 官方仓库地址 cd 克隆下来的目录 npm install注意仓库地址一定要以官方文档为准网上搜到的过时地址可能指向旧仓库。npm install 这一步时间会比较长因为要下载大量依赖耐心等完。3.2 Windows 下安装依赖的经典大坑node-gyp 和编译工具链如果你选择的是源码安装方式npm install 阶段很可能会碰到 node-gyp 相关的报错。node-gyp 是用来编译 C 扩展的Windows 上默认没有编译环境报错信息里往往会要求你安装 Visual Studio Build Tools 和 Python。解决方案去微软官网下载 Visual Studio Build Tools不是完整版 VS只装 Build Tools 就行安装时勾选C 桌面开发组件。另外装一个 Python 3 并加入 PATH。装完重新打开 PowerShell再执行一次 npm install多半就能过了。这个坑在 Linux 下几乎不存在因为 Linux 自带 Python 和 GCC这就是为什么官方文档对 Windows 用户提得少。遇到报错先别慌八成就是这个原因。3.3 初始化配置理解 OpenClaw 的配置结构安装完主程序后按官方文档的执行方式运行初始化命令。这一步会在你的用户目录下生成一个.openclaw文件夹里面包含主配置文件和日志目录。某些版本会把配置生成在项目的 config 目录下无论如何核心配置文件就是一个 JSON 或 YAML 格式的文件里面分块配置 agent 名称、LLM 提供商、消息平台、工具权限等。Windows 下的配置文件路径通常是C:\Users\你的用户名\.openclaw\第一次打开配置文件时里面大部分内容是模板最需要关注的是 LLM 这一块。我们要做的核心工作就是把这块改成 DeepSeek。先别急着改把文件备份一份后面改坏了随时能还原。3.4 启动服务验证 OpenClaw 本身有没有问题配置改之前先裸启动一次。一般启动命令是openclaw serve或者openclaw start以你当前版本的命令为准。启动成功后终端会打印日志提示服务监听的端口通常是 http://localhost:3000 或者 80xx 之类的端口。浏览器打开这个地址如果是命令行交互模式直接在终端里发消息。这一步的关键是确认 OpenClaw 本身没毛病再和 DeepSeek 关联。如果这时候就卡住先排查 Node 版本和依赖安装别急着去配接口。另外注意启动时 Windows 防火墙会弹窗询问是否允许一定要勾选允许并选择专用网络否则会程序自己跑得好好的但浏览器访问不了本地端口。4. 配置 DeepSeek 接口把 Provider 切换过来4.1 先去 DeepSeek 开放平台把 API Key 拿到手配置 DeepSeek 接口的第一步不是写代码而是注册 DeepSeek 开放平台账号创建一个 API Key。创建成功后会生成一串 sk- 开头的密钥这个密钥只完整显示一次一定要当场复制保存。丢了就只能重新创建一个。新注册用户通常会有赠送额度个人测试完全够用。建议先用赠送额度把整个流程跑通确认没问题后再考虑充值。另外API Key 是敏感信息不建议直接写死在配置文件里更科学的做法是存到环境变量中配置里引用变量名。PowerShell 下可以临时设置$env:DEEPSEEK_API_KEY sk-你的key想永久设置的话用setx DEEPSEEK_API_KEY sk-你的key环境变量的好处是以后即使把配置文件分享给别人看也不用担心 key 泄露。4.2 配置文件里要改的几项关键内容打开 OpenClaw 的配置文件找到 LLM 相关的配置块。不同版本字段名会有差异但核心就三样接口地址baseURL、API Key、模型名称。我实际用的配置结构大致如下{ llm: { provider: deepseek, baseURL: https://api.deepseek.com/v1, apiKey: ${DEEPSEEK_API_KEY}, defaultModel: deepseek-chat, temperature: 0.7, maxTokens: 4096 } }如果版本里没有内置 DeepSeek 的 provider就选 OpenAI 兼容模式把 baseURL 和模型名填对即可。DeepSeek 的接口兼容 OpenAI 协议接入方式本质上就是把 OpenAI 的默认地址换成 DeepSeek 的地址。4.3 最容易翻车的点baseURL 到底应该怎么填DeepSeek 官方给出的 base URL 有两个写法https://api.deepseek.com和https://api.deepseek.com/v1。这两个其实指向同一个服务但很多兼容 OpenAI 的 SDK 在请求时会在 baseURL 后面自动补/chat/completions如果你写了/v1而 SDK 又从 OpenAIConfig 里自动补了/v1最后实际请求 URL 就变成了/v1/v1/chat/completions直接 404。我的经验是先按官方推荐的方式填。报 404 的时候不要瞎猜用 DEBUG 级别日志看实际请求的完整 URL再调整路径。配置文件不是越详细越好有时候写多了反而是负担。4.4 模型选择deepseek-chat 用聊天deepseek-reasoner 用推理DeepSeek 目前最常用的两个模型deepseek-chat对应 DeepSeek-V3 对话模型响应快、日常够用适合 OpenClaw 里的大部分工具调用场景。deepseek-reasoner对应 DeepSeek-R1 推理模型适合复杂逻辑、数学、代码分析这类任务但响应时间明显更长。在 OpenClaw 里切换模型非常简单就改 defaultModel 字段的值。日常跑自动化流程用 deepseek-chat 就够如果你要让智能体做深度分析比如解读一段复杂代码就临时切到 deepseek-reasoner。我实际测试下来在 OpenClaw 这种框架里reasoner 模型会因为思考时间太长让人觉得卡死了其实它在后台推理。如果你需要快速响应用 chat 模型体验更顺滑。追求效果再用 reasoner。4.5 temperature 和 maxTokens 的参数经验temperature 控制回答的创造性OpenAI 体系默认一般是 1。DeepSeek 官方对聊天场景的建议区间在 0.8 到 1.0 之间。设低了回答一板一眼设高了容易跑偏。跑自动化任务时我一般设 0.7 到 0.8让输出稳定一点写文案、生成创意内容时再调高。maxTokens 控制单次输出长度上限。常见坑是配置里没设 maxTokens 或者设得太小结果 DeepSeek 生成长文时中途截断OpenClaw 拿到的是一段不完整的回复但并不会报错只是输出突然断了。长文本任务建议至少设 4096比如汇总文档内容或生成完整报告时够用。5. 验证配置与排查高频问题5.1 怎么确定 DeepSeek 接口真的通了配好配置后先手动验证一次 API Key 本身是否有效。在 PowerShell 里用 curl.exe 测试注意是 curl.exe不是 curlPowerShell 自带的 curl 是 Invoke-WebRequest 的别名用法完全不同curl.exe https://api.deepseek.com/chat/completions -H Authorization: Bearer sk-你的key -H Content-Type: application/json -d {\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\你好\}]}正常返回的话会得到一个 JSON 响应里面有 content 字段和 token 使用量统计。这就证明 key 没问题服务也没问题。然后再回到 OpenClaw发一条消息比如让它介绍一下你自己。如果回复是 DeepSeek 模型的输出就说明整条链路通了。想更严谨地确认打开日志看请求 URL 里是否包含api.deepseek.com。5.2 高频错误排查表照着对号入座我在配置过程中把高频错误整理成了一个表排查时直接对号入座错误现象可能原因解决办法401 UnauthorizedAPI Key 填错、过期、多余字符核对 sk- 开头的 key去掉空格重新粘贴402 Payment Required赠送额度用完了账户欠费去开放平台检查余额和用量400 Invalid model模型名称写错确认填写 deepseek-chat 或 deepseek-reasoner404 Not FoundbaseURL 路径拼接重复或地址错误开 DEBUG 日志看实际请求 URL修正 baseURL429 Too Many Requests请求频次超过限制降低并发、加大请求间隔或升级模型套餐回复超时/一直转圈DeepSeek 响应慢或设了 reasoning 模型调大请求超时时间或切回 deepseek-chat控制台打不开Windows 防火墙拦截了 Node 进程在防火墙里放行 Node.js重新启动服务5.3 抓日志的姿势改配置后报错别靠猜OpenClaw 的日志文件一般在配置目录下的 logs 文件夹里文件名通常带日期。Windows 下可以通过下面的命令看最近的日志Get-Content C:\Users\你的用户名\.openclaw\logs\*.log -Tail 50如果只想看报错Select-String -Path C:\Users\你的用户名\.openclaw\logs\*.log -Pattern error看日志的时候注意两个信息一是实际发出的请求 URL二是响应状态码。绝大多数接口配置问题都能在日志里找到答案。我改完配置不会直接重启服务就完事一定先开 DEBUG 模式跑一条消息把完整的请求链路确认清楚再关掉调试模式。DEBUG 模式启动命令一般是openclaw serve --log-level debug看你版本的具体参数。6. 进阶配置和一些个人实操体会6.1 把 OpenClaw 接上 Microsoft Teams配置完 DeepSeek 接口之后OpenClaw 最常见的进阶玩法是接入消息平台。如果你想把 OpenClaw 接到 Microsoft Teams思路也很直接在 Azure 门户创建一个机器人应用拿到 Bot ID、Bot Token 和租户 ID然后在 OpenClaw 的配置里找到 Teams 相关的 channel 配置填入这些信息重启服务。原理是OpenClaw 会把 Teams 里的消息转成内部事件分发给你配置的模型处理再把回复写回 Teams 会话。这样你的 DeepSeek 接口就有了一个入口不用天天开终端直接从 Teams 里发消息就能指挥它干活。这个配置并不复杂但不同版本的 OpenClaw 对 Teams 的配置字段差异较大最好还是看一遍官方文档再动手。6.2 让 OpenClaw 读取本地笔记和文档注意 Windows 路径转义另一个很实用的配置是给 OpenClaw 挂载本地目录访问权限这样它就能直接读取和整理你电脑上的文档。比如和 Obsidian 联动让它汇总笔记内容这也是社区里经常被提到的一种玩法。这时候需要注意 Windows 路径的写法JSON 配置文件里的反斜杠要转义写成双反斜杠。例如{ tools: { notesDirectory: C:\\Users\\你的用户名\\Documents\\notes } }如果只写一个反斜杠JSON 解析会报错或者路径直接被截断。我在这个细节上栽过跟头后来凡是涉及 Windows 路径的配置都特别提醒自己检查转义。6.3 我完整跑通之后的一些体会最直接的体会是原生 Windows 跑 OpenClaw 完全可行主力机这么用没有任何问题。网上很多教程默认你是 Linux 环境动不动就让你跑 ./install.sh但这不意味着 Windows 就装不了只是要多处理一层环境差异。其次OpenClaw 的版本迭代很快配置文件结构经常变。网上搜到的一个月前的教程字段名可能已经对不上了。我的做法是以官方仓库的文档为准配合当前版本的默认配置文件反推逻辑而不是硬抄别人贴出来的配置。还有备份配置这个习惯真的重要。我改配置之前一定先复制一份原文件出了问题一键还原比自己重新回忆改了什么高效得多。最后API Key 放进环境变量、日志级别按需调整、遇到问题先看日志再搜报错信息——这三条习惯可以帮你节省大量排查时间。这套流程走完以后OpenClaw 就安安静静跑在 Windows 10 专业版上了背后接的 DeepSeek 接口随时待命。接下来你可以根据实际需求慢慢往里加工具、接平台、挂知识库把它从一个能聊天的框架变成真正能替你干活的本地助理。