はじめに
こんにちは!
NemoClaw を macOS で導入した際に、実際に遭遇したエラーをそのまま貼り、
原因と解決策をセットでまとめます。
同じエラーで検索してきた人が、そのまま復旧できることを目的にしています。
私の環境
$ nemoclaw --version
nemoclaw v0.1.0
$ openshell --version
openshell 0.0.16
$ docker --version
Docker version 29.3.1, build c2be9ccfc3
$ docker info --format '{{.ServerVersion}}|{{.OperatingSystem}}'
29.0.1|Docker Desktop
$ ollama --version
ollama version is 0.19.0
$ ollama list
NAME ID SIZE
qwen3.5:0.8b f3817196d142 1.0 GB
詰まった点
Unknown command: my-assistantAnother NemoClaw onboarding run is already in progress-
gateway起動時の pull 失敗 (EOF) -
qwen3.5:0.8bを使った onboard 完了まで
エラー1: Unknown command: my-assistant
実際のエラー出力
$ nemoclaw my-assistant connect
Unknown command: my-assistant
Run 'nemoclaw help' for usage.
原因
my-assistant はサブコマンドではなく「既存サンドボックス名」です。
まだ sandbox が作られていない状態で connect だけ実行したため失敗しています。
$ nemoclaw list
No sandboxes registered. Run `nemoclaw onboard` to get started.
解決策
まず onboard を完了して sandbox を作成します。
nemoclaw onboard
エラー2: onboard が進まない (ロック残り)
実際のエラー出力
$ nemoclaw onboard --resume
Another NemoClaw onboarding run is already in progress.
Lock holder PID: 57071
Started: 2026-03-31T01:04:46.328Z
Wait for it to finish, or remove the stale lock if the previous run crashed:
rm -f "/Users/nyancat/.nemoclaw/onboard.lock"
原因
前回の onboard が中断され、~/.nemoclaw/onboard.lock が残存。
以降の onboard が排他制御で即終了していました。
$ ls -la ~/.nemoclaw
-rw------- 1 nyancat staff 94 3月 31 10:04 onboard.lock
-rw------- 1 nyancat staff 1523 3月 31 10:04 onboard-session.json
解決策
# 1) lock holder が生きているか確認
ps -p 57071 -o pid,ppid,stat,etime,command
# 2) 止まっていない/不要なら停止
kill 57071 || true
# 3) lock 削除
rm -f ~/.nemoclaw/onboard.lock
# 4) onboard 再実行
NEMOCLAW_NON_INTERACTIVE=1 \
NEMOCLAW_PROVIDER=ollama \
NEMOCLAW_MODEL='qwen3.5:0.8b' \
NEMOCLAW_SANDBOX_NAME='my-assistant' \
nemoclaw onboard --non-interactive
エラー3: gateway イメージ pull が EOF で失敗
実際のエラー出力
Error: × Docker stream error: failed to copy: httpReadSeeker: failed open: failed to do request: Get "https://pkg-containers.githubusercontent.com/...": EOF
原因
GHCR レイヤ取得中の一時的なネットワーク失敗。
$ docker pull ghcr.io/nvidia/openshell/cluster:0.0.16
...
failed to copy: httpReadSeeker: failed open: failed to do request: Get "https://pkg-containers.githubusercontent.com/...": EOF
解決策
リトライでレイヤを積み上げると成功しました。
for i in 1 2 3 4 5 6; do
echo "[pull attempt $i]"
docker pull ghcr.io/nvidia/openshell/cluster:0.0.16 && break
sleep 3
done
正しい使い方
初回
curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash
nemoclaw onboard
日常操作
# 状態確認
nemoclaw status
nemoclaw list
nemoclaw my-assistant status
# 接続
nemoclaw my-assistant connect
サンドボックス内
# 対話UI
openclaw tui
# 単発メッセージ
openclaw agent --agent main --local -m "hello" --session-id test
実際の応答確認 (抜粋):
🦞 OpenClaw 2026.3.11 (29dc654)
Hey there. 👋 How are you doing?