1. Windows11 纯国内环境装 OpenClaw 到底卡在哪OpenClaw 是一个可以跑在本地的 AI Agent 网关它能把你电脑上的本地大模型、飞书机器人、命令行工具串成一条链路让机器人在飞书里直接调用你本机的模型来回答问题、读写文件、执行命令。适合谁适合手上有 Windows11 机器、想在内网或纯国内网络下玩本地 Agent、又不想把数据发到云端的开发者。我这次用的机器是 Dell Inspiron 14 Plus 7430i7-13620H、16G 内存、RTX4050 6G 独显系统是 Windows11网络是纯国内全程没有用任何特殊网络手段。整个安装过程最容易卡住的地方有三个第一是 Node.js 和 npm 的 PowerShell 脚本执行权限Windows 默认 Restricted 策略会直接拦住 npm.ps1第二是 npm 默认源在国内下载依赖经常超时必须换镜像第三是 OpenClaw 首次配置时如果选了云端模型后面接本地 LM Studio 还要再改一遍配置不如一开始就想清楚链路。我踩过的坑是第一次装完 OpenClaw 直接选了云端 provider结果本地 LM Studio 的模型一直没接上后来重新走了一遍openclaw config才把 Custom Provider 配好。这篇文章会按真实操作顺序走一遍先装 Node.js 和构建工具再装 OpenClaw 本体然后配飞书通道接着用 LM Studio 起本地模型服务最后把 OpenClaw 指向本地模型并做消息回环验证。中间会给出可复制的配置片段和常见报错排查。如果你只是想先跑通一个最小链路可以跳过飞书部分先把本地模型接上再说。需要提前说明的是OpenClaw 本身是一个网关程序它不替代编辑器也不直接操作你的生产数据库。它的作用是做协议转换和工具调度。LM Studio 负责把本地模型以 OpenAI 兼容接口暴露出来OpenClaw 负责把这个接口注册成一个 provider飞书负责做消息入口。三者各司其职配置的时候要分清哪一层出了问题。另外TaoToken 在这个链路里扮演的是统一 Key 通道的角色。当你后面要接多个云端模型或者多个工具时每个工具都去单独管理一套 Key 会很乱用 TaoToken 的 API 通道可以把鉴权收口到一处。它的 API 地址是 https://taotoken.net/api控制台和 Key 管理在 https://taotoken.net/api-keys。本地模型这条链路本身不需要 TaoToken但如果你后面要加云端模型做兜底统一 Key 会省很多事。2. Node.js 与构建工具的前置配置OpenClaw 的安装脚本依赖 Node.js 和 npm版本选择上建议用 v22 的 LTS 版本。到 Node.js 官网下载 Windows Installer (.msi)选 Windows x64一路 Next除了安装位置其他默认即可。装完之后用管理员模式打开 Windows PowerShell输入node -v和npm -v能显示版本号就说明装好了。这里最常见的报错是npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1因为在此系统上禁止运行脚本。原因是 PowerShell 默认执行策略是 Restricted不允许运行任何脚本。解决办法是改当前用户的执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned 的含义是本地脚本不需要数字签名从网络下载的脚本需要签名。这个策略对日常开发够用也不会把整台机器放开。改完可以用Get-ExecutionPolicy确认当前策略。PowerShell 的几种策略区别如下策略含义Restricted默认不允许任何脚本运行AllSigned只能运行有数字签名的脚本RemoteSigned本地脚本免签网络脚本需签名Unrestricted允许所有脚本运行前提示Bypass允许所有脚本无提示接着换 npm 镜像源防止下载超时npm config set registry https://registry.npmmirror.com npm config get registry第二条命令显示https://registry.npmmirror.com就说明换好了。也可以用npm config list查看 registry 那一行。然后装 Git。到 git-scm.com 下载 Windows x64 setup一路回车默认安装。装完在管理员 PowerShell 里执行两条 URL 替换命令避免 git 协议在国内被卡git config --global url.https://github.com/.insteadOf gitgithub.com: git config --global url.https://.insteadOf git://第一条把所有gitgithub.com:开头的地址替换成 https第二条把git://协议也替换成 https。这样后面 npm 拉依赖时走 git 协议的部分就不会卡住。再装 Python。到 python.org 下载 3.11.x 的 Windows 安装包安装时务必勾选 “Add python.exe to PATH”否则后面构建原生模块会找不到 Python。装完在 PowerShell 里输入python --version确认。最后装 Windows Build Tools。到 Visual Studio 官网下载 Build Tools 安装器安装时选择 “Desktop development with C” 工作负载并确保勾选 Windows 10/11 SDK。这一步是为了编译某些 npm 原生模块不装的话后面npm install可能报 node-gyp 相关错误。整个前置配置大概需要 20 到 30 分钟主要时间花在 Build Tools 的下载和安装上。3. OpenClaw 安装与 LM Studio 本地模型对接配置前置工具齐了之后重新开一个管理员 PowerShell执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex默认安装位置是主目录下的.openclaw。如果你想装到别的盘先设置环境变量再运行安装命令New-Item -ItemType Directory -Path D:\ai\openclaw -Force [Environment]::SetEnvironmentVariable(OPENCLAW_HOME, D:\ai\openclaw, User) [Environment]::GetEnvironmentVariable(OPENCLAW_HOME, User)第三条命令用来确认变量写进去了。安装完成后会自动进入首次配置界面也就是 onboarding。第一步选 Yes 继续然后选 Quickstart 快速配置。模型提供商这里可以先跳过Channel 也先跳过Skills 暂时不设后面都能补。配置走完会自动装网关完成后浏览器打开控制台地址就能看到界面。如果打不开关掉终端重开一个输入openclaw gateway start启动网关第一次访问控制台记得带上 token 参数。接下来装 LM Studio。到 lmstudio.ai 下载 Windows 版一路 Next 装好并运行。在搜索框里搜qwen3.5-9B选好版本后下载。下载完在模型页载入模型可以直接对话测试这个模型支持图像输入。然后点左侧的开发模式图标进入本地服务页点运行服务器再载入模型。在服务器设置里可以改端口我改成了 4321也可以开启 API Key。注意 Load 处的上下文长度要设大一点防止对话到一半长度不够。LM Studio 起好之后它的 OpenAI 兼容接口地址是http://127.0.0.1:4321/v1。现在回到 OpenClaw 做对接。在管理员 PowerShell 里输入openclaw config按提示选择 Local (this machine) → Model → Custom Provider然后依次填API Base URLhttp://127.0.0.1:4321/v1API Key填 LM Studio 里设的 Key没设就空着Endpoint compatibility选 OpenAI-compatibleModel IDqwen3.5-9BVerification验证服务器是否可达Endpoint ID随意不改也行Model alias别名可写可不写如果你习惯直接改配置文件OpenClaw 的配置是 JSON 格式路径在%OPENCLAW_HOME%\config.json对应的 provider 片段大概长这样{ providers: { lmstudio-local: { type: openai-compatible, baseUrl: http://127.0.0.1:4321/v1, apiKey: , model: qwen3.5-9B } } }如果你后面要接云端模型做兜底可以把 TaoToken 的通道也加进来Base URL 用https://taotoken.net/apiKey 从 https://taotoken.net/api-keys 拿Model ID 按你实际要用的模型填。这样本地和云端就在同一个配置里管理切换的时候只改 provider 名字。配完重启网关openclaw gateway restart然后就可以在控制台里选这个本地模型试对话了。4. 飞书通道接入与消息回环验证OpenClaw 内置了飞书插件不需要额外下载。先看插件列表openclaw plugins list能看到 feishu 是 disabled 状态启用它openclaw plugins enable feishu然后添加通道openclaw channels add按提示选择飞书输入飞书应用的 App ID、App Secret 等凭证。这些凭证在飞书开放平台创建企业自建应用后可以拿到具体创建流程按飞书官方文档走。填完选 Finished 退出。接着启动飞书客户端把机器人添加到某个群或者直接私聊发一条消息机器人会返回一个配对码。复制这个配对码回到命令行执行批准命令看到成功提示后这个账号就能和机器人正常对话了。验证消息回环的时候在飞书里发一句 “你好”如果 OpenClaw 网关、LM Studio 服务、飞书通道三层都通机器人会返回本地模型生成的回复。如果没反应按下面的顺序排查先确认 LM Studio 的服务器还在运行再确认 OpenClaw 网关没挂最后看飞书通道状态。如果你在配置里同时用了 TaoToken 的统一 Key 通道飞书这边不需要单独填 TaoToken 的 Key鉴权是在 OpenClaw 的 provider 层做的。飞书只负责消息进出模型调用走的是 OpenClaw 内部的 provider 路由。这一点分清楚排查的时候就不会在飞书凭证上浪费时间。消息回环验证通过后你可以试着让机器人在飞书里执行一个文件读取操作比如 “读一下 D:\test.txt”。如果机器人回复说没有权限那就是工具 profile 的问题下一节会讲。5. 常见报错排查401、local proxy failed 与工具权限第一个高频报错是 401。如果你在 OpenClaw 里配了云端 provider 但 Key 不对调用时会返回 401。排查方法是确认 provider 的 apiKey 字段填的是对应平台的 KeyBase URL 没有多写或少写/v1。如果用 TaoToken 通道Key 从 https://taotoken.net/api-keys 复制Base URL 用https://taotoken.net/api不要带多余路径。第二个是local proxy failed。这个通常出现在 OpenClaw 尝试连本地 LM Studio 的时候。原因可能是 LM Studio 的服务器没启动或者端口对不上。先确认 LM Studio 开发模式里服务器是运行状态再看端口是不是你配的那个。如果改了端口OpenClaw 的 baseUrl 也要同步改。另外 Windows 防火墙可能拦了本地回环以外的请求但 127.0.0.1 一般不受影响。第三个是reading choices相关报错。这通常说明返回的 JSON 结构不符合 OpenAI 兼容格式或者模型返回了空响应。先确认 LM Studio 里模型加载正常上下文长度够用。如果用的是自定义 endpoint确认 compatibility 选的是 OpenAI-compatible。第四个是 OAuth 相关报错。如果你在接某些需要 OAuth 的云端服务token 过期会报这个。重新走一遍授权流程即可。本地模型链路不涉及 OAuth。第五个是工具权限问题。表现是机器人能对话但让它读写文件或执行命令时回复没有权限。先查当前 profileopenclaw config get tools.profile如果返回messaging说明工具权限被限制在消息相关。解决办法是设置成 coding 或 fullopenclaw config set tools.profile codingprofile 的含义如下profile包含能力minimal仅 session_statuscoding文件读写、运行时、会话等核心工具messaging仅消息相关工具full无限制所有工具可用本地开发建议用 coding需要完全放开再用 full。改完重启网关生效。另外如果你要装 Skills可以用官方指定的 clawhubnpm install -g clawhub clawhub --version显示版本号就说明装好了。后面可以用它搜索和安装技能包。6. 统一 Key 通道与后续扩展建议本地模型跑通之后你可能会遇到新的需求本地 9B 模型回答质量不够想加一个云端模型做兜底或者你想同时接多个工具每个工具都要单独配 Key。这时候如果每个 provider 都单独管理一套鉴权配置会越来越乱。TaoToken 的作用就是把这些 Key 收口到一处OpenClaw 里只配一个 provider 指向 TaoToken 的 API 地址换模型的时候只改 Model ID。具体做法是在 OpenClaw 的 provider 配置里加一个条目Base URL 用https://taotoken.net/apiKey 从控制台拿Model ID 按你要用的模型填。这样本地模型和云端模型可以共存飞书里通过切换模型名来选择走哪条链路。对于长期跑编码任务或者 Agent 任务的场景可以考虑用 Coding Plan把常用的模型和额度统一管理。接入文档在 https://taotoken.net/doc 可以查到具体的参数说明。如果你只是想先验证某个模型的效果可以直接在模型对话页面试不用先写配置。整个链路的思路是本地 LM Studio 负责离线推理OpenClaw 负责调度和协议转换飞书负责交互入口TaoToken 负责云端鉴权收口。四层各管各的出问题的时候按层排查比混在一起调要快得多。最后提醒一点OpenClaw 的配置文件改动后一定要重启网关才生效openclaw gateway restart这条命令会用到很多次。LM Studio 的模型如果换了OpenClaw 这边的 Model ID 也要同步改否则会报模型找不到。飞书机器人的配对码是一次性的换账号要重新配对。把这些记清楚后面扩展的时候会省很多来回折腾的时间。