Olares 运行 NemoClaw 常见问题排查指南：从 Discord 频道卡死到 Gateway Token 丢失

• 云原生
• 后端
• 运维

【免费下载链接】Terminus

Open-Source Personal Cloud OS for Always-On Agents

项目地址：https://gitcode.com/gh_mirrors/terminus2/Terminus

点击查看免费下载

本文以 docs/use-cases/nemoclaw-common-issues.md 为骨架，汇总 NemoClaw 在 Olares 上最常见的四个故障场景：Discord 频道卡在startup-not-ready、默认 workspace 文件缺失、重启后 Olares CLI 登录与技能丢失、以及 OpenClaw Web UI 报unauthorized: gateway token missing。读完本文，你将掌握每条故障的成因判断、可从 NemoClaw CLI 沙盒直接执行的恢复命令，以及如何避免在容器化部署中用错 gateway 管理命令。

NemoClaw 是 NVIDIA 开源的参考技术栈，将 OpenClaw 与 NVIDIA OpenShell 运行时捆绑打包，以“常驻 AI Agent”的形式运行在 Olares 上（对应文档 docs/use-cases/nemoclaw.md）。安装完成后，Launchpad 上会出现两个入口：NemoClaw CLI（沙盒终端，用于执行 NemoClaw / OpenClaw 命令）和OpenClaw Web UI（基于浏览器的 OpenClaw 控制台）。由于 OpenClaw 被运行在 OpenShell 沙盒运行时内，网关（gateway）进程、通道（channel）配置、token 管理都与普通本机部署有差异，本文的排查思路全部围绕“从 NemoClaw CLI 沙盒内操作”展开。

背景：理解沙盒与 Gateway 的边界

在动手之前，先建立两个关键认知，否则容易用错命令：

• 沙盒即运行时：OpenClaw 的配置、通道与技能都落在沙盒内。例如配置 Discord 通道需要使用openclaw config --section channels，配置联网搜索使用openclaw config --section web，且都要先通过nemoclaw my-assistant connect进入沙盒 shell（提示符形如sandbox@my-assistant:~$）。
• Gateway 是容器内的常驻主进程：在 Olares 的容器化部署中，gateway 作为容器主进程持续运行，环境不依赖 systemd / systemctl。这意味着标准的openclaw gateway stop/restart在容器场景下并不可靠，故障恢复需要用到本文给出的“先强制停、再拉起”的两段式命令（底层逻辑详见 docs/use-cases/openclaw-common-issues.md 中关于 gateway 以pid 1运行、systemctl --user不可用的说明）。

问题一：Discord 频道卡在startup-not-ready状态

现象

在 NemoClaw CLI 沙盒中配置完 Discord 通道后，OpenClaw Web UI 中该频道一直显示startup-not-ready，而不是就绪（ready）状态。

成因判断

结合部署形态可以推断：startup-not-ready表示 gateway 在读取新通道配置后未能完成启动流程，常见于通道配置写入后 gateway 进程未以最新配置重新就绪。恢复思路不是修改配置，而是重启 gateway 让配置重新加载。

恢复步骤

从 Launchpad 打开NemoClaw CLI应用，在 shell 提示符下依次执行：

第 1 步：停止 gateway

docker exec openshell-cluster-nemoclaw kubectl -n openshell exec my-assistant -c agent -- \ sh -lc 'openclaw gateway stop 2>/dev/null || pkill -9 -f "openclaw.*gateway|openclaw-gateway|gateway run" 2>/dev/null || true'

这条命令分三层递进，值得逐段拆解：

• docker exec openshell-cluster-nemoclaw：进入 NemoClaw 所在集群的管理容器；
• kubectl -n openshell exec my-assistant -c agent --：定位到openshell命名空间下名为my-assistant的沙盒 Pod，并切到agent容器内执行命令（这也是nemoclaw my-assistant connect背后的目标 Pod）；
• 容器内的sh -lc '...'采用“优雅停止优先、强杀兜底”的策略：先尝试openclaw gateway stop；失败则用pkill -9强制结束匹配openclaw.*gateway、openclaw-gateway、gateway run等模式的进程；2>/dev/null || true保证即使进程不存在、命令报错，整条命令也不会以失败退出，避免中断后续操作。

第 2 步：启动 gateway

sh /opt/nemoclaw/sandbox-ensure-gateway.sh

/opt/nemoclaw/sandbox-ensure-gateway.sh是 NemoClaw 预置在沙盒内的 gateway 拉起脚本，它会检查 gateway 进程状态并确保其以当前配置重新运行。

第 3 步：等待并刷新

等待约10 到 15 秒，然后刷新 OpenClaw Web UI，Discord 频道应恢复就绪状态。

问题二：安装后缺少默认 workspace 文件

现象

NemoClaw 在安装过程中可能没有成功创建默认的 workspace 文件，导致 Agent 的默认工作区不完整。

临时解决方案

作为临时 workaround，需要手动创建所需文件：参考 OpenClaw 的默认 Agent 文档（即AGENTS.default的规范说明）与官方模板目录（docs/reference/templates下的模板样例），按模板补齐缺失的默认文件。

需要注意：这是文档标注的临时方案，说明安装流程对默认文件的生成存在已知的不稳定点；如果你遇到此问题，建议在补齐文件后执行/reset开启新会话，让 Agent 重新读取 workspace。该问题的根治依赖上游 OpenClaw / NemoClaw 安装流程的修复，不属于 Olares 侧配置范畴。

问题三：重启后 Olares CLI 登录与技能丢失

现象

NemoClaw不会在重启后保留两样东西：

1. Olares CLI 的登录状态（olares-cli profile login建立的会话）；
2. 已安装的 ClawHub 技能（如 Olares Shared、Olares Files、Olares Market 等）。

重启 NemoClaw 后，这些状态都会重置，需要重新配置。这也是沙盒“无状态”特性的直接体现——技能与登录凭据存放在沙盒内的易失目录中，容器重启即丢失。

恢复步骤

完整操作见 docs/use-cases/nemoclaw-olares-cli.md，核心两步如下：

第 1 步：重新登录 Olares CLI

nemoclaw my-assistant connect olares-cli profile login --olares-id <your-olares-id>

例如：

olares-cli profile login --olares-id [e-mail]

按提示输入 Olares 登录密码。随后用olares-cli profile list验证登录状态，期望输出中该 profile 状态为logged-in：

NAME OLARES-ID STATUS * [e-mail] [e-mail] logged-in (23h59m)

第 2 步：重新安装 Olares 技能

1. 打开 OpenClaw Web UI，进入Skills；
2. 在 ClawHub 搜索olares；
3. 先安装Olares Shared（它是其他 Olares 技能的基础依赖），再安装Olares Files、Olares Market等；
4. 在聊天页执行/reset开启新会话，让 Agent 加载新技能；如果配置了 Discord 等通道，也要在每个通道会话中执行/reset。

小提示：从 ClawHub 下载技能遇到429（Rate limit exceeded）时，稍等片刻重试即可，这是 ClawHub 在流量高峰的临时限流（相关说明同样见于 docs/use-cases/openclaw-skills.md 与 docs/use-cases/openclaw-common-issues.md）。

问题四：OpenClaw Web UI 显示unauthorized: gateway token missing

现象

NemoClaw 重启后，打开 OpenClaw Web UI 可能看到如下错误：

unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)

成因判断

gateway token 是 OpenClaw Web UI 与本地 gateway 之间鉴权使用的密钥。NemoClaw 重启后，Web UI 侧保存的 token 与 gateway 当前持有的 token 不一致（或浏览器会话失效），于是被判定为未授权。错误信息本身也给出了修复路径：打开 dashboard URL，把 token 粘贴进 Control UI 设置。

恢复步骤

第 1 步：获取 gateway token

从 Launchpad 打开NemoClaw CLI，在 shell 提示符下执行：

nemoclaw my-assistant gateway-token --quiet

• my-assistant：指定 Agent 实例（与 connect 命令同款参数）；
• gateway-token：打印当前 gateway 的鉴权 token；
• --quiet：只输出 token 本身，不附带多余日志，便于直接复制。

第 2 步：复制 token

将终端中显示的 token 完整复制到剪贴板。

第 3 步：粘贴并连接

回到 OpenClaw Web UI，将 token 粘贴到Gateway Token输入框，然后点击Connect：

连接成功后，Web UI 即可正常访问控制台与聊天界面。建议将此 token 妥善保存——一旦再次出现同类错误，可以跳过“重新获取”直接粘贴使用。

排查后的预防性建议

结合 NemoClaw / OpenClaw 在 Olares 上的部署方式，给出三条降低复发概率的建议：

1. 不要依赖标准的openclaw gateway restart/stop做日常操作：在 Olares 容器化环境中，gateway 是容器主进程且不使用 systemd，标准命令可能报Gateway service disabled、gateway already running (pid 1)或systemctl --user unavailable等错误（详见 docs/use-cases/openclaw-common-issues.md）。需要重启时优先使用本文问题一中的两段式命令，或在 CLI 中使用restart-gateway内置脚本。
2. 记住沙盒的无状态特性：凡是登录态、技能、token 这类“沙盒内配置”，重启后都要重新配置。可以在重启 NemoClaw 后按“重新登录 Olares CLI → 重装技能 → 核对 gateway token → 各会话/reset”的顺序做一遍体检。
3. 安装期保持模型应用在线：NemoClaw 首次安装时，初始 onboarding 依赖后端模型可访问（安装前需在环境变量中配置NEMOCLAW_ENDPOINT_URL与NEMOCLAW_MODEL=default-chat，模型若中途停止会导致安装无法完成，参见 docs/use-cases/nemoclaw.md）。这条与故障排查直接相关——安装不完整往往是后续“workspace 文件缺失”“通道未就绪”等连锁问题的根源。

延伸阅读

• docs/use-cases/nemoclaw.md：NemoClaw 在 Olares 上的完整安装、Discord 接入与联网搜索配置教程。
• docs/use-cases/nemoclaw-olares-cli.md：Olares CLI 登录与 Olares 技能安装的完整步骤。
• docs/use-cases/nemoclaw-google-workspace.md：通过 gog 技能接入 Gmail / Calendar / Drive 的 OAuth 配置。
• docs/use-cases/openclaw-common-issues.md：OpenClaw 通用故障（升级迁移、超时、模型响应慢等）与 FAQ。
• docs/use-cases/openclaw-skills.md：技能与插件的安装管理方法。

赞分享

• 云原生
• 后端
• 运维

【免费下载链接】Terminus

Open-Source Personal Cloud OS for Always-On Agents

项目地址：https://gitcode.com/gh_mirrors/terminus2/Terminus

点击查看免费下载

相关推荐

• OpenPose常见问题排查：从安装失败到运行错误解决指南

  OpenPose常见问题排查：从安装失败到运行错误解决指南 OpenPose作为一款强大的人体姿态检测工具，在实际使用过程中经常会遇到各种安装和运行问题。本文为

  人工智能计算机视觉深度学习

• 在 Olares 上使用本地 LLM 运行 NemoClaw：从安装配置到 Discord 与联网搜索全指南（1.12.6）

  在 Olares 上使用本地 LLM 运行 NemoClaw：从安装配置到 Discord 与联网搜索全指南（1.12.6） NemoClaw 是 NVIDIA

  云原生后端运维

• kafka-docker常见问题排查手册：从启动失败到数据丢失

  kafka docker常见问题排查手册：从启动失败到数据丢失 Apache Kafka作为现代分布式系统的核心消息队列，在容器化部署时经常会遇到各种问题。😅

  消息队列后端云原生

上一篇：ESLint 插件开发完全指南：从创建、配置到发布（Create Plugins）

下一篇：Resume-Matcher 简历模板设计规范全解：Swiss 国际主义风格的设计系统与源码实现