1. 华为云上跑 OpenClaw为什么值得折腾一次OpenClaw曾用名 Clawdbot是一个可以本地部署的 AI 智能体框架能通过自然语言指令完成文件管理、信息检索、内容处理、流程自动化这类实际操作还带记忆能力和插件扩展机制。说白了它不像普通聊天机器人只回你一段文字而是真的会去执行任务。适合谁适合想在自己服务器上跑一个可控智能体、又不想被各种平台绑定的人。我这次选华为云是因为手里正好有一台闲置的轻量服务器系统干净、公网 IP 固定拿来跑常驻服务很合适。整个流程从环境准备到服务可用实测下来两分钟左右能跑完前提是命令别抄错。核心链路是华为云服务器装 Node.js 22 → 全局装 OpenClaw → 用 TaoToken 统一 Key 打通模型通道 → 写一份 config.toml 骨架 → 启动网关 → 发一条验证请求确认 API 通道连通。这篇不绕弯子直接给可复制的命令和配置骨架。你照着敲遇到报错就翻第 5 节的排查表。模型通道这块我用的是 TaoToken 的统一 Key一个 Key 走多个模型省得在配置文件里来回换 base_url。2. 前置准备TaoToken 统一 Key 与华为云环境2.1 为什么用 TaoToken 统一 KeyOpenClaw 本身不带模型能力它得对接一个大模型 API 才能理解和生成内容。传统做法是每个模型厂商配一套 Key 和地址配置文件里塞一堆字段换模型就得改配置重启。TaoToken 的思路是给你一个统一入口API 地址固定为https://taotoken.net/api你用同一个 Key 就能调用不同模型config.toml 里只需要维护一份凭证。对 OpenClaw 这种要长期跑、可能随时切模型的场景来说这点很实用。你可以在模型对话里先试试哪个模型顺手再去 console 里生成正式 Key最后把 Key 填进 config.toml。整个流程不用改代码只改配置。2.2 华为云服务器基础配置我用的规格参考如下你按自己预算调整项目建议值说明实例规格1 核 2GB 及以上内存低于 2GB 启动容易崩系统盘40GB 以上装依赖和日志够用操作系统Ubuntu 22.04 / Debian 12命令通用性好安全组放行 18789OpenClaw Web 控制台默认端口登录方式SSH 或 Web 终端能敲命令就行安全组这一步别漏。华为云控制台进实例详情找到安全组规则入方向加一条 TCP 18789源地址按需填0.0.0.0/0或者你自己的 IP。不放行的话服务起来了你也访问不到 Web 控制台。2.3 环境检查登录服务器后先确认 Node.js 版本。OpenClaw 要求 Node.js 22.x 及以上node -v npm -v如果输出v22.x.x和对应的 npm 版本号说明环境可用。如果提示command not found先装 Node.js下一节给命令。3. 可复制配置从装 Node.js 到 config.toml 骨架3.1 安装 Node.js 22Ubuntu / Debian 系统直接走 NodeSource 源比手动解压省事sudo apt update sudo apt install -y curl git curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node -v最后一行应该输出v22.x.x。如果还是旧版本检查一下是不是系统里有多份 Node用which node看看路径。3.2 配置 npm 镜像并安装 OpenClaw国内服务器拉 npm 包有时候慢先换镜像npm config set registry https://registry.npmmirror.com npm install -g openclaw装完验证一下openclaw --version能输出版本号就说明全局安装成功。如果提示openclaw: command not found多半是 npm 全局 bin 目录没进 PATH执行npm config get prefix看看路径再把它加到 PATH 里。3.3 初始化配置openclaw onboard按提示走同意协议、选择快速启动、模型配置这一步先跳过我们后面手写 config.toml、通道按需启用。初始化完成后会在用户目录下生成配置文件夹。3.4 写 config.toml 骨架OpenClaw 的配置文件路径Linux 下一般是~/.openclaw/config.toml。如果目录不存在就手动建mkdir -p ~/.openclaw然后写入下面这份骨架。注意这是 TOML 格式不是 JSON字段名和层级别抄错# ~/.openclaw/config.toml # OpenClaw 网关基础配置 [gateway] host 0.0.0.0 port 18789 # TaoToken 统一 Key 接入 [model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken统一Key model_name claude-sonnet-4-5 max_tokens 2048 temperature 0.7 timeout 60 reasoning false # 日志 [log] level info几个关键点解释一下。base_url固定写https://taotoken.net/api不要带多余路径。api_key换成你在 TaoToken console 里生成的 Key。model_name按你实际要用的模型填不确定就先在模型对话里试。reasoning false是防止某些模型返回空回复这个坑我踩过加上就正常了。3.5 启动网关openclaw gateway start启动后确认状态openclaw gateway status看到 running 就说明服务起来了。浏览器打开http://你的服务器公网IP:18789能进 Web 控制台就成功了一大半。4. 验证请求确认 API 通道真的连通服务起来不等于模型通道通。很多人卡在这一步Web 控制台能打开但发消息没反应。所以必须单独验证一次 API 调用。4.1 用 curl 直接打 TaoToken 接口先绕过 OpenClaw直接测 Key 和地址对不对curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken统一Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字连通}], max_tokens: 32 }如果返回 JSON 里choices[0].message.content有内容说明 Key、地址、模型名三者都对。如果返回 401是 Key 问题返回 404是地址或模型名问题返回超时检查服务器出网是否正常。4.2 在 OpenClaw 里发一条指令回到 Web 控制台输入一句简单指令比如「列出当前目录下的文件」。如果 OpenClaw 能返回执行结果说明整条链路——网关、配置、模型通道——全部打通。也可以看日志确认openclaw logs --follow日志里会打印每次模型请求的状态码和耗时。看到 200 就放心了。4.3 设置开机自启服务器重启后服务别丢加一条自启sudo tee -a /etc/rc.local EOF /usr/bin/openclaw gateway start EOF sudo chmod x /etc/rc.local不同系统自启方式不一样systemd 更稳但 rc.local 够用且简单。5. 本篇常见错排查5.1 启动类报错openclaw: command not found出现频率最高。先npm config get prefix看全局路径再确认该路径下的 bin 目录在 PATH 里。临时解决可以export PATH$PATH:$(npm config get prefix)/bin永久解决写进~/.bashrc。服务启动后自动退出九成是内存不够。1 核 1GB 的机器跑 OpenClaw 很吃力升到 2GB 或者关掉其他占内存的进程。用openclaw logs看具体错误。5.2 端口与访问问题Web 控制台打不开按顺序查三件事openclaw gateway status确认服务在跑华为云安全组确认 18789 已放行服务器本机防火墙确认没拦。三者缺一不可。端口被占用的话Linux 下这样查lsof -i:18789 kill -9 进程ID5.3 模型通道报错返回 401Key 错了或者没带Bearer前缀。返回 404base_url写错确认是https://taotoken.net/api而不是别的路径。返回空内容在 config.toml 里加reasoning false再重启。响应超时就把timeout从 60 调到 90同时把max_tokens降到 1024 试试。如果 curl 能通但 OpenClaw 不通多半是 config.toml 格式问题TOML 对引号和层级敏感用openclaw config validate检查一下。5.4 配置文件写入失败提示权限不足时确认当前用户对~/.openclaw目录有读写权限。实在乱了就openclaw onboard --reset重新初始化再手动补 config.toml。6. 接下来怎么走服务跑起来只是起点。如果你打算长期用 OpenClaw 做编码辅助或者跑 Agent 任务建议去 Coding Plan 看看按次计费比按 token 更适合高频调用场景。想先试模型效果的直接进模型对话发几条指令感受一下。Key 管理和生成在 console 里接入细节翻接入文档。我自己的习惯是新服务器先跑通 curl 验证再写 config.toml最后启动网关。顺序反了容易在排查时分不清是网络问题还是配置问题。另外 config.toml 改完一定要重启网关不然不生效——这个我忘了好几次白等半天。
