1. 京东云上跑 OpenClaw 到底卡在哪从零部署的完整链路拆解OpenClaw 是一个开源的 AI 自动化助理平台能接入大模型 API、挂载 Skill 插件、通过 Web 面板或聊天通道执行任务。它适合想自建 AI 助理、又不想被单一厂商绑死的开发者和小团队。2026 年 4 月这个时间点很多人选择在京东云上部署原因很直接轻量云主机开箱即用、公网 IP 稳定、按量计费成本可控。但真正动手之后卡点往往不在 OpenClaw 本身而在三个环节的衔接上。第一个环节是环境初始化Node.js 版本、npm 镜像、目录权限、防火墙端口任何一项没对齐服务就起不来。第二个环节是大模型 API 接入Base URL 写错、Key 格式带空格、Model ID 对不上都会导致请求发出去了但返回空。第三个环节是 Skill 集成插件装了但没注册、注册了但没重启、重启了但权限不够表现就是「命令能跑功能不生效」。我试过在京东云轻量主机上从裸机开始走一遍全流程踩过的坑基本集中在「配置写了但没生效」这一类。核心原因是 OpenClaw 的配置分层环境变量、openclaw.json、Skill 自己的 manifest三层各管各的改错层等于没改。下面按部署顺序把每一步的可复制命令和验证方法都列出来你照着做就能跑通。先说清楚整体链路京东云主机 → 安装 Node.js 22 → 安装 OpenClaw CLI → 初始化配置 → 写入大模型 APIBase URL Key Model ID→ 启动 gateway → 放行端口 → 访问 Web 面板 → 安装并注册 Skill → 验证。这条链路里大模型 API 这一环我建议直接用 TaoToken 的兼容接口因为它同时支持多家模型Base URL 统一换模型只改 Model ID不用动其他配置。2. 京东云环境初始化与 OpenClaw 安装Node.js 22 与 npm 镜像配置京东云轻量云主机默认镜像一般是 Ubuntu 22.04 或 Debian 12登录后先确认系统版本和内存。OpenClaw 2026 稳定版要求 Node.js 22 及以上内存建议 2GiB 起步低于这个数 gateway 启动会 OOM。用free -h和node -v各查一次没有 Node 就先装。# 查看系统与内存 cat /etc/os-release | head -2 free -h # 安装 Node.js 22NodeSource 源 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 验证版本 node -v # 应输出 v22.x.x npm -vNode 装好后把 npm 镜像切到国内源否则装 OpenClaw 依赖会非常慢甚至超时。这一步不是可选项是必做项。npm config set registry https://registry.npmmirror.com/ npm config get registry # 确认输出 npmmirror 地址接下来安装 OpenClaw CLI 和 ClawHub 客户端。ClawHub 是 Skill 插件管理工具后面集成 Skill 全靠它。# 全局安装 OpenClaw 与 ClawHub npm install -g openclaw clawhub-cli # 验证安装 openclaw --version clawhub --version安装完成后先别急着 init先建好配置目录并确认权限。OpenClaw 默认读~/.openclaw/openclaw.json如果这个目录属主不对后面写配置会失败。mkdir -p ~/.openclaw chmod 700 ~/.openclaw ls -ld ~/.openclaw # 确认属主是你的登录用户到这一步环境初始化就完成了。很多人卡在openclaw: command not found原因通常是 npm 全局 bin 目录没进 PATH。用npm config get prefix看一下路径把它加到~/.bashrc里再source一次即可。另一个高频问题是 Node 版本低于 22openclaw init会直接报 engine 不匹配所以版本检查不能省。3. 大模型 API 接入配置openclaw.json 写入 Base URL、Key 与 Model ID这一节是全文最关键的部分因为大模型 API 配置错了后面所有 Skill 都是空转。OpenClaw 的模型配置写在~/.openclaw/openclaw.json里结构是models.default指定默认模型models.providers下面挂各个提供商的 Base URL、API Key 和模型列表。我建议用 TaoToken 的兼容接口作为 provider原因是它的 Base URL 统一为https://taotoken.net/api兼容 OpenAI 协议OpenClaw 不需要额外适配。API Key 在控制台生成格式是sk-开头。Model ID 按你实际要用的模型填比如claude-sonnet-4-20250514或gpt-4o这类。先创建或编辑配置文件nano ~/.openclaw/openclaw.json写入下面这段完整配置把sk-你的Key替换成你在 TaoToken 控制台生成的真实 Key{ models: { default: taotoken/claude-sonnet-4-20250514, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, models: [ { id: claude-sonnet-4-20250514, maxTokens: 8192 }, { id: gpt-4o, maxTokens: 4096 } ] } } }, gateway: { port: 18789, host: 0.0.0.0 } }这里三个字段必须对齐baseUrl是https://taotoken.net/api注意结尾不要多加/v1OpenClaw 会自己拼路径apiKey必须是sk-开头且无空格换行default里的 Model ID 必须和models数组里的id完全一致大小写都不能差。配置写完后用openclaw config reload让配置生效再启动 gatewayopenclaw config reload openclaw gateway start --daemon openclaw gateway status # 输出 active(running) 即成功如果你用的是 Claude Code 这类需要 Anthropic 协议的客户端TaoToken 也提供对应的接入点Base URL 同样是https://taotoken.net/apiKey 和 Model ID 复用上面这套。配置片段和上面 JSON 结构一致只是客户端不同字段名可能叫ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY值不变。注意配置文件里不要出现中文引号JSON 只认英文双引号。粘贴 Key 后建议用cat ~/.openclaw/openclaw.json | python3 -m json.tool校验一次格式格式错会导致 gateway 启动失败。4. 连通性验证与 Skill 集成从 model test 到 clawhub install 全流程配置写完不等于能用必须做连通性验证。OpenClaw 自带model test命令会向配置的 provider 发一次真实请求返回模型回复就说明 Base URL、Key、Model ID 三者都对。openclaw model test如果输出里有模型返回的文本说明大模型 API 接入成功。如果报 401是 Key 问题报local proxy failed是 Base URL 或网络问题报reading choices相关错误通常是返回体不是标准 OpenAI 格式检查 Base URL 是否写成了带/v1的地址。连通性通过后开始集成 Skill。ClawHub 是插件市场安装命令是clawhub install 技能名。装完必须重启 gateway否则 Skill 不会加载。# 安装常用 Skill clawhub install search # 联网搜索 clawhub install document-parser # 文档解析 clawhub install summarize # 文本总结 # 查看已安装列表 clawhub list # 重启 gateway 加载 Skill openclaw gateway restartSkill 注册的验证方法是看日志。openclaw logs -f实时输出重启后如果看到skill loaded: search这类行说明注册成功。如果装了但日志里没有检查 Skill 目录权限以及openclaw.json里有没有skills.enabled字段把它关掉了。Web 面板访问地址是http://你的京东云公网IP:18789首次访问需要 Token。生成 Token 的命令openclaw token generate拿到 Token 后拼到 URL 后面http://公网IP:18789?token你的Token。能打开对话界面并收到模型回复整条链路就算跑通了。京东云的安全组里要放行 18789 端口协议 TCP来源按需填测试阶段可以临时用0.0.0.0/0正式环境建议限制来源 IP。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 对照部署过程中报错集中在几类下面按真实错误信息对照排查。401 UnauthorizedKey 无效或格式错。检查openclaw.json里apiKey是否sk-开头、有没有多余空格换行。用echo -n sk-你的Key | wc -c数一下字符数和预期不符就是复制时带了隐藏字符。重新在 TaoToken 控制台生成一个 Key 替换。local proxy failedBase URL 不可达或写错。确认baseUrl是https://taotoken.net/api不要带/v1不要带结尾斜杠。在服务器上直接curl -I https://taotoken.net/api看能否通不通就是网络或 DNS 问题。reading choices 相关错误返回体不是标准 OpenAI 格式。常见原因是 Base URL 指向了非兼容端点或者 Model ID 填了一个该 provider 不存在的模型。把default和models[].id对齐只填 provider 支持的模型。OAuth 相关报错如果你用的是 Claude Code 或 Codex 这类需要 OAuth 的客户端报 OAuth 失败通常是回调地址或 token 过期。这类客户端接入 TaoToken 时Base URL 和 Key 用同一套OAuth 流程走客户端自己的不要手动改回调。Codex 的auth.json里如果出现base_url字段值填https://taotoken.net/apiapi_key填sk-Keymodel填 Model ID三件套缺一不可。gateway 启动后立即退出看openclaw logs -f最后几行。常见是端口被占用或配置文件 JSON 格式错。openclaw doctor会做一次系统健康检查把环境、配置、端口、依赖都过一遍报错信息比日志更直白。Skill 装了不生效先clawhub list确认装上了再openclaw logs -f看加载日志最后确认openclaw gateway restart执行过。三步都做了还不生效检查 Skill 是否要求额外的环境变量或 API Key。6. 长期运行与后续扩展Coding Plan 与 Skill 生态的衔接跑通之后下一步是让它稳定运行并扩展能力。京东云轻量主机支持按量计费长期跑建议选包月成本更低。gateway 用--daemon启动后是后台进程但服务器重启后不会自动拉起需要配 systemd 或 cron。简单做法是写一个 systemd unitsudo nano /etc/systemd/system/openclaw.service写入[Unit] DescriptionOpenClaw Gateway Afternetwork.target [Service] Typesimple User你的用户名 ExecStart/usr/bin/openclaw gateway start Restartalways [Install] WantedBymulti-user.target然后sudo systemctl enable --now openclaw这样开机自启、崩溃自动重启。如果你打算长期用 OpenClaw 做编码或 Agent 任务模型调用量会上去按 token 计费不如按次划算。TaoToken 的 Coding Plan 适合这种场景接入方式和上面 JSON 配置一样只是 Model ID 换成 Coding Plan 对应的模型。配置片段复用第 3 节的 JSON 结构把default和models[].id改成 Coding Plan 的模型即可。Skill 生态方面ClawHub 上的插件更新频繁建议定期clawhub update拉最新版。装新 Skill 前先用clawhub vet 技能名扫一遍风险避免装到会读敏感文件的插件。Web 面板的 Settings 里可以调日志级别排查问题时临时开到 debug稳定后调回 info减少磁盘占用。整条链路跑通后你手上就是一个能接多家模型、能挂 Skill、能通过 Web 面板或聊天通道调用的 AI 助理。后续换模型只改 Model ID加能力只装 Skill不用动部署层。这套结构的好处是解耦任何一层出问题都能单独替换不会牵一发动全身。