ɳSelfɳSELFDOCS

  • Getting Started

    • Introduction
    • Quick Start
    • Installation
    • Your First Project

  • Core Concepts

    • Architecture Overview
    • Project Structure
    • Configuration
    • Environments

  • Services

    • PostgreSQL Database
    • Hasura GraphQL
    • Authentication
    • Real-Time Communication
    • Storage (MinIO)
    • Email Configuration
    • Redis Cache
    • Search Engines
    • Functions
    • MLflow (ML Tracking)
    • Monitoring & Metrics
    • Admin UI
    • Dashboard

  • Database Tools

    • Schema Management
    • Migrations
    • Seeding Data
    • Backup & Restore
    • dbdiagram.io Sync

  • Microservices

    • NestJS Services
    • BullMQ Workers
    • Go Services
    • Python Services

  • CLI Reference

    • All Commands
    • Core Commands
    • Database Commands
    • Service Management
    • Production Commands

  • Deployment

    • Local Development
    • Production Setup
    • SSL/TLS Configuration
    • Domain Configuration
    • Environment Variables

  • Advanced Topics

    • Multi-Tenancy & SaaS
    • Security & Hardening
    • Custom Actions
    • Webhooks
    • Performance Tuning
    • Troubleshooting

  • ɳClaw

    • Backend Manager
    • API Gateway
    • Voice Input
    • Threads & Projects

  • Migration Guides

    • From Supabase
    • From Nhost
    • From Firebase

  • Plugins

    • Plugin catalog (87)
    • Installation
    • Free plugins (25)
    • Pro plugins (62)

  • Reference

    • Stack & Hosting
    • API Reference
    • Guides
    • RFCs
    • Legal
    • Contributing

  • Resources

    • Changelog
    • Licensing
    • FAQ
    • Support

nself-claw — Autonomous AI Assistant

Run a configurable AI assistant on your nself backend. ɳClaw connects to users via Telegram, web chat, or WebSocket, reasons using nself-ai, routes messages through nself-mux, and can browse the web via nself-browser. Each deployment gets its own identity defined in a identity.yaml file.

Pro Plugin — $1.99/mo membership

nself-claw requires a Pro membership and depends on nself-ai and nself-mux. nself-browser is optional but unlocks the BrowseUrl tool.

Install

# Install required dependencies first
nself license set nself_pro_...
nself plugin install ai mux

# Optional: install browser for web research capability
nself plugin install browser

# Install claw
nself plugin install claw
nself build
nself start

Configuration

Environment Variables

VariableRequiredDescription
PLUGIN_CLAW_IDENTITY_PATHYesPath to your identity.yaml configuration file
PLUGIN_CLAW_ADMIN_PASSWORDYesPassword to protect the admin endpoints

identity.yaml

The identity file defines your assistant's persona, integrations, and capabilities:

name: Aria
persona: |
  You are Aria, a helpful assistant for Acme Corp.
  You are knowledgeable, concise, and friendly.
  When asked about pricing, refer users to acme.com/pricing.

# Telegram integration (optional)
telegram_token: "1234567890:AAFxxxxxxxxxxxxxxxx"

# Tools the assistant can use
tools:
  - get_weather          # built-in weather lookup
  - BrowseUrl            # web browsing (requires nself-browser)
  - send_email           # send via nself-mux

# AI model to use
model: gpt-4o            # or claude-3-5-sonnet-20241022, gemini-1.5-pro, etc.

Quick Start

  1. Install dependencies and configure identity.yaml with your persona and Telegram bot token (create a bot at @BotFather).
  2. Set PLUGIN_CLAW_IDENTITY_PATH=/etc/nself/identity.yaml and PLUGIN_CLAW_ADMIN_PASSWORD in your .env.
  3. Run nself build && nself start and message your Telegram bot. It should respond using the configured persona and model.

Available Tools

ToolRequiresDescription
get_weatherBuilt-inLook up current weather for any city
BrowseUrlnself-browserOpen any URL and read its content
send_emailnself-muxSend email via the nself-mux mail channel

Memory

ɳClaw maintains per-user memory automatically. Each conversation builds a persistent context that the assistant recalls in future sessions.

# View memory for a user
curl http://127.0.0.1:3710/claw/memory/user-uuid

# View memory stats
curl http://127.0.0.1:3710/claw/memory/user-uuid/stats

# Clear memory for a user
curl -X DELETE http://127.0.0.1:3710/claw/memory/user-uuid

API Reference

EndpointMethodDescription
/claw/chatPOSTSend a message and get a response (non-streaming)
/claw/chatWSWebSocket for streaming chat responses
/claw/sessionsGETList active chat sessions
/claw/memory/:user_idGETRead stored memory for a user
/claw/memory/:user_idDELETEClear all memory for a user
/claw/memory/:user_id/statsGETMemory usage stats (tokens, entries, last updated)
/healthGETCheck plugin health and dependency status

Uninstall

nself plugin remove claw

Related

  • Plugin Overview — Tier table, license setup, lifecycle commands
  • nself-ai — Required AI inference layer
  • nself-mux — Required message routing layer
  • nself-browser — Optional web browsing capability
  • nself-voice — Optional voice synthesis for spoken responses

Port: 3710 | Tier: Pro ($1.99/mo) | Requires: nself-ai, nself-mux | Last Updated: March 2026