1. 为什么要在京东云上跑 OpenClawOpenClaw曾用名 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite Coding Plan 相关可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。注意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 换成 yumsudo 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.jsonWindowsC:\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 换成网关的 Keymodel_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京东云安全组是否放行 18789gateway.host 是否设成 0.0.0.0。三个都对了还不行重启服务再试。端口被占用查占用进程lsof -i:18789拿到 PID 后 kill 掉或者改 gateway.port 换一个端口。模型调用失败、权限不足检查 API Key 是否复制完整有没有多余空格确认百炼账号已完成实名认证确认 Coding Plan 额度充足model_name 是否拼写正确。这四点逐个排除。AI 回复为空在 model 配置里加reasoning: false重启服务。部分模型在特定参数下会返回空内容这个开关能规避。响应超时把 timeout 从 30 调到 60max_tokens 从 2048 降到 1024减少单次生成量。同时检查服务器出网是否正常curl -I https://dashscope.aliyuncs.com看能不能通。技能安装后不生效先openclaw skill list确认装上了然后openclaw gateway restart重启网关。技能是网关启动时加载的不重启不会生效。Linux/macOS 权限不足全局安装加 sudosudo 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。Coding Plan 的订阅入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 模型对话调试在 https://taotoken.net/model-conversation?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。控制台统一在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。第五日志要会看。openclaw logs --follow能实时输出运行日志模型调用失败、技能加载异常、端口冲突这些都会打在里面。排障时先看日志比盲猜快得多。最后京东云轻量服务器如果只是跑 OpenClaw1核2GB 够用但如果同时跑多个 Skills 或者并发请求多建议升到 2核4GB。按量计费的实例可以先用低配试稳定了再升配成本可控。
1. 为什么要在京东云上跑 OpenClawOpenClaw曾用名 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite Coding Plan 相关可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。注意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 换成 yumsudo 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.jsonWindowsC:\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 换成网关的 Keymodel_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京东云安全组是否放行 18789gateway.host 是否设成 0.0.0.0。三个都对了还不行重启服务再试。端口被占用查占用进程lsof -i:18789拿到 PID 后 kill 掉或者改 gateway.port 换一个端口。模型调用失败、权限不足检查 API Key 是否复制完整有没有多余空格确认百炼账号已完成实名认证确认 Coding Plan 额度充足model_name 是否拼写正确。这四点逐个排除。AI 回复为空在 model 配置里加reasoning: false重启服务。部分模型在特定参数下会返回空内容这个开关能规避。响应超时把 timeout 从 30 调到 60max_tokens 从 2048 降到 1024减少单次生成量。同时检查服务器出网是否正常curl -I https://dashscope.aliyuncs.com看能不能通。技能安装后不生效先openclaw skill list确认装上了然后openclaw gateway restart重启网关。技能是网关启动时加载的不重启不会生效。Linux/macOS 权限不足全局安装加 sudosudo 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。Coding Plan 的订阅入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 模型对话调试在 https://taotoken.net/model-conversation?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。控制台统一在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。第五日志要会看。openclaw logs --follow能实时输出运行日志模型调用失败、技能加载异常、端口冲突这些都会打在里面。排障时先看日志比盲猜快得多。最后京东云轻量服务器如果只是跑 OpenClaw1核2GB 够用但如果同时跑多个 Skills 或者并发请求多建议升到 2核4GB。按量计费的实例可以先用低配试稳定了再升配成本可控。
