1. 先搞清楚 fuser not found 到底卡在哪一步CherryStudio 里点下 OpenClaw 的安装按钮日志刷到一半突然停住终端里蹦出一行红字fuser not found; required for --force when lsof is unavailable。这个报错看着像 Linux 的锅其实你人可能在 Windows 上压根没装过 fuser 和 lsof 这两个东西。OpenClaw 的 Gateway 启动逻辑里带了一个端口占用检测它想用--force强制接管端口就得先知道谁占着端口。检测手段按优先级找lsof找不到就退而求其次找fuser两个都没有它就直接拒绝执行强制启动。所以这不是 CherryStudio 的 bug也不是 OpenClaw 装坏了而是「端口检测工具链」在 Windows 上天然缺失。CherryStudio 作为 MCP 客户端负责把 OpenClaw 这个 MCP Server 拉起来并保持通信OpenClaw 自己负责 Gateway 进程和端口管理。报错发生在后者但表现是前者界面卡住。你要做的不是重装 CherryStudio而是把 OpenClaw 的启动参数和依赖补齐。这篇会按「先定位、再补依赖、再改启动参数、最后用统一 Key 通道验证连通」的顺序走一遍。适合已经在 CherryStudio 里配过 MCP、但被这个报错拦住的人也适合刚接触 MCP 架构、想弄明白 Server 端端口管理逻辑的人。全程命令可直接复制Windows PowerShell 和 Git Bash 都能跑。2. TaoToken 前置给 OpenClaw 一条稳定的模型通道OpenClaw 启动后要接模型才能干活CherryStudio 里配 MCP Server 只是把工具挂上去模型请求还得走 API。我习惯把模型通道统一收口到 TaoToken这样 OpenClaw、CherryStudio 里的其他助手、以及后面可能加的 Agent 都共用一套 Key换模型不用到处改配置。TaoToken 的定位是统一 API 通道一个 Key 覆盖多家模型接口格式兼容 OpenAI 风格OpenClaw 这类需要填base_urlapi_key的工具直接对接就行。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 注意这个地址后面不加任何查询参数。你需要提前准备两样东西一个可用的 API Key以及确认要用的模型名。Key 在控制台生成地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你只是想先验证模型通不通不急着配 OpenClaw可以直接用模型对话页试一条请求 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。提示OpenClaw 的模型配置里base_url填https://taotoken.net/api不要带末尾斜杠也不要在后面拼/v1之外的路径具体以 OpenClaw 配置项说明为准。多数 OpenAI 兼容客户端会自动补/v1/chat/completions。把 Key 和地址先记在便签里下一步配 MCP 和 Gateway 时要用。3. 可复制配置依赖检测 启动参数调整3.1 先确认你缺的到底是 fuser 还是 lsof打开 PowerShell 或 Git Bash逐条跑where lsof where fuserWindows 上大概率两条都返回「找不到」。如果你在 Git Bash 里跑可能看到的是$ where lsof bash: where: command not foundGit Bash 没有where换成whichwhich lsof which fuser两条都空说明端口检测工具确实缺失。这时候你有两个方向装工具或者绕开--force的检测逻辑。装工具在 Windows 上比较折腾因为 fuser 属于 psmisc 包原生 Windows 没有绕开更直接后面讲。3.2 确认 OpenClaw 和 Node 环境node --version npm --version npm list -g openclawNode 建议 LTSnpm 能正常输出即可。如果npm list -g openclaw报空说明全局包没装或没装对名字。注意包名是openclaw不是anthropic-ai/openclaw那种带 scope 的写法装错名字会 404。npm install -g openclawlatest装完再跑一次npm list -g openclaw确认版本号出现。3.3 初始化工作空间首次使用先初始化这一步会创建本地配置目录和工作空间npx openclaw setup跑完你会看到配置落盘的路径提示。如果这一步就报错先解决 Node 环境问题别急着往下走。3.4 关键一步改掉带 --force 的启动方式报错的核心触发点就是--force。OpenClaw 的 Gateway 启动命令原本是npx openclaw gateway run --force--force的语义是「端口被占就强杀占用进程」而强杀前需要 lsof/fuser 定位进程。Windows 没有这俩工具于是报错。解决办法是手动释放端口然后不带--force启动。先查端口占用。OpenClaw Gateway 默认端口常见是 19001以你实际配置为准netstat -ano | findstr :19001输出里最后一列是 PID比如TCP 127.0.0.1:19001 0.0.0.0:0 LISTENING 12345拿到 PID 后杀掉taskkill /F /PID 12345端口空出来后直接启动不带--forcenpx openclaw gateway run这样 OpenClaw 不再调用 lsof/fuser报错自然消失。如果你确实想保留--force的自动接管能力那就得装工具见下一节。3.5 想保留 --force装 psmisc 或改用 WSLWindows 原生装 fuser 的可行路径是包管理器。Chocolatey 方式Set-ExecutionPolicy Bypass -Scope Process -Force [System.Net.ServicePointManager]::SecurityProtocol [System.Net.ServicePointManager]::SecurityProtocol -bor 3072 iex ((New-Object System.Net.WebClient).DownloadString(https://community.chocolatey.org/install.ps1)) choco install psmiscScoop 方式Set-ExecutionPolicy RemoteSigned -Scope CurrentUser irm get.scoop.sh | iex scoop install psmisc装完where fuser能定位到可执行文件再跑--force就不会报 not found。不过说实话为了一个端口检测去装包管理器性价比不高手动 taskkill 更轻。另一个干净方案是把 OpenClaw 放进 WSL 跑Linux 环境原生有 lsof/fuser--force直接可用。但 WSL 里 CherryStudio 要能访问到 WSL 的端口网络配置要额外处理适合本来就重度用 WSL 的人。3.6 CherryStudio 里的 MCP Server 配置骨架CherryStudio 添加 MCP Server 时命令和参数这样填配置项值名称openclaw命令npx参数openclaw-mcp-client传输方式stdio按 CherryStudio 当前版本选项为准如果你用的是其他 MCP Server比如文件系统或 GitHub命令结构类似npm install -g modelcontextprotocol/server-filesystem npm install -g modelcontextprotocol/server-github在 CherryStudio 里把命令填npx参数填对应包名即可。MCP 的本质是「客户端按配置拉起 Server 进程通过 stdio 或 SSE 通信」所以命令能不能跑起来、依赖全不全直接决定 CherryStudio 里那个开关能不能变绿。3.7 OpenClaw 的模型通道配置OpenClaw 启动后要接模型配置里填 TaoToken 的地址和 Key{ baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, model: 你选定的模型名 }具体字段名以 OpenClaw 当前版本的配置 schema 为准有的版本叫base_url有的叫endpoint。核心是地址不带 UTM、不带多余路径Key 用控制台生成的那串。4. 验证请求确认 OpenClaw 在 CherryStudio 里真的起来了4.1 命令行侧验证 Gateway不带--force启动后终端应该持续输出 Gateway 运行日志类似[openclaw] Gateway listening on 127.0.0.1:19001 [openclaw] MCP client channel ready看到 listening 就说明端口起来了。另开一个终端查状态npx openclaw status正常会列出 Gateway、通道、模型三块状态。如果 Gateway 显示 running通道显示 connected模型显示可用说明 Server 端没问题。4.2 CherryStudio 侧验证回到 CherryStudio刷新 MCP 面板。OpenClaw 那一项应该从灰色变成可用点进去能看到模型配置、通道管理、技能市场这些模块。如果还是灰的看 CherryStudio 的 MCP 日志通常是命令路径或参数不对。4.3 用 TaoToken 做一次连通性验证模型通道通不通最直接的办法是发一条请求。你可以在 OpenClaw 的对话界面里发一句「你好报一下当前模型名」也可以直接用 curl 打 TaoToken 的接口curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的_TaoToken_Key \ -d { model: 你选定的模型名, messages: [{role: user, content: ping}] }返回里有choices字段和正常内容说明 Key、地址、模型名三者都对。如果返回 401检查 Key返回 404检查模型名或路径返回超时检查网络出口。注意curl 里的地址是https://taotoken.net/api/v1/chat/completions这是 OpenAI 兼容的标准路径。OpenClaw 配置里如果只填到/api由客户端自己补/v1/...两种写法不要混。4.4 跑一次完整链路在 CherryStudio 里让 OpenClaw 执行一个需要模型工具的任务比如「列出当前工作空间的文件并总结每个文件的作用」。这个任务会同时触发 MCP 工具调用和模型推理能一次性验证Gateway 在跑、MCP 通道通、模型通道通。任务正常返回结果整条链路就算打通了。5. 本篇常见错排查5.1 fuser not found 反复出现说明你还在用带--force的命令。要么按 3.4 手动 taskkill 后不带--force启动要么按 3.5 把 psmisc 装上。两者选一别在没工具的情况下硬跑--force。5.2 openclaw 不是内部或外部命令全局包装了但环境变量没刷新。最省事的办法是用npx openclaw xxx代替openclaw xxx。想彻底解决就重启终端或把 npm 全局 bin 目录加进 PATHnpm config get prefix把输出的路径加进系统环境变量重开终端。5.3 Unknown command: openclaw start新版 OpenClaw 改了命令结构start已经废弃。用npx openclaw gateway run想看全部命令跑npx openclaw --help排障跑npx openclaw doctor。5.4 npm error 404包名写错。正确的是openclaw或openclaw-mcp-client不是带anthropic-ai前缀的那种。装之前可以先npm view openclaw version确认包存在。5.5 端口被占用但 taskkill 杀不掉有些进程权限高普通终端杀不动。用管理员身份开 PowerShell 再 taskkill。或者换一个端口启动 Gateway避开冲突npx openclaw gateway run --port 19002具体端口参数名以npx openclaw gateway run --help输出为准。5.6 CherryStudio 里 MCP 一直转圈先看 CherryStudio 的 MCP 日志确认它拉起的命令是什么。常见问题是命令填了openclaw但 PATH 里没有改成npx 参数openclaw-mcp-client通常能解决。另一个原因是 OpenClaw Gateway 没起来MCP client 连不上回到 4.1 确认 Gateway 状态。5.7 模型请求 401 或 404401 是 Key 问题去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新生成一个注意别把 Key 里的字符复制漏。404 多半是模型名写错或路径拼错确认base_url是https://taotoken.net/api模型名和控制台里列出的完全一致。6. 后续怎么用把通道和工具链固定下来修完这个报错建议把启动方式固化成一个脚本省得每次手动 taskkill。Windows 下写个start-openclaw.ps1$port 19001 $conn netstat -ano | findstr :$port if ($conn) { $pid ($conn -split \s)[-1] taskkill /F /PID $pid } npx openclaw gateway run以后双击或powershell -File start-openclaw.ps1就能干净启动不依赖 fuser/lsof。模型通道这边如果你后面要长期跑编码类任务或 Agent 工作流可以考虑把 Key 和额度规划放到 Coding Plan 里统一管理入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入细节和字段说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你用的是 Claude Code 这类 Anthropic 风格客户端对应的接入说明在 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后提醒一句MCP Server 的进程管理是 CherryStudio 和 OpenClaw 之间的契约报错信息里的工具名fuser/lsof只是表象真正要盯的是「谁负责拉起进程、谁负责端口、谁负责模型通道」这三件事。把这三层分清楚下次再遇到类似 not found你就能直接定位到是哪一层缺依赖而不是从头重装。