debug
Debug NanoDex container/runtime issues including Docker, Codex auth, session persistence, and IPC.
- License 许可
- MIT
- 所属仓库
- mbaker95/nanodex
- 最近更新
- 2026-03-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- debug
- description
- Debug NanoDex container/runtime issues including Docker, Codex auth, session persistence, and IPC.
03 SKILL.md 正文
NanoDex Debugging
Focus on the Docker-backed Codex runtime.
Checkpoints
- Host build and typecheck:
npm run build./container/build.sh
- Container image exists and starts:
echo '{}' | docker run -i --entrypoint /bin/echo nanodex-agent:latest OK
- Auth env exists:
.envshould containOPENAI_API_KEY=orCODEX_API_KEY=
- Session mount exists:
data/sessions/<group>/.codex/- mounted to
/home/node/.codex
- Logs:
- host logs in
logs/ - per-container logs in
groups/<folder>/logs/container-*.log
- host logs in
Common Problems
- Missing OpenAI/Codex API key.
- Docker not running.
- Old
nanoclaw-agentimage still being referenced in.envor local overrides instead ofnanodex-agent. - Session path mismatch preventing Codex thread reuse.
- MCP tool failures from
container/agent-runner/src/ipc-mcp-stdio.ts.
04 同仓库更多 Skills
agent-browser
Browse the web for any task — research topics, read articles, interact with web apps, fill forms, take screenshots, extract data, and test web pages. Use whenever a browser would be useful, not just when the user explicitly asks.
x-integration
X (Twitter) integration for NanoClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on "setup x", "x integration", "twitter", "post tweet", "tweet".
use-local-whisper
Use when the user wants local voice transcription instead of OpenAI Whisper API. Switches to whisper.cpp running on Apple Silicon. WhatsApp only for now. Requires voice-transcription skill to be applied first.
update-skills
Check for and apply updates to installed skill branches from upstream.
update-nanoclaw
Efficiently bring upstream NanoClaw updates into a customized install, with preview, selective cherry-pick, and low token usage.
setup
Run initial NanoClaw setup. Use when user wants to install dependencies, authenticate messaging channels, register their main channel, or start the background services. Triggers on "setup", "install", "configure nanoclaw", or first-time setup requests.