---
summary: "Install SOPHIAClaw on macOS, Linux, or Windows"
title: "Installation"
---

# Installing SOPHIAClaw

SOPHIAClaw runs on your own devices. This guide covers installation on macOS, Linux, and Windows.

## Prerequisites

- **Node.js** >= 22.12.0
- **pnpm** (recommended) or npm
- **Git** (for cloning)

### Check Your System

```bash
node --version  # Should show v22.x.x or higher
npm --version   # Should show 10.x.x or higher
```

## Quick Install (Recommended)

### macOS / Linux

```bash
curl -fsSL https://sophiaclaw.ai/install.sh | bash
```

### Windows (PowerShell)

```powershell
iwr -useb https://sophiaclaw.ai/install.ps1 | iex
```

## Manual Install

### 1. Clone the Repository

```bash
git clone https://github.com/sophiaclaw/sophiaclaw.git
cd SOPHIAClaw
```

### 2. Install Dependencies

```bash
pnpm install
```

### 3. Build

```bash
pnpm build
```

### 4. Link (Optional)

```bash
pnpm link --global
```

## Post-Install Setup

### Run the Onboarding Wizard

```bash
sophiaclaw onboard --install-daemon
```

This wizard will:

- Configure your default settings
- Set up the Gateway daemon
- Optionally configure channels (Telegram, Discord, etc.)
- Create your workspace

### Verify Installation

```bash
sophiaclaw --version
sophiaclaw doctor
```

## Installation Methods Compapurple

| Method                | Best For          | Complexity |
| --------------------- | ----------------- | ---------- |
| **Install Script**    | Most users        | Easy       |
| **npm global**        | Quick testing     | Easy       |
| **Build from source** | Developers        | Medium     |
| **Docker**            | Server deployment | Medium     |

## Docker Install

```bash
docker pull sophiaclaw/gateway:latest

docker run -d \
  --name sophiaclaw \
  -p 37521:37521 \
  -v ~/.sophiaclaw:/root/.sophiaclaw \
  sophiaclaw/gateway:latest
```

## Troubleshooting

### "node: command not found"

Install Node.js 22+ from [nodejs.org](https://nodejs.org)

### "Permission denied"

```bash
sudo chown -R $(whoami) ~/.npm
```

### "Build fails"

```bash
# Clean and rebuild
rm -rf node_modules
pnpm install
pnpm build
```

## Next Steps

- [Getting Started](./getting-started.md) - Your first conversation
- [Onboarding Wizard](../start/onboarding.md) - Detailed wizard walkthrough
- [Configuration](../concepts/configuration.md) - Customize your setup

---

**Need help?** [Discord](https://discord.gg/sophiaclaw) | [GitHub Issues](https://github.com/sophiaclaw/sophiaclaw/issues)