京东云轻量服务器上的 OpenClaw小龙虾升级到 2026.3.24 之后用 XShell 登录执行openclaw --version很容易迎面撞上openclaw: command not found。先别急着重装因为ps aux | grep openclaw还能看到openclaw-gateway进程ss -tlnp里 18789 和 18791 也还挂着飞书插件甚至还能回消息。把命令入口修回来之后如果准备给 OpenClaw 接模型通道可以直接去 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 KeyBase URL 填https://taotoken.net/api不用再绕旧控制台。下面按照当时那台京东云轻量服务器的排查顺序把 symlink 修复和模型通道配置一次讲清楚。1. XShell 里 openclaw --version 报 command not found但进程和端口都在登录京东云轻量服务器后第一反应通常是升级把二进制弄丢了或者 PATH 被改坏了。实际上 OpenClaw 这种常驻型助手命令入口和 gateway 运行时经常是两套东西。命令找不到不代表 gateway 没在干活。1.1 先别急着重装ps 和 ss 给出的信号用 XShell 连上服务器执行openclaw --version终端返回openclaw: command not found这时候不要立刻npm uninstall再重装因为重装有可能覆盖正在跑的 gateway飞书插件也会短暂掉线。先看进程和端口ps aux | grep openclaw ss -tlnp | grep -E 18789|18791如果输出里能看到openclaw-gateway进程并且18789、18791两个端口处于监听状态说明 OpenClaw 的服务端还在运行。飞书插件仍能回复也侧面证明消息接收和 gateway 处理链路没断。问题只出在/usr/bin下那个名为openclaw的命令入口。1.2 /proc/1647253/exe 指向 /usr/bin/node 说明了什么进一步看进程可执行文件ls -l /proc/1647253/exe如果 PID 换成了你服务器上的实际值输出会指向/usr/bin/node。这说明openclaw-gateway本质上是 Node 进程npm 全局包里的入口脚本通过 node 启动。换句话说运行时依赖和包内容大概率还在丢的是全局 bin 目录到/usr/bin之间的软链或者 npm 升级后没有自动执行link步骤。还可以顺手确认 npm 全局安装位置npm root -g npm bin -g在京东云轻量服务器常见的 Node 安装方式下全局包通常落在/usr/lib/node_modules全局 bin 在/usr/bin或/usr/local/bin。如果which openclaw为空而包目录里能找到 OpenClaw 的 CLI 入口就基本坐实了 symlink 缺失。2. 飞书插件还能回复说明缺的是命令入口不是运行时飞书机器人还在正常收发消息这一点很关键。它把问题范围从“OpenClaw 整体挂掉”缩小到“命令行入口丢失”。对于正在跑业务的服务器这个判断能省下很多无谓的重启。2.1 npm 全局安装为什么没建 /usr/bin/openclaw 软链npm 全局安装一个包时如果包声明了bin字段npm 会在全局 bin 目录里创建可执行链接或包装脚本。升级到 OpenClaw 2026.3.24 时可能因为权限、prefix 配置、或者 npm 版本行为变化导致/usr/bin/openclaw没有被创建。还有一种情况是之前手动创建过软链但 npm 升级时把它覆盖或删掉了。你可以查一下全局包目录ls -l $(npm root -g)/openclaw/cli/bin/不同安装方式目录名可能略有差异关键是找到实际的可执行入口比如openclaw或openclaw.js。找到以后再看系统 PATH 里有没有同名命令which openclaw type -a openclaw如果都没有输出就按下一步补软链。2.2 手动创建 symlink 让 openclaw --version 恢复原文里的处理方式是手动创建/usr/bin/openclaw。仿照这个思路先确认入口文件OPENCLAW_BIN$(npm root -g)/openclaw/cli/bin/openclaw ls -l $OPENCLAW_BIN然后建立软链sudo ln -sf $OPENCLAW_BIN /usr/bin/openclaw sudo chmod x $OPENCLAW_BIN执行完再验证openclaw --version如果输出了2026.3.24或对应版本号说明命令入口已经恢复。此时 gateway 不需要重启飞书插件也不会断。注意这一步只是修 symlinkTaoToken 不参与也不需要把任何网络配置塞进这个环节。3. 命令恢复后OpenClaw 2026.3.24 的模型通道改走 TaoTokenopenclaw --version能打印版本只代表命令行工具回来了。接下来要给 OpenClaw 接模型通道让它背后调用的模型走统一 API。这里不要再翻旧控制台直接打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 KeyBase URL 用https://taotoken.net/api。3.1 去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key别翻旧控制台OpenClaw 要调模型需要三样东西API Key、Base URL、模型 ID。Key 从 TaoToken 控制台创建打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end完成登录后进入 API Keys 页面新建一把 Key。复制出来的值先记为YOUR_API_KEY后面填进 OpenClaw 配置文件时再替换成真实 Key。模型 ID 不要凭记忆写也不要随手加日期后缀。去同一个站点的模型广场看当时列表里支持的模型 ID复制你要用的那个。不同模型在 OpenClaw 里的工具调用能力不一样飞书场景建议选已经确认支持 function calling 的模型。Base URL 统一填https://taotoken.net/api末尾不要加/v1也不要带任何查询参数。3.2 ~/.openclaw/config.json 里填 Base URL 和模型 IDOpenClaw 的模型配置通常在运行用户的家目录下比如~/.openclaw/config.json。如果你用 systemd 托管也可能是服务用户家目录或/etc/openclaw/下的配置文件。打开对应文件找到模型或 provider 段按 OpenAI 兼容通道写入{ llm: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: YOUR_MODEL_ID } }如果原文件里已经有其他 provider不要整段删除只新增一个 TaoToken 通道或者把默认 provider 指向它。改完保存注意 JSON 不能有尾逗号。模型 ID 以 TaoToken 模型广场 当时列表为准不要拿其他站点的模型名硬套。Base URL 再强调一次https://taotoken.net/api不是https://taotoken.net/api/v1也不是带 UTM 的官网地址。4. 重启 gateway 并确认 OpenClaw 真的在用 TaoToken 通道配置文件改完不会自动生效。OpenClaw 的 gateway 需要重新读取配置否则飞书里回复仍然走旧通道你会误以为 TaoToken 没配上。4.1 openclaw gateway status 与日志检查先重启 gateway。如果系统里用的是 systemd 服务sudo systemctl restart openclaw-gateway openclaw gateway status如果 OpenClaw 自带 gateway 管理命令也可以执行openclaw gateway restart openclaw gateway status状态正常后看最近日志journalctl -u openclaw-gateway -n 80 --no-pager重点看有没有provider、baseUrl、apiKey相关的报错。如果日志里出现 401说明 Key 没填对出现 404多半是 Base URL 多了/v1出现模型不存在说明YOUR_MODEL_ID没从模型广场复制正确。4.2 飞书发一条消息去 TaoToken 控制台对用量先确认命令和 gateway 状态openclaw --version openclaw gateway status两个都正常后在飞书聊天窗口给 OpenClaw 发一条测试消息。如果它能回复并不代表一定走了 TaoToken还要去控制台核对。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end进入用量或日志页面看刚才那条消息对应的时间点有没有新的调用记录。有记录说明 OpenClaw 的模型请求已经打到https://taotoken.net/api没有记录就回到配置文件检查 provider 是否真的切过去了。5. 配完通道后还会遇到的 401、404 和 symlink 复现这类服务器上的 OpenClaw 通常不是只配一次就永远不动。npm 升级、系统更新、切换运行用户都可能让配置或软链再次出问题。下面几个坑是实际排查时最容易撞上的。5.1 Base URL 多写 /v1 的 404OpenClaw 里如果 Base URL 填成https://taotoken.net/api/v1请求路径会多一层常见表现是 404 或找不到模型。正确写法是https://taotoken.net/api末尾不要加/v1也不要加 UTM。官网地址和接口地址是两回事官网用于注册、创建 Key、看模型广场和用量接口地址只填进 OpenClaw 的baseUrl字段。5.2 Key 过期或模型 ID 填错的 401/400401 一般指向 Key 问题。检查YOUR_API_KEY是否从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建复制时有没有带空格是否已经被删除或轮换。400 则常见于模型 ID 写错比如把展示名称当成模型 ID或者自己加了不存在的版本后缀。回到模型广场复制一次再重启 gateway。5.3 npm 升级再次吞掉 symlink 的兜底下次再执行npm update -g或升级 OpenClaw 后/usr/bin/openclaw可能又消失。可以放一个简单的检查命令openclaw --version || sudo ln -sf $(npm root -g)/openclaw/cli/bin/openclaw /usr/bin/openclaw这只是兜底不要把它写成开机脚本去掩盖安装问题。如果频繁丢失检查 npm prefix 和运行用户权限而不是反复手动补链。TaoToken 只负责模型通道的 Key 和 Base URLsymlink 和 gateway 生命周期仍然归 OpenClaw 自己管。6. 下一步把这次 OpenClaw 调用记到控制台命令恢复、通道配好、飞书能回消息之后还有一件事值得做确认这把 Key 和这个模型 ID 在控制台里能对上账。这样以后排查“到底是 OpenClaw 没发请求还是模型通道报错”会快很多。6.1 模型对话里先测同一把 Key在改 OpenClaw 配置之前可以先去 TaoToken 模型对话 用同一把 Key 发一条测试消息。如果模型对话里正常说明 Key、Base URL、模型 ID 三件套没问题如果这里就报错先解决 Key 或模型 ID再回去改 OpenClaw。模型对话的入口和 OpenClaw 配置用的是同一套 API 通道测通之后能省掉很多来回重启。6.2 Coding Plan 与创建 Key 的入口如果 OpenClaw 要长期在飞书里跑模型调用量会慢慢上来。可以打开 Coding Plan 看套餐是否够用后续要新建或轮换 Key在 控制台 API Keys 里操作。OpenClaw 侧仍然只改~/.openclaw/config.json里的baseUrl、apiKey和modelBase URL 保持https://taotoken.net/api。这样一套流程下来2026.3.24 的 OpenClaw 命令入口和模型通道都能各自归位openclaw --version修的是 symlink飞书消息走的是 TaoToken 通道两件事分开排查下次再遇到command not found就不会把整台服务器重装一遍。