🦞 DevOpsClaw — Personal AI Assistant

DevOpsClaw is a powerful personal AI assistant that runs on your local infrastructure. It connects to the messaging channels you already use (WhatsApp, Telegram, Slack, Discord, and more) and provides a unified interface for managing your DevOps tasks, infrastructure, and daily workflows.

🚀 Installation

Prerequisites

• Node.js: Version 22 or higher.
• pnpm: Recommended package manager (or npm).

Option 1: Install Locally (Source)

Since devopsclaw is not yet published to the public npm registry, you must install it from the source code:

1. Navigate to the project directory:

   cd path/to/devopsclaw

2. Install globally from the current directory:

   npm install -g .
   # or
   pnpm add -g .

Once installed, you can access the CLI using the devopsclaw command.

Option 2: Install from Source (Development)

If you want to contribute or run the latest development version:

git clone https://github.com/devopsclaw/devopsclaw.git
cd devopsclaw

pnpm install
pnpm build

Link the CLI globally (optional):

npm link

Or run commands via pnpm devopsclaw ....

🛠️ Getting Started & Configuration

The easiest way to configure DevOpsClaw is using the interactive onboarding wizard.

1. Run the Onboarding Wizard

devopsclaw onboard --install-daemon

This command will:

• Set up the Gateway: Configures the core service that manages your assistant.
• Create Configuration: Generates ~/.devopsclaw/devopsclaw.json.
• Install Daemon: Sets up a background service (launchd/systemd) to keep DevOpsClaw running.
• Configure Channels: Guides you through connecting WhatsApp, Telegram, etc.
• Set up Models: Prompts for API keys (Anthropic, OpenAI) to power the AI.

2. Manual Configuration

Configuration is stored in ~/.devopsclaw/devopsclaw.json. You can edit this file directly.

Minimal Example:

{
  agent: {
    model: "anthropic/claude-3-opus-20240229", // Recommended
    language: "english"
  },
  gateway: {
    port: 18789
  }
}

📡 Adding Channels

DevOpsClaw supports many channels. You can add them during onboarding or later via the CLI.

WhatsApp

devopsclaw channels login whatsapp

Follow the QR code prompt to link your device.

Telegram

1. Create a bot via @BotFather and get the token.
2. Run:

devopsclaw config set channels.telegram.botToken "YOUR_TOKEN_HERE"

3. Restart the gateway.

Discord / Slack

Update ~/.devopsclaw/devopsclaw.json with your bot tokens:

{
  "channels": {
    "discord": { "token": "..." },
    "slack": { "botToken": "...", "appToken": "..." }
  }
}

🎮 Commands Reference

Here are the essential commands for managing DevOpsClaw:

Core

• devopsclaw onboard: Run the setup wizard (re-runnable).
• devopsclaw doctor: Check for configuration issues and missing dependencies.
• devopsclaw status: Show the status of the Gateway and connected channels.
• devopsclaw --version: operational version check.

Gateway Management

• devopsclaw gateway: Run the Gateway in the foreground (useful for debugging).
  • --port <number>: Specify a custom port (default: 18789).
  • --verbose: Enable detailed logging.
• devopsclaw gateway:watch: (Dev only) Run gateway with auto-reload.

Agent Interaction

• devopsclaw agent: Start an interactive chat session with the agent directly in your terminal.
• devopsclaw message send: Send a direct message to a specific user/channel.
  • Usage: devopsclaw message send --to <id> --message "Hello"

Channel Management

• devopsclaw channels list: List configure channels and their status.
• devopsclaw channels login <channel>: Interactive login format for supported channels (e.g., WhatsApp).

🧩 Architecture

DevOpsClaw consists of:

1. Gateway: The central control plane (run via devopsclaw gateway or daemon). It manages connections, state, and the AI agent loop.
2. Agent: The AI brain (powered by LLMs) that processes messages and executes tools.
3. A2UI: The "Agent to UI" interface for rendering visual components (Canvas).
4. Skills: Modular capabilities (Docker, Kubernetes, AWS, etc.) that the agent can use.

🤝 Contributing

See CONTRIBUTING.md for details on how to contribute to the project.

Built with ❤️ by the DevOpsClaw Community.