setup

Install and configure BioClaw runtime components and WhatsApp authentication.

401|53|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Runchuan-BU/BioClaw --skill setup-runchuan-bu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/Runchuan-BU/BioClaw/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/Runchuan-BU/BioClaw --skill setup-runchuan-bu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up BioClaw requires multiple coordinated steps—installing dependencies, choosing and configuring a container runtime, authenticating with Claude and WhatsApp, registering the main chat channel, configuring mount allowlists, and launching background services—which is error-prone and time consuming for first-time users.

Core Features & Use Cases

  • Automated dependency installation: Runs npm installs and builds the container image for the BioClaw agent.
  • Container runtime detection and conversion: Detects macOS Apple Container vs Docker and offers conversion to Docker for non-macOS systems.
  • Claude and WhatsApp authentication flows: Guides token/API key setup for Claude and supports QR, pairing code, or terminal QR authentication for WhatsApp.
  • Channel registration and security configuration: Helps choose and register a main channel JID, set trigger words, and create a mount allowlist for external directories.
  • Service launch configuration: Generates platform-specific launch scripts (launchd plist on macOS), starts background agents, and provides troubleshooting checks.
  • Use Case: Ideal when provisioning a new workstation for BioClaw, migrating an installation to Docker, or onboarding team members who need an operational WhatsApp-connected agent.

Quick Start

Run the setup skill and follow prompts to install dependencies, authenticate WhatsApp, register your main channel, and start the background services.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a WhatsApp-connected agent on a new machine?

Setting up a WhatsApp-connected agent requires installing dependencies, detecting the container runtime, authenticating Claude API keys and WhatsApp QR codes, registering a channel JID, and launching background services.

Can I migrate my BioClaw installation from macOS to Docker?

You can migrate BioClaw from macOS to Docker using container runtime detection and conversion, which automatically offers Docker conversion for non-macOS systems during the setup process.

How does WhatsApp QR authentication work during initial configuration?

WhatsApp QR authentication works by guiding you through scanning a QR code, entering a pairing code, or using terminal QR authentication to link your WhatsApp account with the BioClaw agent during the initial configuration.

Do I need Docker to configure the BioClaw runtime container?

You do not strictly need Docker; the setup detects macOS Apple Container vs Docker and offers conversion to Docker for non-macOS systems to build and run the BioClaw runtime container.

What are the limitations when configuring mount allowlists for external directories?

A limitation of configuring mount allowlists is that access is restricted to only explicitly allowed external directories, requiring you to define the mount allowlist during setup to secure the agent's file system interactions.

How to generate launchd plist files for background agent services on macOS?

To generate launchd plist files for background agent services on macOS, the setup process automatically creates platform-specific launch scripts and starts the background agents during the final service launch configuration phase.