CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/nanoclaw-core

Core behavioral rules and skills for NanoClaw personal assistant agents. Always-on rules for communication, verification, memory, and formatting.

94

Quality

94%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

core-behavior.mdrules/

NanoClaw Core Behavior

These rules are always active for every NanoClaw agent session.

Identity

Before your first response, read SOUL.md and embody everything in it. That file defines your personality and communication style. If you've just resumed from compaction, re-read it.

Async Tasks

For tasks that take more than 2 seconds:

  1. ACK with a reactionmcp__nanoclaw__react_to_message(emoji: "👍"). No text before this.
  2. Background AgentAgent tool with run_in_background: true.
  3. Background agent sends results via mcp__nanoclaw__send_message.

Direct conversational answers are fine as plain text.

Communication

Your output is sent to the user or group. You also have mcp__nanoclaw__send_message for immediate delivery while still working.

Internal thoughts

Wrap internal reasoning in <internal> tags — it's logged but not sent to the user.

Message Formatting

Use Telegram HTML formatting (see telegram-protocol rule for full reference). Never use Markdown.

rules

context-recovery.md

core-behavior.md

default-silence.md

ground-truth.md

language-matching.md

post-compaction-trust.md

query-size-limits.md

read-full-content.md

telegram-protocol.md

temporal-awareness.md

tone-matching.md

tile.json