MacOS下openclaw网关重启失败：Service is loaded but not running 的 LaunchAgent 权限排查与 TaoToken 接入-拓冰网站定制

1. MacOS 下 openclaw 网关重启失败的真实场景与报错定位

如果你在 Mac 上装完 openclaw，Web UI 能打开，但 Gateway 一直连不上，终端里反复出现Service is loaded but not running (likely exited immediately)，那你不是一个人。这个报错的核心含义是：launchd 已经把你的 LaunchAgent 加载进内存了，但进程在启动后极短时间内就退出，导致端口 18789 始终处于 free 状态。换句话说，服务「被登记了」，但「没活下来」。

我先把典型症状列清楚，方便你对照。访问http://127.0.0.1:18789/时页面提示Gateway: 未检测到 connect ECONNREFUSED 127.0.0.1:18789；执行openclaw gateway restart后等待十几秒，报Gateway restart failed after 13s: service stayed stopped and port 18789 stayed free. Service runtime: status=stopped Gateway port 18789 status: free.。注意这里的关键词是status=stopped和port free，说明 launchd 认为服务没在跑，端口也没被占用。

为什么会出现「loaded but not running」？在 macOS 上，openclaw 的 Gateway 是通过用户级 LaunchAgent 托管的，plist 文件通常位于~/Library/LaunchAgents/ai.openclaw.gateway.plist。launchd 加载 plist 后，会按ProgramArguments去拉起 Node 进程。如果这个进程因为权限、路径、环境变量或日志目录不可写而立即崩溃，launchd 就会把它标记为 exited，于是你看到的就是「loaded but not running」。

我踩过的坑是：之前用sudo npm install -g openclaw装过一次，后来又sudo rm -rf ~/.openclaw清理，结果~/.openclaw、~/.npm-global、~/Library/LaunchAgents、~/Library/Logs/openclaw这几个目录的属主变成了root:staff。launchd 是以当前登录用户身份运行用户级 Agent 的，当它尝试写入日志或读取配置时被拒绝，进程就直接退出。这就是权限污染导致 Gateway 重启失败的根本原因。

所以排查顺序应该是：先确认服务状态，再看权限归属，最后重新加载 LaunchAgent。你可以先跑这几条命令建立基线认知：

launchctl print gui/$UID/ai.openclaw.gateway openclaw gateway status --deep ls -ld ~/.openclaw ~/.npm-global ~/Library/LaunchAgents ~/Library/Logs/openclaw

如果launchctl print显示state = exited或state = stopped，而ls -ld显示某些目录是root staff，那基本可以锁定是权限问题。接下来我会从 LaunchAgent 权限与运行环境两个角度，把可复制的修复流程和 TaoToken 接入配置一起讲清楚。

2. TaoToken 前置准备：Base URL、API Key 与模型 ID 三件套

在修好 Gateway 之后，你大概率会想把模型 endpoint 切到 TaoToken，让 openclaw 的 Agent 走稳定的 API 通道。这里先把「三件套」准备好：Base URL、API Key、Model ID。无论你后面用的是 Claude Code、Cline MCP 还是 Codex 的auth.json，这三个值都是必须写全的，缺一个都会导致认证失败或reading choices之类的解析报错。

TaoToken 的 API 地址是https://taotoken.net/api，注意这个地址不带任何查询参数，直接作为 Base URL 使用。API Key 需要你在控制台里创建，创建入口在https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，进去之后找到 API Keys 页面，新建一个 Key 并复制保存。Model ID 则根据你实际要调用的模型填写，比如 Claude 系列或其它兼容模型，具体以文档里的模型列表为准，文档地址是https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=。

为什么要在修 Gateway 之前先准备这些？因为 openclaw 的 Gateway 启动时会读取配置文件，如果配置里引用了不存在的 endpoint 或无效 Key，某些版本会在启动阶段就尝试做连通性探测，探测失败可能导致进程退出。虽然权限问题才是「loaded but not running」的主因，但把 endpoint 配错会叠加出更多迷惑性报错。所以我的建议是：先把权限修干净，再把 endpoint 改成 TaoToken，最后重启验证。

如果你只是想先验证模型能不能通，可以打开模型对话页面https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=直接发一条消息，确认 Key 和模型 ID 可用。这一步能帮你排除「Key 本身无效」的干扰。对于长期跑编码任务或 Agent 的场景，可以考虑 Coding Plan，入口在https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，它更适合高频调用。

这里要提醒一句：不要把 TaoToken 理解成某种「中转」或灰色通道，它就是一个标准的 API 服务入口，你按官方文档填 Base URL 和 Key 即可。配置时务必保证auth.json、settings.json或 plist 里的环境变量三处一致，否则会出现「本地能通、Gateway 里不通」的割裂现象。下面进入可复制配置环节。

3. 可复制配置：plist 权限修复与 TaoToken endpoint 接入片段

这一节是全文最核心的部分，我会给出可直接复制的 plist 片段、权限修复命令，以及把 endpoint 改到 TaoToken 的配置示例。先处理权限，再改配置，顺序不要反。

第一步，修复四个关键目录的属主。确认你希望这些文件归属当前用户，而不是 root：

sudo chown -R $(whoami):staff ~/.openclaw sudo chown -R $(whoami):staff ~/.npm-global sudo chown -R $(whoami):staff ~/Library/LaunchAgents sudo chown -R $(whoami):staff ~/Library/Logs/openclaw

执行完用ls -ld逐个确认，正常应该看到drwx------ $(whoami) staff ~/.openclaw、drwxr-xr-x $(whoami) staff ~/.npm-global、drwx------ $(whoami) staff ~/Library/LaunchAgents、drwxr-xr-x $(whoami) staff ~/Library/Logs/openclaw。如果~/Library/Logs/openclaw不存在，先mkdir -p ~/Library/Logs/openclaw再 chown，因为 launchd 需要这个目录来写 stdout/stderr，目录缺失或不可写都会让进程立即退出。

第二步，检查并修正 plist 文件本身的权限。路径是~/Library/LaunchAgents/ai.openclaw.gateway.plist，正确权限应该是-rw------- $(whoami) staff。如果显示root staff，执行：

sudo chown $(whoami):staff ~/Library/LaunchAgents/ai.openclaw.gateway.plist chmod 600 ~/Library/LaunchAgents/ai.openclaw.gateway.plist

第三步，给出一个可参考的 plist 配置片段。注意ProgramArguments里的路径要换成你自己的which openclaw结果，EnvironmentVariables里放入 TaoToken 的 Base URL 和 Key：

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>ai.openclaw.gateway</string> <key>ProgramArguments</key> <array> <string>/Users/你的用户名/.npm-global/bin/openclaw</string> <string>gateway</string> <string>start</string> </array> <key>EnvironmentVariables</key> <dict> <key>OPENAI_BASE_URL</key> <string>https://taotoken.net/api</string> <key>OPENAI_API_KEY</key> <string>你的TaoTokenKey</string> <key>OPENCLAW_MODEL</key> <string>你的ModelID</string> </dict> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> <key>StandardOutPath</key> <string>/Users/你的用户名/Library/Logs/openclaw/gateway.out.log</string> <key>StandardErrorPath</key> <string>/Users/你的用户名/Library/Logs/openclaw/gateway.err.log</string> </dict> </plist>

如果你用的是 Claude Code 或 Cline MCP，配置文件的写法不同，但三件套一致。以settings.json为例，可以写成：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "你的TaoTokenKey", "ANTHROPIC_MODEL": "你的ModelID" } }

如果是 Codex 的auth.json，则把 Base URL、Key、Model ID 分别填到对应字段，确保三处齐全。配置完成后，重新加载 LaunchAgent：

launchctl bootout gui/$UID ~/Library/LaunchAgents/ai.openclaw.gateway.plist launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.gateway.plist

如果bootout提示Could not find service，说明服务当前没加载，直接继续bootstrap即可。这一步做完，权限和 endpoint 就都到位了。

4. 验证请求与成功结果：launchctl print 与 gateway status 对照

配置改完不代表成功，必须用命令验证。先看 launchd 视角的状态：

launchctl print gui/$UID/ai.openclaw.gateway

正常输出里应该能看到state = running、active count = 1，并且pid是一个真实存在的进程号。如果还是state = exited，说明进程仍在启动后立即退出，需要去看~/Library/Logs/openclaw/gateway.err.log里的具体报错。这一步是区分「权限已修好但配置有误」和「权限仍未修好」的关键。

接着用 openclaw 自带命令做深度检查：

openclaw gateway restart openclaw gateway status --deep

成功时你会看到类似Runtime: running、Connectivity probe: ok、Listening: 127.0.0.1:18789的输出。Connectivity probe: ok表示 Gateway 已经能对外提供连接，Listening表示端口 18789 被正常占用。此时再访问http://127.0.0.1:18789/，页面上的Gateway: 未检测到提示应该消失，变成已连接状态。

为了确认 TaoToken endpoint 真的生效，可以触发一次模型调用。比如在 openclaw 的 Agent 会话里发一条简单消息，或者在模型对话页面https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=里测试同一个 Key 和 Model ID。如果两边都能返回结果，说明 Base URL、Key、Model ID 三件套配置一致且有效。如果 Gateway 里报认证错误而对话页面正常，那多半是 plist 里的环境变量没被正确读取，检查EnvironmentVariables的键名是否和 openclaw 期望的一致。

还有一个容易忽略的点：KeepAlive设为true时，launchd 会在进程退出后自动重启，这会让「exited immediately」表现为反复重启。如果你在日志里看到进程反复拉起又退出，不要以为是「服务在跑」，要看active count和pid是否稳定。稳定运行几分钟后pid不变，才算真正成功。

验证通过后，建议把openclaw gateway status --deep的输出保存一份，作为后续对比基线。因为一旦你再次用sudo操作过相关目录，权限可能又被污染，届时对照基线能快速定位。

5. 本篇常见错排查：401、local proxy failed、reading choices 与 OAuth

修 Gateway 的过程中，除了Service is loaded but not running，你还会遇到几类高频报错。我把它们和真实原因对照列出来，方便你按图索骥。

第一类，401 Unauthorized。这通常不是权限问题，而是 TaoToken 的 API Key 无效或没被正确读取。检查三处：plist 的EnvironmentVariables、settings.json的env、auth.json的对应字段，确保 Key 字符串没有多余空格或换行。如果你在对话页面能通、Gateway 里 401，基本就是环境变量没生效，重启 LaunchAgent 让新配置加载。

第二类，local proxy failed。这个报错往往和本地网络环境或 endpoint 写法有关。确认 Base URL 写的是https://taotoken.net/api，不要多加路径或参数。同时检查 plist 里是否残留了旧的代理相关环境变量，如果有，删掉再重新bootstrap。注意，这里说的是清理配置残留，不是让你去搭什么网络工具，保持配置干净即可。

第三类，reading choices或类似解析错误。这通常意味着返回体结构和你期望的不一致，常见原因是 Model ID 填错，或者 Base URL 指向了不兼容的接口。把 Model ID 换成文档里明确列出的值，再重试。如果还是报错，用curl直接打一次 API 看返回结构：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer 你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{"model":"你的ModelID","messages":[{"role":"user","content":"ping"}]}'

返回里如果有正常的choices字段，说明 Key 和 Model ID 没问题，问题在 openclaw 的配置读取环节。

第四类，OAuth 相关报错。如果你用的是 Claude Code 这类带 OAuth 流程的工具，注意 OAuth 和 API Key 是两套认证方式，不要混用。用 TaoToken 的 Key 时，确保配置走的是 API Key 路径，而不是残留的 OAuth token。清理旧的认证缓存后重新配置，通常能解决。

第五类，Could not find service。这在launchctl bootout时出现是正常的，说明服务本来就没加载，继续bootstrap即可。但如果bootstrap后launchctl print仍找不到服务，检查 plist 文件名和Label是否一致，以及 plist 是否放在~/Library/LaunchAgents/下。

排查时记住一个原则：先看日志，再看状态，最后改配置。日志在~/Library/Logs/openclaw/gateway.err.log，状态用launchctl print和openclaw gateway status --deep，配置改完必须重新bootout+bootstrap才生效。按这个顺序走，大部分报错都能定位到具体环节。

6. 语义一致 CTA：接入文档、API Keys 与 Coding Plan 分流

修好 Gateway 并接上 TaoToken 之后，你可能会想进一步优化调用方式。这里按场景给你分流建议，避免只收藏一个首页却找不到具体入口。

如果你还在排障或接入阶段，需要反复查 Base URL、Key 创建和配置示例，优先看接入文档https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，配合 API Keys 页面https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=管理你的 Key。这两个页面是接入期用得最多的。

如果你只是想快速验证某个模型能不能通，直接用模型对话https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，发一条消息就能看到结果，不用改任何本地配置。

如果你打算长期跑编码任务或 Agent 工作流，调用频率高、对稳定性要求高，可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，它更适合持续性的开发场景。控制台入口在https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，Key 管理和用量查看都在这里。

最后回到本次排查本身：Service is loaded but not running在 MacOS 上大概率是 LaunchAgent 权限污染导致的，重点检查~/.openclaw、~/.npm-global、~/Library/LaunchAgents、~/Library/Logs/openclaw四个目录的属主是否为当前用户。修完权限后重新bootout+bootstrap，再用openclaw gateway status --deep确认Runtime: running和Connectivity probe: ok。把 endpoint 换成 TaoToken 时，Base URL、Key、Model ID 三件套要写全且三处一致。按这个流程走，Gateway 重启失败的问题基本能闭环解决。

资讯详情