MiniClaw
GitHub
MiniClaw

LOCAL-FIRST / OPEN SOURCE

Your local agent, ready to act.

Ask from a surface you already use. MiniClaw understands intent, checks boundaries, requests approval, and finishes the work on your machine.

Start in 5 minutesView source
  • TUILocal controlFull visibility
  • FeishuWork surfaceTeam delivery
  • TelegramMobile surfaceAlways reachable
  • DiscordCommunityIsolated delivery
CLAW TRACE / 01Action is not a black box.A request crosses six real runtime states, each with a boundary, result, and owner.
  1. MESSAGE_RECEIVEDaccepted
  2. AGENT_PLANNINGpending
  3. POLICY_CHECKpending
  4. APPROVALpending
  5. TOOL_EXECUTIONpending
  6. RESULT_DELIVEREDpending

FEATURES / 02

One core. Five inspectable system views.

Readable like a product, specific like an open-source system. Switch views to inspect structure, boundaries, and evidence.

01 / CORE LOOP

Message to result is a controlled execution path.

The model reads intent. Policy sets limits. Approval binds arguments. Only then can a Tool act.

  • Six-step Trace
  • OpenAI-compatible Provider
  • Results return in context
  • Structured execution records
  1. 01MESSAGE_RECEIVEDacceptedowner / tui
  2. 02AGENT_PLANNINGrunningintent → tool
  3. 03POLICY_CHECKallowedworkspace / argv
  4. 04APPROVALwaitingexact arguments
  5. 05TOOL_EXECUTIONrunningisolated action
  6. 06RESULT_DELIVEREDsucceededsame conversation

DEMO / 03

Inspect the real mechanism—not a feature screenshot.

Two animated execution paths, plus one channel diagram, show the workflows MiniClaw can substantiate today—actively evolving, so a screenshot would just go stale.

01 / REAL MECHANISM

Risky actions show impact and exact argv first.

The Owner decides with the target and parameters visible; approval never transfers to different arguments.

STEPS
5
SOURCE
real execution path
STATE
implementation evidence
  1. User request"send a safe greeting"
  2. exact argvprintf "Hello, MiniClaw!"
  3. Owner approvalarguments locked, awaiting confirm
  4. Isolated executiononly this exact argv runs
  5. Result deliveredback to the same conversation

RUN IT YOURSELF

Start local. See your first Trace.

Python 3.12+; the default TUI needs Node.js 22.19+. You keep every service credential.

Python 3.12+Node.js 22.19+
Read the install guideContribute
Run from source
git clone https://github.com/NEDONION/mini-claw.git
cd miniclaw
uv sync --extra dev --extra channels
pnpm --dir tui install
pnpm --dir tui build
cp .env.example .env
uv run miniclaw init
uv run miniclaw doctor
uv run miniclaw