1. 为什么要在京东云上跑 OpenClaw
OpenClaw（曾用名 Clawdbot）是一个可以本地部署的 AI 智能体框架，它能通过自然语言指令完成文件管理、信息检索、内容处理、流程自动化等实际操作，并且支持 Skills 插件扩展和本地记忆存储。简单说，它不像普通聊天机器人只会在对话框里回你话，而是能真正动手帮你干活——读写文件、跑命令、整理资料、定时提醒，这些都能通过对话触发。
适合谁用？如果你是开发者，想低成本搭一个属于自己的 AI 编码助手，能补全代码、解释报错、生成脚本，那 OpenClaw 配合百炼 Coding Plan 就是一套很顺手的组合。如果你是小团队，想在内网或云服务器上跑一个可控的智能体，数据不出自己的机器，OpenClaw 的本地优先设计也能满足。
那为什么选京东云？我实测下来，京东云轻量服务器在价格和网络稳定性上对国内开发者比较友好，尤其是按量或包月的小规格实例，1核2GB 就能跑起来，系统盘 40GB 足够。加上京东云的安全组配置直观，放行端口几步就能搞定，对新手来说门槛低。这篇就按“京东云轻量服务器 + OpenClaw + 百炼 Coding Plan”这条线，把环境初始化、Node.js 配置、OpenClaw 配置文件骨架、API 对接参数、验证动作和常见报错一次讲清楚。
2. 前置准备：TaoToken 与百炼 Coding Plan 的定位
在动手之前，先把两个关键东西理清楚：一个是模型 API 的接入方式，一个是 OpenClaw 本身的运行环境。
OpenClaw 本身不包含大模型，它需要对接一个模型服务来完成理解和生成。百炼 Coding Plan 是面向编码场景的订阅方案，按次收费，对高频写代码、跑 Agent 任务的用户来说比按 token 计费更省。你需要先在百炼控制台创建 API Key，这个 Key 后面要写进 OpenClaw 的配置文件。
如果你在接入过程中需要统一管理多个模型的 Key，或者想用一套兼容接口来切换不同模型，可以走 TaoToken 的 API 网关。它的接入地址是 https://taotoken.net/api ，不额外加参数。模型对话调试可以走 https://taotoken.net/model-conversation?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，Coding Plan 相关可以看 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，API Keys 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite 。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite 。
注意：OpenClaw 的模型配置里，base_url 要填你实际使用的接口地址。如果用百炼原生接口，就填百炼的地址；如果走统一网关，就填网关地址。两者不要混填。
环境方面，OpenClaw 依赖 Node.js 22.x 及以上版本。京东云轻量服务器默认的 Alibaba Cloud Linux 或 Ubuntu 镜像里 Node 版本可能偏低，所以第一步就是升级 Node。下面从服务器初始化开始。
3. 京东云环境初始化与 Node.js 22 配置
登录京东云控制台，创建一台轻量应用服务器。规格选 1核2GB 内存起步，系统盘 40GB 以上，镜像选 Ubuntu 22.04 或 Alibaba Cloud Linux 3 都行。创建完成后，在安全组里放行 18789 端口，这是 OpenClaw Web 控制台的默认端口。登录方式用 Web 终端或 SSH 都可以。
连上服务器后，先更新系统并安装基础工具：
sudo apt update -y && sudo apt upgrade -y sudo apt install -y curl git xz-utils如果你用的是 Alibaba Cloud Linux 或 CentOS 系，把 apt 换成 yum：
sudo yum update -y sudo yum install -y curl git xz接下来安装 Node.js 22。推荐用官方二进制包解压到 /usr/local，这样版本可控，不依赖系统包管理器：
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node22.tar.xz sudo tar -xJf node22.tar.xz -C /usr/local sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm验证版本：
node -v npm -v正常应该输出 v22.0.0 和对应的 npm 版本号。如果提示 command not found，检查软链接路径是否正确，或者重新执行 ln -sf 那两行。
然后配置 npm 镜像，国内服务器拉包会快很多：
npm config set registry https://registry.npmmirror.com到这里，京东云的基础环境就准备好了。整个过程大概两三分钟，剩下的就是装 OpenClaw 和写配置。
4. OpenClaw 安装与配置文件骨架
安装 OpenClaw 用全局 npm 安装：
npm install -g openclaw安装完成后执行初始化：
openclaw onboard按提示走：同意协议、选择快速启动、暂时跳过模型配置（后面手动写）、启用全部通道。初始化会在用户目录下生成配置文件夹，路径是：
- Linux/macOS：
~/.openclaw/config.json - Windows：
C:\Users\用户名\.openclaw\config.json
先设置网关监听地址和端口，让外部能访问 Web 控制台：
openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789然后直接编辑配置文件，写入模型对接参数。下面是一个完整的配置骨架，你可以按自己的 Key 替换：
{ "gateway": { "host": "0.0.0.0", "port": 18789 }, "model": { "type": "openai", "api_key": "你的百炼APIKey", "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1", "model_name": "qwen-plus", "max_tokens": 2048, "temperature": 0.7, "timeout": 60, "reasoning": false } }几个参数说明一下。type 填 openai 是因为百炼提供了兼容 OpenAI 的接口格式，这样 OpenClaw 能直接识别。base_url 填百炼的兼容模式地址。model_name 按你订阅的 Coding Plan 里可用的模型填，比如 qwen-plus、qwen-coder 等。timeout 建议设 60，编码任务响应可能偏长。reasoning 设 false 可以避免部分模型返回空内容。
如果你走统一网关，把 base_url 换成 https://taotoken.net/api ，api_key 换成网关的 Key，model_name 按网关支持的模型名填。改完保存，重启网关：
openclaw gateway restart启动服务：
openclaw gateway start设置开机自启，避免服务器重启后服务没起来：
echo "/usr/bin/openclaw gateway start" | sudo tee -a /etc/rc.local sudo chmod +x /etc/rc.local5. 验证请求：对话与代码补全是否生效
服务起来后，浏览器打开http://服务器公网IP:18789，应该能看到 OpenClaw 的 Web 控制台。如果打不开，先检查服务状态：
openclaw gateway status确认 running 之后，再检查京东云安全组是否放行了 18789 端口。这两个都对了，页面就能出来。
进入控制台后，先做一次最简单的对话验证。在输入框里发一句：
你好，请用一句话说明你能做什么如果模型配置正确，几秒内会返回一段自然语言回复。如果返回为空，去配置文件里把 reasoning 改成 false，再重启网关。
接着验证代码补全能力。发一条带代码的指令：
帮我写一个 Python 函数，读取 CSV 文件并返回前 5 行，用 pandas 实现正常情况会返回完整的函数代码和简短说明。这一步能过，说明模型对接和生成链路都通了。
再验证一下 Skills 是否加载。先装技能管理工具：
npm install -g clawhub装一个常用技能，比如内容摘要：
clawhub install summarize查看已安装技能：
openclaw skill list重启网关让技能生效：
openclaw gateway restart然后在控制台里发一句“帮我摘要这段文字”，后面贴一段测试文本，看是否能触发摘要技能。能触发，说明 Skills 机制也正常。
6. 本篇常见错排查
部署过程中最容易卡在几个地方，这里按现象列出来。
openclaw: command not found说明全局安装没成功或 PATH 没包含 npm 全局目录。重新执行npm install -g openclaw，然后npm config get prefix看全局路径，把这个路径加到 PATH 里。或者关掉终端重新登录一次。
服务启动后自动关闭多半是内存不足。1核1GB 的实例跑 OpenClaw 会比较吃力，建议升到 2GB。本地跑的话，关掉其他占内存的程序。用openclaw logs看具体错误。
无法访问 Web 控制台按顺序查：openclaw gateway status看服务是否 running；京东云安全组是否放行 18789；gateway.host 是否设成 0.0.0.0。三个都对了还不行，重启服务再试。
端口被占用查占用进程：
lsof -i:18789拿到 PID 后 kill 掉，或者改 gateway.port 换一个端口。
模型调用失败、权限不足检查 API Key 是否复制完整，有没有多余空格；确认百炼账号已完成实名认证；确认 Coding Plan 额度充足；model_name 是否拼写正确。这四点逐个排除。
AI 回复为空在 model 配置里加"reasoning": false，重启服务。部分模型在特定参数下会返回空内容，这个开关能规避。
响应超时把 timeout 从 30 调到 60，max_tokens 从 2048 降到 1024，减少单次生成量。同时检查服务器出网是否正常，curl -I https://dashscope.aliyuncs.com看能不能通。
技能安装后不生效先openclaw skill list确认装上了，然后openclaw gateway restart重启网关。技能是网关启动时加载的，不重启不会生效。
Linux/macOS 权限不足全局安装加 sudo：sudo npm install -g openclaw。或者用 nvm 管理 Node，避免权限问题。
Windows 执行策略禁止运行脚本以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser无法写入配置文件检查当前用户对~/.openclaw/目录的读写权限。实在不行重新初始化：openclaw onboard --reset。
7. 后续接入与长期使用建议
环境跑通之后，如果你打算长期用 OpenClaw 做编码助手，有几个点值得注意。
第一，模型选择上，编码场景优先用专门优化的 coder 类模型，补全和解释报错的准确率会高一些。百炼 Coding Plan 里可选的模型在控制台能看到，按需切换。
第二，Skills 不要一次装太多。每个技能都会占用启动时间和内存，按实际需要装。常用的就搜索、摘要、文件管理这几个，够用了。
第三，配置文件的备份。~/.openclaw/config.json里存了 API Key，改之前先复制一份，改错了能快速回滚。
第四，如果你需要统一管理多个模型的 Key，或者在不同模型之间切换做对比，可以走 TaoToken 的 API Keys 管理页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite 。Coding Plan 的订阅入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，模型对话调试在 https://taotoken.net/model-conversation?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite 。控制台统一在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite 。
第五，日志要会看。openclaw logs --follow能实时输出运行日志，模型调用失败、技能加载异常、端口冲突这些都会打在里面。排障时先看日志，比盲猜快得多。
最后，京东云轻量服务器如果只是跑 OpenClaw，1核2GB 够用，但如果同时跑多个 Skills 或者并发请求多，建议升到 2核4GB。按量计费的实例可以先用低配试，稳定了再升配，成本可控。