nself claw

Manage the ɳClaw AI assistant: pair devices, inspect sessions, browse conversation history, navigate topic threads, manage projects, query the knowledge base, and open the web UI. ɳClaw's persistent memory lives in your Postgres instance — nself claw gives you terminal access to all of it.

Quick start

# Check ɳClaw plugin status and memory stats
nself claw status

# Open the ɳClaw web UI in your browser
nself claw chat

# List all conversation sessions
nself claw sessions

# List all topic threads
nself claw threads

Synopsis

nself claw <SUBCOMMAND> [FLAGS]

Description

ɳClaw is a personal AI assistant with infinite, self-organizing memory. When you talk to it, it auto-detects topics, branches conversations into threads, extracts facts, decisions, and entities, and builds a knowledge graph that compounds over time. Your sidebar shows your life organized by topics — not by "New Chat".

The memory layer is powered by Postgres (pgvector + ltree + JSONB), with Redis for speed and MeiliSearch for full-text search. nself claw exposes every layer: from raw session records to the high-level knowledge graph, topic taxonomy, and project groupings.

ɳClaw requires the ɳClaw plugin bundle ($0.99/mo or included in ɳSelf+). Install it withnself plugin install ai claw claw-web mux voice browser google notify cron.

Subcommands

nself claw status

Show the health and statistics of the ɳClaw plugin stack: plugin versions, memory record counts, knowledge graph node counts, active sessions, and embedding model in use.

nself claw status

# Example output:
# ɳClaw plugin:   v1.1.0 (healthy)
# Embedding model: text-embedding-3-small (OpenAI)
# Sessions:        142 total, 3 active
# Topics:          38 topics, 214 threads
# Knowledge nodes: 1,842
# Memory records:  9,204
# Last indexed:    2 minutes ago

nself claw sessions

List conversation sessions. By default shows the 20 most recent sessions with their topic, message count, and last activity timestamp.

# List recent sessions
nself claw sessions

# List sessions for a specific topic
nself claw sessions --topic "work/nself"

# Show all sessions with full metadata
nself claw sessions --all --json

nself claw history

Show the message history for a specific session or the most recent session. Useful for reviewing context before continuing a conversation.

# Show history for the most recent session
nself claw history

# Show history for a specific session ID
nself claw history --session 550e8400-e29b-41d4-a716-446655440000

# Show the last N messages
nself claw history --last 10

nself claw threads

List topic threads — the branches that ɳClaw automatically creates when it detects a topic shift mid-conversation. Threads are organized under their parent topic using ltree paths.

# List all threads
nself claw threads

# List threads under a specific topic
nself claw threads --topic "health"

# Show thread details including message count and date range
nself claw threads --verbose

nself claw projects

Manage ɳClaw projects — named groupings of sessions and knowledge nodes. Projects let you organize long-running work (a client engagement, a product, a life area) as a coherent context unit.

# List all projects
nself claw projects

# Show sessions and knowledge nodes for a project
nself claw projects --name "nself"

# Create a new project
nself claw projects create --name "nself" --description "nSelf platform work"

# Archive a completed project
nself claw projects archive --name "old-client"

nself claw knowledge-base

Query the ɳClaw knowledge graph — the structured layer of extracted facts, decisions, entities, and relationships that ɳClaw builds over time. Supports semantic search via pgvector and full-text search via MeiliSearch.

# Full-text search the knowledge base
nself claw knowledge-base search "nself billing"

# Semantic / embedding search
nself claw knowledge-base search "what did I decide about pricing" --semantic

# Show all knowledge nodes for a topic
nself claw knowledge-base list --topic "work/nself"

# Show a specific node by ID
nself claw knowledge-base get <NODE_UUID>

# Show relationship graph for a node
nself claw knowledge-base graph <NODE_UUID>

nself claw chat

Open the ɳClaw web UI in your default browser. The web UI is served by the claw-web plugin at the URL configured in your .env (typicallyhttps://claw.local.nself.org in local dev).

nself claw chat
# Opens: https://claw.local.nself.org in your browser

nself claw pair

Pair a new ɳClaw client (mobile app or ClawDE) with this nSelf backend. Generates a time-limited pairing QR code or token.

# Generate a pairing QR code (display in terminal)
nself claw pair

# Generate a pairing token for CLI-based pairing
nself claw pair --token

nself claw unlock

Unlock an ɳClaw session that was automatically locked after an inactivity timeout. Prompts for your ɳClaw passphrase.

nself claw unlock

nself claw config

Show and edit ɳClaw plugin configuration: default model, context window, auto-topic settings.

# Show current ɳClaw config
nself claw config

# Set a config value
nself claw config set default_model gpt-4o

# Show available models
nself claw config models

nself claw keys

Manage API keys for ɳClaw's AI model providers (OpenAI, Anthropic, Ollama).

# List configured provider keys
nself claw keys list

# Set an OpenAI key
nself claw keys set openai sk-...

# Remove a key
nself claw keys remove anthropic

nself claw mcp

Manage Model Context Protocol (MCP) server connections for ɳClaw. MCP servers extend ɳClaw with additional tools (file system, browser, databases, APIs).

# List connected MCP servers
nself claw mcp list

# Add an MCP server
nself claw mcp add --name filesystem --command "npx @modelcontextprotocol/server-filesystem /home"

# Remove an MCP server
nself claw mcp remove filesystem

nself claw memories

Directly inspect and manage memory records — the atomic extractions ɳClaw makes from conversations (facts, preferences, decisions).

# List recent memories
nself claw memories

# Search memories
nself claw memories search "pricing decision"

# Delete a specific memory
nself claw memories delete <MEMORY_UUID>

# Summarize memories for a topic
nself claw memories summarize --topic "work/nself"

nself claw topics

Manage the ɳClaw topic taxonomy — the hierarchical label tree that organizes all sessions and memory.

# List all topics
nself claw topics

# Rename a topic
nself claw topics rename "work.old_project" "work.archive.old_project"

# Merge two topics
nself claw topics merge --from "finance.budget" --into "finance"

# Delete an empty topic
nself claw topics delete "temp"

nself claw prompt

Send a one-shot prompt to ɳClaw from the terminal without opening the web UI.

# Ask a question directly
nself claw prompt "What did I decide about the nself pricing model?"

# Include a file as context
nself claw prompt "Summarize this" --file ./report.md

nself claw proxy

Start a local HTTP proxy that forwards requests to the ɳClaw AI model backend, useful for integrating other tools with ɳClaw's configured providers.

nself claw proxy --port 8080

nself claw export

Export ɳClaw data (sessions, memories, knowledge nodes) to a portable archive.

# Export everything to a tar archive
nself claw export --output claw-backup-$(date +%Y%m%d).tar.gz

# Export only a specific topic
nself claw export --topic "work/nself" --output nself-topic.json

nself claw ingest

Import documents or data into the ɳClaw knowledge base for indexing and retrieval.

# Ingest a markdown file
nself claw ingest ./notes.md

# Ingest all markdown files in a directory
nself claw ingest ./docs/ --recursive

# Ingest with a custom topic tag
nself claw ingest ./report.pdf --topic "work/reports"

See also

• ɳClaw product overview
• nself ai — manage local LLM models and AI plugin stack
• Bundle reference — ɳClaw bundle plugin membership