setup
This skill automates ClaudeClaw's first-time setup, handling Node.js verification, dependency installation, environment configuration, and container runtime selection. It detects whether you're working in developer or plugin mode and adapts its workflow accordingly, pausing only when manual actions like channel authentication are required.
setup runs initial ClaudeClaw installation, installs dependencies, and configures messaging channels.
AI-generated summary based on this skill's SKILL.md
Install
sbusso/claudeclaw/setup · repository language: TypeScript
git clone https://github.com/sbusso/claudeclaw
cp -r claudeclaw/skills/setup ~/.claude/skills/setupFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I install ClaudeClaw?
ClaudeClaw's setup skill automates your first-time installation by verifying Node.js, installing dependencies, and configuring your environment. Run the setup process, which detects whether you're in developer or plugin mode and adapts its workflow accordingly. The skill handles dependency resolution and prepares your system for messaging channel authentication.
How do I set up WhatsApp, Telegram, Slack, and Discord with ClaudeClaw?
ClaudeClaw's setup skill guides you through authenticating and configuring each messaging channel. After initial installation, the setup process pauses for manual authentication steps on each platform, then registers your chat groups. You'll provide channel credentials and bot names during this phase, which the setup skill validates before proceeding.
What should I do if ClaudeClaw's service won't start?
ClaudeClaw's setup skill includes troubleshooting for startup failures by checking your environment variables, verifying container runtime configuration, and validating mount allowlist settings. The skill detects missing configurations and guides you through fixes. Ensure your chosen runtime (Docker, Sandbox, or Apple Container) is properly installed and that all required dependencies completed installation successfully.
How do I configure ClaudeClaw for the first time?
ClaudeClaw's setup skill handles initial configuration by detecting your operating system, selecting an appropriate container runtime, and setting up environment variables. The skill pauses only when manual actions like channel authentication are required, then resumes automatically. It verifies each step and confirms the background service is running before completing setup.
What container runtimes does ClaudeClaw's setup support?
ClaudeClaw's setup skill supports Docker, Sandbox, and Apple Container runtimes. During setup, the skill automatically detects your system and helps you choose the appropriate runtime. Configuration includes mount allowlist setup and runtime-specific environment variables to ensure ClaudeClaw operates securely in your chosen containerized environment.
How do I verify ClaudeClaw is working correctly after setup?
ClaudeClaw's setup skill verifies functionality by starting the background service and confirming it remains active. The skill tests environment configuration, validates messaging channel authentication, and checks that all dependencies loaded successfully. Once setup completes, you can confirm ClaudeClaw is operational by checking service status and testing a message through any configured channel.
SKILL.md
rendered from the published skill — quoted content, verbatim
ClaudeClaw Setup
Run setup steps automatically. Only pause when user action is required (channel 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. authenticating a channel, 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.
Mode Detection
Before any steps, detect the execution mode:
```bash cat .claude-plugin/plugin.json 2>/dev/null | grep '"name": "claudeclaw"' &&
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/setup/SKILL.md