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
Decision gist · record as of 2026-07-26
setup runs initial ClaudeClaw installation, installs dependencies, and configures messaging channels. 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.
Use it when
- ClaudeClaw's setup skill guides you through authenticating and configuring each messaging channel.
- ClaudeClaw's setup skill includes troubleshooting for startup failures by checking your environment variables.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
sbusso/claudeclaw/setup · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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)
File tree — 1 file
skills/setup/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Run initial ClaudeClaw setup and install dependencies”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
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.
Extend ClaudeClaw with new input channels, adjust routing rules, and personalize agent responses. This interactive skill guides you through adding Telegram, Slack, Discord, email, or other integrations, then helps rebuild and restart your setup.
This skill integrates Telegram into ClaudeClaw for bidirectional messaging. Set up your bot token, register chat IDs, and choose between full message handling or trigger-only mode. Supports group chats and optional agent swarm visibility.
This skill adds Discord channel support to ClaudeClaw, handling bot token setup, code integration via git merge, and interactive channel registration. It guides you through creating a Discord bot application, configuring environment credentials, and registering channels for message routing with optional trigger-based responses.
This skill integrates WhatsApp as a messaging channel into ClaudeClaw, enabling you to route messages through WhatsApp alongside or instead of other channels. It handles authentication via QR code (browser or terminal) or pairing code, then guides you through registration, trigger configuration, and chat setup.
This skill integrates Telegram into GhostClaw through automated code changes and guided configuration. It lets you use Telegram as your primary channel or run it alongside WhatsApp, with options for full message access or trigger-only responses in groups.
More skills codspeed-setup-harness (Apache-2.0) · vc-setup (MIT)