1. 为什么小白在京东云装 OpenClaw 总卡在第一步OpenClaw 是一个轻量化的开源 AI 智能体执行框架你可以把它理解成一个「能听懂人话、还能自己动手干活」的机器人管家。它支持自然语言指令驱动、多模型灵活切换以及全场景任务自动化。适合谁适合想自己搭一个 7×24 小时在线 AI 服务、又不想从零写代码的普通用户。而京东云轻量云主机就是承载它的那块「地基」。很多人第一次接触云服务器脑子里全是问号实例怎么选、镜像挑哪个、端口在哪放行、API Key 填哪里。我见过太多人卡在「买了服务器却连不上」这一步最后误以为是 OpenClaw 装不上其实是网络和配置没打通。这篇就按「京东云部署 OpenClaw 配置阿里云百炼 API」这条链路把每一步拆到能直接复制执行。先说清楚整体链路京东云轻量云主机负责跑 OpenClaw 服务阿里云百炼负责提供大模型能力比如千问 Qwen 系列两者通过 API Key 和 Base URL 对接。你最终会得到一个浏览器能打开的对话页面输入问题就能拿到模型回复。部署前你需要准备三样东西。第一一个已完成实名认证的京东云账号确保没有欠费。第二一个阿里云百炼账号开通服务后创建 API Key新用户通常有免费额度可以先试。第三一个记事本用来记录公网 IP、API Key 这些凭证别嫌麻烦后面排查问题全靠它。实例配置上给个参考2 核 4GB 内存起步低于 2GB 很容易在启动服务时崩掉系统盘 40GB 够用带宽 5Mbps 能保证控制台访问不卡。地域选离你近的延迟低。购买时长新手先选 1 个月按量付费跑通再转包年包月避免浪费。这里有个关键点镜像选择。如果你在京东云市场里能找到预置 OpenClaw 的应用镜像直接选它省去手动装 Node.js 和依赖的麻烦。如果只有纯净系统镜像那就选 Ubuntu 22.04 或 Debian 12后面手动装。两种路径我都会给命令。注意OpenClaw 默认 Web 控制台走 18789 端口这个端口必须在京东云安全组里放行否则你浏览器永远打不开。这是新手最高频的坑没有之一。2. TaoToken 前置把模型调用通道先打通在正式配置 OpenClaw 之前我建议你先把模型调用这条通道理顺。因为 OpenClaw 本身只是个「壳」它需要对接一个能响应请求的大模型服务。你可以直接用阿里云百炼的官方接口也可以走 TaoToken 这类聚合入口来统一管理 Key 和模型。TaoToken 的定位是模型调用入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是让你用一个统一的 Base URL 和 Key去调用包括千问在内的多种模型省得在多个平台之间来回切换配置。为什么要在 OpenClaw 部署前先搞这个因为 OpenClaw 的模型配置项里Base URL 和 API Key 是必填的。你提前把 Key 拿到手部署完直接填进去整个流程就顺了。如果等装完再去找 Key中间容易断档。具体操作先访问模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 确认你要用的模型 ID比如千问系列的某个版本。然后去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 创建一个 Key复制保存。这个 Key 就是你后面填进 OpenClaw 配置里的凭证。如果你打算长期跑编码类任务或者 Agent 自动化可以看看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对高频调用场景做了额度优化。控制台入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置问题可以先翻文档。这里要强调一点TaoToken 是合规的模型调用入口不是所谓的「中转」灰色服务。你用它就是为了统一管理调用凭证减少配置复杂度。每段配置我都会给出完整的 Base URL、Key 占位符和 Model ID你照着填就行。提示Key 只在创建时显示一次务必立即复制到记事本。丢了只能重新创建旧 Key 作废。3. 京东云实例创建与 OpenClaw 可复制配置这一节是核心操作区我会给出京东云实例创建的关键参数以及 OpenClaw 的完整配置文件片段。你按顺序执行即可。3.1 京东云轻量云主机创建参数登录京东云控制台进入轻量云主机购买页。关键参数如下配置项推荐值说明地域华北-北京离百炼接口近延迟低镜像Ubuntu 22.04 LTS若无 OpenClaw 应用镜像则选此规格2 核 4GB最低稳定配置系统盘40GB SSD够装依赖和日志带宽5Mbps控制台访问流畅登录方式设置 root 密码新手免密钥对简化操作创建完成后在实例详情页记录公网 IP。然后进入安全组放行 18789 端口TCP。如果京东云提供「一键放通」就用它没有就手动加规则入方向协议 TCP端口 18789源 0.0.0.0/0。3.2 连接服务器并安装依赖用京东云 Web 终端或本地 SSH 连接ssh root你的京东云公网IP连上后先更新系统并安装 Node.js 20apt update apt upgrade -y curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install -y nodejs git node -v npm -v确认 Node 版本在 20 以上。然后安装 OpenClawnpm install -g openclaw openclaw --version如果提示命令找不到检查 npm 全局路径是否在 PATH 里执行npm config get prefix看路径再把它加到环境变量。3.3 OpenClaw 配置文件片段JSONOpenClaw 的配置可以走命令行也可以直接写配置文件。我建议直接写一份config.json路径在/root/.openclaw/config.json不同版本可能略有差异用openclaw config path确认。内容如下{ models: { default: { model: bailian/qwen3-max }, providers: { bailian: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [qwen3-max, qwen3.5-plus], contextWindow: 128000, maxTokens: 8192, temperature: 0.7 } } }, gateway: { port: 18789, host: 0.0.0.0 } }这里 Base URL 填的是 TaoToken 的 API 地址Key 填你在第 2 节创建的 KeyModel ID 填模型对话页面确认过的名称。三件套齐了Base URL Key Model ID。如果你更习惯命令行等价操作是openclaw config set models.providers.bailian.baseUrl https://taotoken.net/api openclaw config set models.providers.bailian.apiKey sk-你的TaoToken密钥 openclaw config set models.providers.bailian.models [qwen3-max,qwen3.5-plus] openclaw config set models.default.model bailian/qwen3-max openclaw gateway restart3.4 启动服务与守护进程openclaw onboard --install-daemon openclaw gateway start openclaw gateway status看到running就说明服务起来了。如果没起来用openclaw logs -f看日志常见原因是端口被占或配置 JSON 格式错误。4. 验证请求确认服务真的跑通了服务起来不等于能用必须做一次真实请求验证。这一步很多人跳过结果后面出问题不知道是哪层坏了。4.1 浏览器访问控制台在浏览器输入http://你的京东云公网IP:18789。如果打不开先检查三件事安全组 18789 是否放行、服务器内部防火墙是否拦截、OpenClaw 进程是否在跑。服务器内部防火墙放行命令Ubuntu 用 ufwufw allow 18789/tcp ufw reload ufw status | grep 187894.2 命令行测试模型连接openclaw model test如果返回 success说明 Base URL 和 Key 都通了。再发一条真实对话openclaw chat 用一句话介绍你自己10 秒内收到回复且没有报错就说明整条链路打通了。如果报invalid api key回去检查 Key 有没有多余空格如果报connection timeout检查 Base URL 是否写错、服务器能否访问外网。4.3 检查配置完整性openclaw doctor openclaw config get models.providers.bailiandoctor会帮你检查配置项有没有缺失config get用来确认写入的值和你预期一致。这两个命令在排查时非常有用。注意每次改完配置必须执行openclaw gateway restart否则新配置不生效。这是新手第二大坑。5. 本篇常见报错排查对照这一节按真实报错来对照你遇到哪个就查哪个。报错一401 Unauthorized / invalid api key原因通常是 Key 复制错误、Key 已失效、或者 Base URL 和 Key 不匹配。解决重新去 API Keys 页面创建 Key确认复制时没有换行和空格然后重新写入配置并重启。报错二local proxy failed / connection refused这个多半是网络层问题。先ping taotoken.net看能不能通再curl -I https://taotoken.net/api看返回码。如果服务器本身出不了外网检查京东云安全组的出方向规则默认应该是全放行的。报错三reading choices 相关解析错误这通常是模型返回格式和 OpenClaw 预期不一致。检查 Model ID 是否写对比如把qwen3-max写成了不存在的版本。回到模型对话页面确认可用模型列表只填列表里的 ID。报错四OAuth 相关报错如果你在配置里误开了 OAuth 认证模式而实际用的是 API Key 模式就会报这个。检查配置文件里有没有多余的 auth 字段删掉后重启。报错五端口占用 / address already in use说明 18789 被别的进程占了。执行lsof -i:18789找到进程kill 掉或者改 OpenClaw 的 gateway 端口。报错六配置文件 JSON 解析失败用python3 -m json.tool /root/.openclaw/config.json校验格式常见问题是多了逗号或少了引号。如果你用的是 Cline MCP 或 Codex 的 auth.json 方式接入同样要保证三件套齐全Base URL 填https://taotoken.net/apiKey 填你的 KeyModel ID 填确认过的模型名。CC Switch 切换配置时也要同步这三项缺一个都会报错。排障时优先看日志openclaw logs -f | grep -i error错误信息基本都会打出来。6. 跑通之后长期使用与接入文档服务跑通只是开始。如果你打算长期用 OpenClaw 做编码辅助或 Agent 自动化建议把调用额度规划好避免中途断掉。Coding Plan 页面有针对高频场景的说明可以先了解再决定。日常维护记住几条命令openclaw gateway status看状态openclaw logs -f看日志openclaw doctor --fix修配置异常openclaw models list看已配置模型。切换默认模型用openclaw models set bailian/qwen3.5-plus改完记得重启。备份配置也很重要一条 scp 命令搞定scp root你的京东云公网IP:/root/.openclaw/config.json ~/openclaw-backup.json恢复时反向 scp 回去再重启服务。如果你在接入过程中遇到配置项不确定的地方接入文档里有完整的参数说明和示例比到处搜零散答案靠谱。模型对话页面可以随时验证某个模型 ID 是否可用避免填错。API Keys 页面管理你的凭证定期轮换更安全。最后给个实用技巧把openclaw gateway status和openclaw model test做成一个检查脚本每次改完配置跑一遍能省掉大量来回排查的时间。跑通这条链路后你手里就有了一个随时能对话、能执行任务的 AI 服务后面扩展技能插件和多渠道集成都是在这个基础上加东西。