1. Linux 服务器上跑 OpenClaw 到底难在哪：Node.js 版本、微信通道与模型 Key 三件事
如果你在 Linux 上折腾过 OpenClaw，大概率会卡在三个地方：Node.js 版本不够、微信插件装完连不上、模型 API Key 散落在各个配置文件里。这篇就把这三件事一次讲清楚，从 Node.js 环境到微信消息通道，再到用 TaoToken 统一管理模型调用，全部给可复制的命令和配置。
先说清楚 OpenClaw 是什么。它是一个跑在你自己服务器上的 AI 助手框架，支持通过插件接入不同的聊天通道，微信就是其中之一。适合谁？适合手上有台 Linux 服务器（云主机、虚拟机、家里的旧电脑都行）、想让 AI 助手直接在自己的微信里收发消息的开发者。你不需要公网域名，也不需要备案，只要服务器能访问外网就行。
为什么强调 Node.js 版本？OpenClaw 的核心依赖要求 Node.js v22 以上。Ubuntu 自带的 apt 源里 Node.js 版本往往偏低，直接apt install nodejs装出来可能是 v18 甚至更老，跑起来会报SyntaxError: Unexpected token或者模块加载失败。所以第一步不是急着装 OpenClaw，而是先把 Node.js 环境搞对。
微信这一侧也有门槛。手机微信需要 8.0.70 及以上版本，才支持 ClawBot 插件扫码登录。服务器侧则要通过官方 CLI 安装微信插件，生成登录二维码，扫码后消息通道才算打通。
模型调用这块，很多人一开始是每个模型单独配一个 Key，DeepSeek 一个、通义一个、Claude 一个，配置文件越堆越乱。我的做法是用 TaoToken 做统一入口，一个 Key 走所有模型，Base URL 指向https://taotoken.net/api，换模型只改 Model ID，不用动 Key。这样 OpenClaw 的配置文件里只需要维护一份凭证。
下面按顺序来：先装 Node.js 和 npm，再装 OpenClaw，然后配模型通道，最后装微信插件并验证消息收发。每一步都有命令和预期结果，照着敲就行。
2. 前置准备：Node.js v22、npm 与 TaoToken 统一 Key 通道
2.1 系统要求与依赖安装
我用的环境是 Ubuntu，内存 2GB 起步，磁盘留 10GB 以上，网络能出外网。先更新包索引：
sudo apt update sudo apt upgrade -y装 Node.js。这里有个坑：Ubuntu 默认源的 Node.js 版本太老，建议用 NodeSource 的源装 v22：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs装完检查版本，两个都要看：
node -v npm -v预期输出类似v22.x.x和10.x.x。如果node -v显示 v18 或更低，说明旧版本没清干净，先sudo apt remove nodejs再重装。
npm 如果单独装过，确认一下 registry。国内服务器直连 npm 官方源会慢，换成镜像：
npm config set registry https://registry.npmmirror.com npm config get registry最后一行应该回显https://registry.npmmirror.com/。
2.2 在 TaoToken 拿到统一 Key
打开 TaoToken 官网注册后进控制台，在 API Keys 页面创建一个 Key。这个 Key 就是后面 OpenClaw 配置里要填的凭证。TaoToken 的好处是一个 Key 能调多个模型，Base URL 统一是https://taotoken.net/api，模型通过 Model ID 区分。
创建 Key 的入口在控制台的 API Keys 页，复制出来先存好，后面配置要用。如果你还没决定用哪个模型，可以先在模型对话页面试几个，看看哪个响应风格合你胃口，再回 OpenClaw 里配。
这里提醒一句：Key 不要提交到 Git，也不要在聊天里明文发。OpenClaw 的配置文件建议设成600权限。
2.3 微信侧的准备
手机微信升级到 8.0.70 及以上。这个版本才支持 ClawBot 插件扫码。升级路径在微信「我 - 设置 - 关于微信 - 检查更新」。服务器侧不用装微信客户端，插件会生成二维码，手机扫就行。
3. 可复制配置：安装 OpenClaw 并写入模型通道
3.1 安装 OpenClaw
官方一键脚本：
curl -fsSL https://openclaw.ai/install.sh | bash国内服务器下载慢的话，先换 npm 源再跑，或者用 sudo 版本：
curl -fsSL https://openclaw.ai/install.sh | sudo bash安装过程比较长，云主机或虚拟机上可能要等几分钟才看到配置界面跳出来。如果没自动跳转，按两次Ctrl+C退出，然后验证：
openclaw --version能打印版本号就说明装上了。
3.2 配置模型通道（关键步骤）
安装脚本会引导你进配置界面。走到「配置 API Key」这一步时，选择自定义或 more，把 Base URL 和 Key 填成 TaoToken 的：
- Base URL：
https://taotoken.net/api - API Key：你在 TaoToken 控制台创建的那个
- Model ID：比如
deepseek-v4-flash，或你在模型对话里试好的其他模型
如果安装时跳过了配置，可以手动改配置文件。OpenClaw 的配置一般在~/.openclaw/config.json（不同版本路径可能略有差异，用openclaw config path确认）。写入下面这段 JSON：
{ "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": { "default": "deepseek-v4-flash" } } }, "defaultProvider": "taotoken" }保存后设权限：
chmod 600 ~/.openclaw/config.json这样 OpenClaw 所有模型调用都走 TaoToken，换模型只改default那个 Model ID，Key 不用动。如果你用 Codex 或 Claude Code 这类工具，它们的auth.json或 settings 里也是同样的三件套：Base URL、Key、Model ID，配法一致。
3.3 安装微信插件
先更新核心，避免版本冲突：
openclaw update然后一键装微信插件：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install这条命令会自动检测 OpenClaw、装插件、注册通道、生成登录二维码。二维码出来后用手机微信扫，扫完通道就注册好了。
如果安装时在 skills 配置那步没勾微信，也可以稍后手动跑上面这条命令补装。装完检查：
openclaw skills list列表里能看到 weixin 相关的 skill 就对了。
4. 验证请求：从命令行对话到微信收发消息
4.1 先验证模型通道通不通
在配微信之前，先确认模型调用没问题。启动 OpenClaw 的 TUI：
openclaw安装引导里如果问启动方式，选Hatch in TUI (recommended)，直接在终端里跑，日志和状态实时可见，调试方便。进去后随便发一句：
你好，帮我写一个 bash 函数，判断文件是否存在如果模型正常返回，说明 TaoToken 通道配对了。如果报错，看下面的排障部分。
4.2 验证微信消息通道
微信插件装好、二维码扫完之后，在手机微信里找到 ClawBot 对应的会话，发一条消息，比如「现在几点」。服务器侧 TUI 里应该能看到消息进来的日志，然后模型返回，手机微信收到回复。
这一步成功，说明整条链路通了：微信 → 插件 → OpenClaw → TaoToken → 模型 → 原路返回。
4.3 用 curl 单独验证 TaoToken 通道
如果 TUI 里报错，想排除是 OpenClaw 的问题还是通道的问题，可以直接 curl 打一发：
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "ping"}] }'返回里有choices字段和内容，说明 Key 和 Base URL 都没问题，问题在 OpenClaw 配置侧。返回 401 就是 Key 错了，返回模型不存在就是 Model ID 写错了。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
5.1 401 Unauthorized
最常见。原因就三个：Key 复制时带了空格、Key 已失效、Base URL 写错。先检查配置文件里的 Key 有没有多余空白，再回 TaoToken 控制台确认 Key 还在。Base URL 必须是https://taotoken.net/api，不要多加/v1或漏掉。
5.2 local proxy failed
这个报错通常出现在 OpenClaw 启动时，意思是本地代理层没起来。多半是端口被占或 Node.js 版本不对。先确认node -v是 v22 以上，再查端口：
ss -tlnp | grep openclaw如果端口被别的进程占了，改 OpenClaw 配置里的端口，或者杀掉占用进程。
5.3 reading 'choices' 报错
类似Cannot read properties of undefined (reading 'choices')，说明返回体里没有choices字段。一般是模型返回了错误结构，比如 Model ID 不存在、或者通道返回了非标准格式。先用 4.3 的 curl 验证通道，确认 Model ID 拼写。TaoToken 的模型 ID 在模型对话页面能看到准确的写法，别自己猜。
5.4 OAuth 相关报错
如果你同时用 Claude Code 或 Codex，可能会碰到 OAuth token 过期。这类工具和 OpenClaw 共用凭证时容易冲突。建议 OpenClaw 单独用 TaoToken 的 Key，不要和 Claude Code 的 OAuth 混用。Claude Code 那边如果也要走 TaoToken，在它的 settings 里单独配 Base URL 和 Key，别复用 OpenClaw 的配置。
5.5 微信插件装了但收不到消息
先openclaw skills list确认插件在。再看 TUI 日志有没有消息进来的记录。如果日志里没有，说明二维码扫码那步没成功，重新跑npx -y @tencent-weixin/openclaw-weixin-cli@latest install生成新二维码。手机微信版本低于 8.0.70 也会导致扫码失败，先升级。
6. 把模型调用收口到 TaoToken：长期维护的省心做法
跑通之后，日常维护其实就两件事：模型通道和微信通道。微信通道装好基本不用动，模型通道才是会经常调整的——今天想试新模型，明天想换便宜的，后天某个模型限流了要切备用。
如果每个模型单独配 Key，配置文件会越来越乱，换的时候还容易漏改。用 TaoToken 统一入口之后，所有模型共用一个 Key 和 Base URL，切换只改 Model ID 一行。OpenClaw 的config.json里default字段改一下，重启就生效。
如果你要长期跑编码类或 Agent 类任务，可以看看 TaoToken 的 Coding Plan，额度模型更适合持续调用。日常调试和验证模型效果，用模型对话页面就够了。接入文档里有各语言和工具的配置示例，OpenClaw 这种自定义配置也能参考。
最后给个实用技巧：把 OpenClaw 的配置和启动做成 systemd 服务，服务器重启后自动拉起，不用每次手动敲命令。写一个/etc/systemd/system/openclaw.service：
[Unit] Description=OpenClaw AI Assistant After=network.target [Service] Type=simple User=你的用户名 ExecStart=/usr/bin/openclaw Restart=on-failure RestartSec=5 [Install] WantedBy=multi-user.target然后：
sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw sudo systemctl status openclaw状态是 active (running) 就说明服务起来了。之后看日志用journalctl -u openclaw -f，比盯着 TUI 方便。微信那边发消息，服务器日志里能看到完整链路，出问题一眼定位。
