setup
setup walks you through GhostClaw's initial deployment end-to-end, handling Node.js and dependency installation, container runtime selection, WhatsApp authentication, and service startup. It pauses only when your action is required—scanning a QR code, choosing auth methods, or confirming configuration—then resumes automatically.
setup automates GhostClaw's initial installation, dependency setup, WhatsApp authentication, and service launch.
AI-generated summary based on this skill's SKILL.md
Install
b1rdmania/ghostclaw/setup · repository language: TypeScript
git clone https://github.com/b1rdmania/ghostclaw
cp -r ghostclaw/.claude/skills/setup ~/.claude/skills/setupFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I install GhostClaw?
setup guides you through GhostClaw's complete installation from scratch. It installs Node.js and all npm dependencies, detects your operating system, and prompts you to choose between Docker or Apple Container runtime for agent execution. Follow the on-screen prompts—setup pauses only when your action is required, such as confirming paths or selecting runtime options, then resumes automatically.
What are the GhostClaw setup instructions?
setup handles GhostClaw's end-to-end initial deployment. Start by running setup, which scans your system for Node.js, installs missing dependencies via npm, and guides you through container runtime selection. You'll authenticate WhatsApp by scanning a QR code, register your main communication channel, and configure your trigger word. setup verifies each step and reports any missing components before moving forward.
How do I authenticate WhatsApp in GhostClaw?
setup manages WhatsApp authentication as part of GhostClaw's initial configuration. When prompted, you'll scan a QR code displayed on your terminal using your WhatsApp mobile app. setup then registers your authenticated session as the main communication channel and confirms the connection is active before proceeding to service startup and system readiness verification.
How do I set up GhostClaw dependencies?
setup automatically handles all GhostClaw dependency installation. It detects Node.js on your system; if missing, it guides installation. setup then runs npm install to fetch all required packages, validates each component, and reports any failures. If issues arise, setup's diagnostic mode helps identify and fix missing components before you start background services.
What container runtime should I choose for GhostClaw?
setup prompts you to select between Docker or Apple Container runtime during GhostClaw configuration. Docker works on Linux, macOS, and Windows (via WSL); Apple Container is optimized for native macOS environments. setup detects your OS and recommends the appropriate option, then configures your chosen runtime for agent execution. You can change this selection later by re-running setup.
How do I troubleshoot GhostClaw setup failures?
setup includes diagnostic tools to identify and fix setup failures. If components are missing or configuration steps fail, setup reports the specific issue—such as Node.js not found or npm install errors—and suggests remediation steps. Run setup again after addressing problems; it resumes from where it paused and verifies system readiness before starting background services.
SKILL.md
rendered from the published skill — quoted content, verbatim
GhostClaw Setup
Run setup steps automatically. Only pause when user action is required (WhatsApp authentication, configuration choices). Setup uses bash setup.sh for bootstrap, then npx tsx setup/index.ts --step <name> for all other steps. Steps emit structured status blocks to stdout. Verbose logs go to logs/setup.log.
Principle: When something is broken or missing, fix it. Don't tell the user to go fix it themselves unless it genuinely requires their manual action (e.g. scanning a QR code, pasting a secret token). If a dependency is missing, install it. If a service won't start, diagnose and repair. Ask the user for permission when needed, then do the work.
UX Note: Use AskUserQuestion for all user-facing questions.
1. Bootstrap (Node.js + Dependencies)
Run bash setup.sh and parse the status block.
- If NODE_OK=false → Node.js is missing or too old. Use `AskUserQuestion: Would
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.claude/skills/setup/SKILL.md