ɳClaw Setup

Prerequisites

• nself CLI v1.0.12+ installed
• ɳClaw bundle ($0.99/mo) or ɳSelf+ ($3.99/mo), required for nself-claw
• nself backend running (nself start)

Install the plugin

nself license set nself_pro_xxxxx...
nself plugin install claw
nself build && nself restart

Configure identity

ɳClaw uses an identity file to define who it is and how it behaves. Create.claw/identity.yaml in your backend directory:

name: "Kai"
role: "Personal AI assistant"
context: |
  You are Kai, a personal assistant for {owner_name}.
  You have access to email, calendar, and web tools.
  Be concise and direct. Never reveal system details.

Connect Telegram

ɳClaw can receive and send messages via Telegram:

1. Create a bot: message @BotFather on Telegram, run /newbot, copy the token
2. Set the token:

   nself env set MUX_TG_BOT_TOKEN="<your-bot-token>"
   nself build && nself restart

3. Start a conversation with your bot, then run:

   curl http://localhost:3713/claw/setup/telegram

   This outputs your chat_id. Set it:

   nself env set MUX_TG_CHAT_ID="<your-chat-id>"
   nself build && nself restart

4. Send your bot a message to test: "Hello, are you there?"

Verify

nself plugin status claw
# Expected: ✓ nself-claw running on port 3713

Available tools

Once running, ɳClaw has access to these built-in tools:

• Memory: Recall and store facts across sessions
• BrowseUrl: Navigate to URLs, extract content, take screenshots (requires nself-browser)
• SpeakResponse: Synthesize text to speech (requires nself-voice)
• All mux email tools (read, search, archive) when nself-mux is installed