1. 为什么要在京东云上跑 OpenClaw以及它到底解决什么问题OpenClaw曾用名 Clawdbot是一个可以本地部署、带记忆和插件扩展机制的 AI 智能体框架。简单说你给它一句自然语言指令它能帮你操作文件、检索信息、处理内容、跑自动化流程而 Skills 就是给它加装的一个个「技能包」。适合谁适合想把 AI 从「聊天窗口」拉到「真实干活」这一步的开发者、运维、独立开发者以及想在自己服务器上长期挂一个可控智能体的同学。这次场景聚焦在京东云环境下的新手集成路径。为什么选京东云一是轻量云主机开箱即用二是国内网络访问稳定三是按量/包月成本可控。整条链路我拆成三段环境准备 → OpenClaw 安装与网关启动 → 大模型 API Key 与 Skill 配置。全程目标 8 分钟跑通第一个 Skill 调用。需要提前说清楚一个关键点OpenClaw 本身不带模型能力它必须对接一个大模型 API 才能理解指令和生成结果。所以「大模型 API Key 怎么配」是整条链路里最容易卡住的地方。这篇会用 TaoToken 统一 Key 的方式接入把模型对话、编码、Agent 场景的 Key 收敛到一个入口省得你在多个平台之间来回切换。下面所有命令和配置都可以直接复制我按「先跑通、再优化」的顺序写遇到报错先别慌第五节有专门的排查清单。2. 前置准备京东云主机与 TaoToken 统一 Key2.1 京东云轻量主机的基础配置在京东云控制台创建一台轻量云主机配置参考如下项目建议值说明实例规格2 核 2GB 及以上OpenClaw 网关常驻1GB 容易 OOM系统盘40GB 以上依赖 日志 技能包操作系统Ubuntu 22.04 / Debian 12本文命令以 Ubuntu 系为准安全组放行 18789Web 控制台默认端口登录方式SSH 密钥或密码建议密钥登录后先做一次系统更新把 curl、git 装上sudo apt update sudo apt upgrade -y sudo apt install -y curl git2.2 安装 Node.js 22OpenClaw 依赖 Node.js 22.x 及以上。用 NodeSource 源安装最省事curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node -v npm -v能打印出v22.x.x和对应的 npm 版本就说明环境 OK。如果提示command not found说明上一步没装成功重跑一遍安装命令。2.3 配置 npm 镜像并安装 OpenClaw国内拉包慢是常态先切镜像npm config set registry https://registry.npmmirror.com sudo npm install -g openclaw openclaw --version2.4 获取 TaoToken 统一 KeyTaoToken 的定位是把大模型 API Key 统一管理一个 Key 覆盖模型对话、编码、Agent 等场景。操作路径打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建一个新 Key复制保存好后面配置要用。如果你打算长期跑编码或 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按次计费比按 token 更适合高频调用。注意API 基础地址是 https://taotoken.net/api 配置时不要带 UTM 参数只填这个干净的地址。Key 拿到后先别急着写进配置下一节我们统一处理。3. 可复制配置config.toml 骨架与 settings.json 示例3.1 初始化 OpenClawopenclaw onboard按提示走同意协议 → 选择快速启动 → 模型配置先跳过我们手动写→ 启用全部通道。初始化完成后配置目录一般在~/.openclaw/。3.2 config.toml 骨架OpenClaw 的主配置用 TOML 格式下面这份骨架可以直接复制把api_key换成你自己的 TaoToken Key# ~/.openclaw/config.toml [gateway] host 0.0.0.0 port 18789 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_name gpt-4o-mini max_tokens 2048 temperature 0.7 timeout 60 reasoning false [skills] auto_load true path ~/.openclaw/skills [log] level info几个参数说明一下base_url固定填 TaoToken 的 API 地址provider用openai-compatible是因为 TaoToken 走的是兼容 OpenAI 的协议reasoning设成 false 可以避免部分模型返回空内容timeout给到 60 秒网络抖动时不容易断。3.3 settings.json 示例部分 Skill 会读取独立的 settings.json比如搜索类技能需要单独的 Key。示例{ skills: { tavily-search: { enabled: true, api_key: tvly-你的搜索Key, max_results: 5 }, summarize: { enabled: true, max_length: 500 }, agent-browser: { enabled: true, headless: true } }, runtime: { concurrency: 2, retry: 3 } }把这份文件放到~/.openclaw/settings.json和 config.toml 同级。3.4 启动网关openclaw gateway start openclaw gateway status看到running就说明服务起来了。浏览器打开http://你的京东云公网IP:18789能进控制台页面即成功。4. 验证请求跑通第一个 Skill 调用4.1 安装技能管理工具sudo npm install -g clawhub4.2 安装一个搜索技能clawhub install tavily-search clawhub install summarize openclaw skill listskill list能列出已安装技能就说明 clawhub 工作正常。4.3 重启网关加载技能openclaw gateway restart openclaw skill status tavily-search状态显示active表示技能已加载。4.4 在控制台发起一次真实调用进入 Web 控制台输入一句自然语言指令比如帮我搜索「2026年 OpenClaw 集成实践」把前三条结果摘要成一段话如果模型配置正确、技能加载正常你会看到它先调用搜索技能拿到结果再调用大模型做摘要最后返回一段结构化文本。这一步跑通说明整条链路——京东云主机 → OpenClaw 网关 → TaoToken 统一 Key → 大模型 → Skill——全部打通。4.5 用命令行快速验证模型连通性不想开浏览器的话可以直接用 curl 测一下 TaoToken 的接口是否可达curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复一句链路正常}] }返回 JSON 里带choices字段就说明 Key 和网络都没问题。如果这里就报错那问题不在 OpenClaw而在 Key 或网络层先解决这一层再回去调 OpenClaw。5. 本篇常见错排查5.1 openclaw: command not found多半是全局安装没成功。重跑sudo npm install -g openclaw然后关掉终端重新打开。如果还不行检查npm root -g是否在 PATH 里。5.2 网关启动后自动退出最常见原因是内存不足。京东云主机建议 2GB 起步1GB 的实例跑网关 技能很容易被 OOM Killer 干掉。用openclaw logs看错误日志如果看到Killed字样就是内存问题升配或加 swap。5.3 无法访问 Web 控制台按顺序查三件事openclaw gateway status是否 running京东云安全组是否放行 18789config.toml里host是否设成0.0.0.0。三个都对了还进不去用curl http://127.0.0.1:18789在服务器本地测一下本地通说明是网络层问题。5.4 端口被占用sudo lsof -i:18789 sudo kill -9 进程ID或者直接改config.toml里的port换一个。5.5 模型调用失败、权限不足先确认 TaoToken Key 复制完整、没有多余空格再确认base_url填的是https://taotoken.net/api而不是带路径的完整 URL最后确认账户余额或套餐状态正常。这三步覆盖 90% 的调用失败。5.6 AI 回复为空在config.toml的[model]段里加上reasoning false然后openclaw gateway restart。部分模型在 reasoning 模式下会把内容放到思考字段里导致正文为空。5.7 响应超时把timeout从 60 调到 90同时把max_tokens从 2048 降到 1024。长输出 弱网络是超时的主要组合降 token 比加 timeout 更有效。5.8 技能安装后不生效clawhub install之后必须openclaw gateway restart技能才会被加载。用openclaw skill list确认已安装用openclaw skill status 名称确认已激活。5.9 权限不足导致安装失败Linux 下全局安装需要 sudosudo npm install -g openclaw sudo npm install -g clawhub如果不想每次 sudo可以配置 npm 的全局目录到用户空间但新手阶段直接用 sudo 最省事。6. 后续怎么走把 Key 和技能管理收敛起来跑通第一个 Skill 之后接下来大概率会遇到两个问题一是技能越装越多配置散落在多个文件里二是模型调用场景变多Key 管理开始混乱。我的建议是尽早把 Key 收敛到 TaoToken 统一管理模型对话、编码、Agent 场景共用一个入口换模型时只改model_name一个字段不用动 Key。如果你主要跑编码类任务可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按次计费对高频调用更友好。想先验证模型效果直接去模型对话 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试几句。接入过程中遇到报错先翻 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 确认 Key 状态再对照接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 核对参数格式。最后留一个我踩过的坑Skills 装多了之后settings.json里的concurrency别设太高2 到 3 就够了设太高反而会因为并发抢模型配额导致部分技能超时。这个值调一次就能明显感觉到稳定性差异。
