1. OpenClaw 小龙虾本地部署前先把模型通道这件事想明白OpenClaw 是一个开源的 AI 智能体你可以把它理解成「跑在自己电脑上的 AI 助手」它能读写本地文件、整理笔记、同步日程、跑定时任务还能通过飞书、企业微信、钉钉、Telegram 这些聊天工具远程指挥。它本身不生产模型能力而是把 Claude、GPT、Gemini、DeepSeek、MiniMax、通义千问、Kimi 这些大模型的 API 接进来再套上一层「能动手干活」的工具层。所以本地部署 OpenClaw 这件事本质上要解决两个问题一是把运行环境跑起来二是把模型调用的通道配通。很多人卡在第二步。原因不复杂OpenClaw 初始化时会让你选模型供应商然后粘贴对应平台的 API Key。如果你只用一家模型就得去那家平台注册、实名、充值、建 Key哪天想换成另一家又得重新走一遍流程配置文件里还要改 Base URL 和 Model ID。对零基础用户来说这一步的摩擦感比装 Node.js 还大。我这次的做法是环境照常装模型通道统一走 TaoToken。TaoToken 提供统一的 API 通道和统一 Key兼容 OpenAI 风格的接口格式OpenClaw 里凡是需要填 Base URL、API Key、Model ID 的地方都指向同一套配置。这样你后面想换模型只改一个 Model ID 字符串就行不用再折腾账号和密钥。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这两个地址后面配置里会反复用到先记一下。这篇教程面向的是完全没接触过命令行的用户。我会从 Node.js 和 Git 的安装讲起一路走到飞书机器人能收发消息中间所有需要复制粘贴的命令、需要填写的凭证位置、需要核对的界面提示都会写清楚。全程大约 10 分钟能跑完前提是你别跳步。适合谁看想在自己 Windows 电脑上养一只「小龙虾」、又不想被多家模型平台配置绕晕的人。下面正式开始。2. Node.js 与 Git 环境准备以及 TaoToken 统一 Key 的前置配置OpenClaw 的核心用 TypeScript 写跑在 Node.js 运行时上下载它的代码仓库要用 Git。所以第一步是把这两个工具装好。这一步没有技术含量但装错了后面会报一堆看不懂的错所以按顺序来。先装 Node.js。打开官网 https://nodejs.org/zh-cn 页面会自动识别你的系统点【获取 Node.js】按钮选 Windows 安装程序.msi下载。双击安装包一路 Next 到底即可安装包里同时带了 Node.js 和 npm管理 JS 库的工具。装完可以开一个 PowerShell 窗口验证node -v npm -v两条命令都能打印出版本号说明环境就绪。如果提示「不是内部或外部命令」多半是安装时没勾选加入 PATH重装一次并保持默认选项即可。再装 Git。打开 https://git-scm.com 点【Install for Windows】下载 Git for Windows/x64 Setup。双击后如果弹出用户账户控制窗口点【是】然后同样一路 Next 到底。Git 的作用是把 OpenClaw 的代码仓库克隆到本地。验证git --version能打印版本号就行。接下来是 TaoToken 的前置准备。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制保存好。这个 Key 就是后面 OpenClaw 配置里要粘贴的凭证。同时确认你要用的模型 ID比如claude-sonnet-4-5、gpt-4o、deepseek-chat这类字符串具体以控制台模型列表为准。TaoToken 的接入文档在 https://taotoken.net/doc 里面有完整的 Base URL 和参数说明配置前扫一眼能省很多试错。这里有个关键点OpenClaw 初始化向导里默认列的是各家官方供应商比如 MiniMax、Kimi。如果你直接选这些填的就是对应平台的 Key。而我们要走统一通道做法是在向导里选择兼容 OpenAI 接口的选项通常显示为 Custom OpenAI 或 OpenAI Compatible然后把 Base URL 填成https://taotoken.net/apiAPI Key 填 TaoToken 的 KeyModel ID 填你要用的模型。这样一套凭证打通所有模型。环境准备好之后先别急着装 OpenClaw把 PowerShell 的执行策略放开否则脚本可能被拦。以管理员身份运行 PowerShell执行Set-ExecutionPolicy RemoteSigned提示是否更改时输入y回车。再把 npm 源换成国内镜像避免下载中断npm config set registry https://registry.npmmirror.com这两条做完前置工作就齐了。下面进入 OpenClaw 本体的安装和配置。3. OpenClaw 安装与 settings 配置片段飞书凭证填写位置一次说清安装 OpenClaw 用一条全局安装命令npm install -g openclawlatest下载和安装需要一点时间中途别关终端。如果失败重新执行同一条命令即可npm 支持断点重试。装完后运行初始化openclaw第一次会弹出一段红色提示大意是「默认按个人使用若要共享或多用户需做权限加固是否继续」。按左方向键选【Yes】回车。接着选【QuickStart】快速启动。到模型配置这一步别选列表里的官方供应商往下找到兼容 OpenAI 接口的选项Custom / OpenAI Compatible。然后按提示依次填写三项Base URLhttps://taotoken.net/apiAPI Key粘贴你在 TaoToken 控制台创建的 KeyModel ID填你要用的模型例如claude-sonnet-4-5如果你更习惯直接改配置文件OpenClaw 的配置一般落在用户目录下的配置文件中Windows 通常在C:\Users\你的用户名\.openclaw\下。模型相关片段可以写成这样JSON 格式路径以你本机实际为准{ models: { default: claude-sonnet-4-5, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5 } } } }注意 Base URL 后面不要多加/v1之类的后缀以文档说明为准Key 不要带多余空格。改完保存重启服务生效。继续向导即时通讯平台先选【Skip for now】搜索服务也跳过Skills 选【No】hooks 列表里用空格选中【session-memory】再回车。系统会新开一个 PowerShell 窗口启动服务弹出 Node.js 权限确认时点【允许】。回到配置窗口选【Open the Web UI】浏览器会打开 OpenClaw 的 Web 界面。在输入框里发一句「你是哪个大模型」能收到回复就说明模型通道通了。这一步如果报 401基本是 Key 错了或没生效如果报连接失败检查 Base URL 是否写成了https://taotoken.net/api。确认无误后再往下走飞书部分。4. 飞书机器人创建与 OpenClaw 通讯配置验证消息收发是否成功模型通了接下来把飞书接上。打开飞书开放平台 https://open.feishu.cn 点【创建企业自建应用】填应用名称和描述图标随意点【创建】。进入应用后第一个卡片是【机器人】点【添加】。左侧菜单出现机器人图标说明创建成功。点【权限管理】→【开通权限】在搜索框输入im:勾选权限名称旁的复选框全选点【确认开通权限】。然后点【创建版本】填版本号1.0.0和更新说明【保存】→【确认发布】。看到「已发布」即成功个人账号一般无需审核。回到 PowerShell新开一个窗口进入配置界面openclaw config依次选择【Localthis machine】→【Channels】→【Configure/link】→【Feishu/Lark飞书】。新版本内置飞书插件优先选【Use local plugin path】没有就选【Download from npm】。接着填凭证。选【Enter App Secret】去飞书后台【凭据与基础信息】页面复制 App Secret回到配置窗口右键粘贴回车。再选【Enter App ID】同样在【凭据与基础信息】页面复制 App ID 粘贴回车。连接模式选【WebSocketdefault】地区选【Feishufeishu.cn- China】群聊选【Open – respond in all groupsrequires mention】然后【Finished】。私信授权选【Yes】再选【Open (public inbound DMs)】最后【Continue】。配置完成后重启服务openclaw gateway看到飞书插件配置成功的提示后还要回飞书后台配「事件与回调」。点【事件与回调】→【订阅方式】旁的编辑图标勾选【使用长连接接收事件】并保存。此时【添加事件】按钮激活依次添加搜索「接收消息」勾选搜索「消息」勾选【消息已读】搜索「机器人」勾选【机器人进群】和【机器人被移除群】。再点【创建版本】版本号填1.0.1保存并发布。最后补一个权限点【权限管理】→【开通权限】搜索「通讯录」勾选【获取通讯录基本信息】确认开通。再创建版本1.0.2发布。然后再次执行openclaw gateway重启服务。验证环节在飞书后台点右上角【功能】→【消息】搜索你创建的机器人名称打开聊天窗口发一句「你是谁能做什么」。窗口出现机器人标识表示正在思考稍等会收到回复。手机上装飞书 App发一句「把桌面上的安装步骤文件发给我」能收到文件就说明整条链路打通了。5. 部署常见报错排查401、local proxy failed、reading choices 怎么处理部署过程中最容易撞上的几类报错这里集中说一下对照着改基本能解决。第一类是 401 Unauthorized。出现在 Web UI 发消息或飞书机器人回复时。原因通常是 API Key 填错、Key 已失效、或者 Base URL 和 Key 不匹配。排查动作打开 TaoToken 控制台 https://taotoken.net/api-keys 确认 Key 还在、没被删检查配置文件里apiKey字段有没有多余空格或换行确认baseUrl是https://taotoken.net/api而不是别的地址。改完必须重启openclaw gateway配置不会热加载。第二类是 local proxy failed 或连接超时。这多半是 Base URL 写错、网络出口不通或者把地址写成了带/v1的路径导致拼接重复。处理方式把 Base URL 严格按文档写成https://taotoken.net/api不要自己加后缀确认本机能正常访问该地址如果公司网络有出口限制换一个网络环境再试。第三类是 reading choices 相关报错通常长这样Cannot read properties of undefined (reading choices)。这说明请求发出去了但返回结构不是预期的 OpenAI 格式常见原因是 Model ID 填了一个通道不支持的模型名或者 Base URL 指向了非兼容接口。排查去 TaoToken 控制台模型列表核对 Model ID 拼写确认走的是 OpenAI 兼容通道把 Model ID 换成一个确定可用的模型再试。第四类是飞书侧的问题。机器人不回复先看openclaw gateway窗口有没有收到事件日志。没有日志说明「事件与回调」里的长连接没配好或者版本没发布。有日志但报权限错误回去检查im:权限和通讯录权限是否都开通并发布了新版本。飞书每次改权限或事件都要重新创建版本并发布这一步最容易漏。第五类是 OAuth 或授权类报错。如果配置里出现 OAuth 相关提示说明你选的连接方式需要额外授权流程而飞书自建应用走的是 App ID App Secret 模式不需要 OAuth。回到openclaw config重新走一遍 Channels 配置确认选的是飞书而不是其他平台。把这几类对照完绝大多数部署问题都能定位。核心原则就一条模型侧的问题看 Base URL、Key、Model ID 三件套飞书侧的问题看权限、事件、版本发布三件事。6. 后续怎么用统一 Key 换模型与长期编码场景的接入建议跑通之后你会发现 OpenClaw 真正好用的地方在于「换模型不用换配置」。因为模型通道统一走 TaoToken想从 Claude 换到 GPT 或 DeepSeek只需要改配置文件里的 Model ID 一个字符串Base URL 和 Key 都不动。这对经常对比不同模型效果的人很省事。如果你打算把 OpenClaw 当成长期编码或自动化任务的助手建议把模型调用通道固定下来别每次重装都重新配。TaoToken 的 Coding Plan 适合这种长期高频调用的场景接入方式在 https://taotoken.net/coding-plan 有说明。日常想快速验证某个模型能不能用可以直接在模型对话页面试地址是 https://taotoken.net/models 不用改本地配置就能对比输出。飞书这边机器人跑起来之后可以继续加能力比如让它定时推送日报、整理指定文件夹、把聊天里的文件自动归档。这些都是在 OpenClaw 的 Skills 和 hooks 里扩展配置入口还是openclaw config。每次改完记得重启openclaw gateway这是最容易忘的一步。最后提醒一句本地部署意味着服务跑在你自己的机器上电脑关机或休眠机器人就不在线了。如果要长期在线得让机器保持运行。这一点在规划用途时先想清楚免得配好了却发现「怎么不回复」——大概率只是电脑睡了。