大家好，我是石头，一个有10多年java开发、项目管理经验的宝妈，专注于分享学习AI过程与经验。

不晓得是否有人遇到了和我一样的问题：明明配好了 API Key，启动 OpenClaw 却一直提示 API 未配置，重启、重装都没用。背景介绍下，朋友买了一台阿里云服务器，我有帮忙配置过，但是同时也让其他朋友帮忙设置了部分内容（我不知道他做了哪些操作），然后启动不了，我帮朋友排查后发现，根本不是配置错了，而是一台机器装了两套 OpenClaw + 权限混用，今天把完整原因、排查、修复一次性讲透。

一、问题核心原因（一句话讲清）

服务器上同时存在两套 OpenClaw：

1.系统级（root）：阿里云镜像预装，路径 /opt/openclaw/

2.用户级（admin）：自己后来重装，路径～/.local/share/pnpm/openclaw

两套程序抢同一个端口（XX），且配置文件不互通：

·用 admin 配置的 API

·但 root 先启动了服务，读的是 root 自己的空配置→ 所以系统一直提示：API 未配置。

二、完整排查步骤（照着敲就行）

1. 检查 API 配置是否生效

sudo openclaw config show

提示“找不到命令” → 说明sudo 环境没有 OpenClaw 路径，权限不互通。

2. 查看安装路径

which openclaw

返回：~/.local/share/pnpm/openclaw→ 这是用户级目录，sudo 无权访问。

3. 查看当前用户配置（正常有 API）

cat ~/.openclaw/openclaw.jso

能看到 API 信息 → 说明配置没问题。

4. 检查网关状态（必报错）

openclaw gateway status

两个报错：

·gateway token mismatch：令牌不匹配，RPC 连接失败

·Port 12707 already in use：端口被占用，启动失败

5. 查看进程（关键！找到双进程）

ps aux | grep openclaw

会看到两个进程：

·root 29500：老进程，占端口 XX

·admin 144487：新进程，抢不到端口一直报错

6. 验证 root 配置（空的！）

sudo cat /root/.openclaw/openclaw.json

里面没有 API 配置→ 实锤：root 读不到配置。

三、一键修复方案（直接复制）

1. 杀掉 root 占用端口的进程

sudo kill -9 29500

2. 用 admin 重启网关

systemctl --user restart openclaw-gateway.service

3. 解决 “请求频繁” 报错

启动后提示访问受限：

·清理浏览器 Cookie

·等待 1–3 分钟

·重新访问即可恢复

四、复盘：为什么会出现这个问题？

·阿里云镜像预装：自带一套 root 权限 OpenClaw（/opt/openclaw）

·又重装：用 admin 装了用户级版本（~/.local/share/pnpm/openclaw）

·结果：两套程序、两个配置文件、抢同一个端口

✅ 最佳实践：只用一套！要么用阿里云预装的 root 版，配置 /root/.openclaw/openclaw.json；要么卸载预装版，只用前面装的 admin 版。

五、终极避坑总结

1.OpenClaw 谁配置 API，就必须谁启动服务

2.一台机器只装一套，不要重复安装

3.root 与普通用户权限混用，100% 读不到配置

4.端口XX 被占 → 优先查是否有老进程在跑

如果这篇教程对你有帮助，随手点个点赞 /在看，想第一时间收到更多OpenClaw安全使用技巧，就给我加个星标吧～