# IronClaw

Personal agent with routines, memory and configurable tool permissions.

Canonical profile: https://ki-agentenkompass.de/en/agents/ironclaw/
Editor: [Michael Meierhoff](https://ki-agentenkompass.de/en/about/)
Sources reviewed: 2026-10-16
Basis: provider documentation. Examples are editorial suggestions, not hands-on product tests.

## Overview

IronClaw is listed as a separate product profile.

- Provider: NEAR AI
- Product family: IronClaw
- Profile type: Self-hosted personal agent
- Environment: Own computer or server
- Connections: Tools and channels according to configuration
- Setup: Run the installer and configure a model provider.
- Pricing model: Open source; model and operating costs are separate.

## Key features

### Run routines

Schedules and webhooks trigger tasks.

Source: https://github.com/nearai/ironclaw

### Limit tools

WASM tools use explicit permissions.

Source: https://github.com/nearai/ironclaw

### Retrieve knowledge

Full-text and vector search retrieve stored context.

Source: https://github.com/nearai/ironclaw

### Connect channels

Connect the web interface, Telegram and Slack.

Source: https://github.com/nearai/ironclaw

### Extend with MCP

Connect additional tools through MCP.

Source: https://github.com/nearai/ironclaw

## Example workflows

### Try a webhook routine

- Your input: A test event and an allowed follow-up action.
- Possible result: A logged execution of the routine.
- What to check: Check content, permissions and actions taken.

### Find stored knowledge

- Your input: Approved notes and a specific question.
- Possible result: An answer based on stored context.
- What to check: Record time spent, corrections and costs.

## Requirements and limits

### Setup

Requirement: Configure the model, channels and permissions yourself.

Source: https://github.com/nearai/ironclaw

### German in everyday use

Not yet confirmed: End-to-end German interaction and output quality have not been tested here.

Source: https://github.com/nearai/ironclaw

### Reliability

Not yet confirmed: Success rates for specific workflows have not been measured here.

Source: https://github.com/nearai/ironclaw

## A good fit if …

- you want to run an agent on your own hardware with locally stored data and no telemetry
- you want routines triggered by cron, events or webhooks and reachable via Telegram or Slack
- you want to grant tool rights one by one and inspect source code under Apache-2.0 or MIT

## Less suitable if …

- you expect a managed service with an admin console and several users; the description says nothing on this
- you do not want to set up and maintain a database, services and model access yourself

Editorial assessment based on provider documentation. Not a product test.

## Usable AI models

Open choice

You can choose from more than twenty providers, including NEAR AI as the default, OpenRouter, Ollama and an OpenAI-compatible endpoint, and store the key as an environment variable. In a shared workspace, users pick only from the list an admin has approved for the active provider.

- Model families named: Anthropic (Claude), OpenAI (GPT), Google (Gemini), DeepSeek, Mistral, MiniMax, Z.ai (GLM), Alibaba (Qwen) · Other models can be connected freely
- Model choice: You choose
- Your own API key: Yes
- Router or custom endpoint: Yes
- Local models: Yes
- Depends on: Admin approval

Documented · Sources accessed on: 2026-11-05

- [IronClaw: Inference Providers](https://github.com/nearai/ironclaw/blob/main/docs/capabilities/llm-providers.md)

- [IronClaw: README](https://github.com/nearai/ironclaw)

## Europe & regional availability

Installation instructions and model prerequisites reviewed. The assessment covers the local operating path described; complete country and feature availability of all connected services remains open.

Reviewed scope: Local software and documented self-hosting; external services assessed separately
Reviewed on: 2026-10-19

### Self-hosting with own model access

With requirements

IronClaw documents local installers and setup with a chosen LLM provider and API key. The web UI is self-hosted; models and installed channel extensions need their own access.

Region covered: Europe: own computer or server; model services are country-specific

Documented reason: Technical assessment based on installation and provider selection. These sources do not establish a legal cause for regional restrictions.

Official source: https://raw.githubusercontent.com/nearai/ironclaw/main/README.md

## Accounts & permissions

Based on provider documentation. Permissions depend on the account, integration and organization policies. Review the permissions actually requested before use.

Configuration covered: Self-hosted IronClaw instance on your own machine or server
Sources reviewed: 2026-11-05

### Account used

Documented: Onboarding creates a login token for the web UI, which can be rotated. The model provider credential is kept in an encrypted local secret store, and secrets are not exposed to tools according to the description.

Evidence: https://github.com/nearai/ironclaw

### Admin approval

Open in reviewed sources: No organisation or admin approval is described; the project presents itself as a personal assistant. Rights of individual WASM tools are opted into explicitly.

Evidence: https://github.com/nearai/ironclaw

### Data access & team sharing

Documented with conditions: Data is stored locally, with no telemetry according to the project. Tool HTTP access is limited to explicitly approved hosts and paths. The reviewed page does not say whether several users are supported.

Evidence: https://github.com/nearai/ironclaw

## Prices and included usage

Pricing checked: 2026-10-16

Open source; model and operating costs are separate.

Total cost depends on access, usage and configuration.

Pricing details: https://github.com/nearai/ironclaw

## Operation & oversight

Based on public provider documentation. Assessments are editorial inferences from the stated properties. Actual time requirements and reliability have not been measured.

Deployment covered: Self-hosted instance running as a background service
Sources reviewed: 2026-11-05

### Files and working state

Documented: State lives by default under $HOME/.ironclaw/reborn. PostgreSQL or SQLite are named as storage; search combines full-text and vectors. Retention and backup are not described.

Evidence: https://github.com/nearai/ironclaw

### Sign-ins

Open in reviewed sources: The reviewed page mentions rotating the web login token but gives no expiry times and no behaviour when a sign-in expires.

Evidence: https://github.com/nearai/ironclaw

### Starting further runs

Documented: Routines start by cron schedule, event or webhook. A heartbeat handles proactive monitoring and maintenance. On macOS and Linux a background service runs.

Evidence: https://github.com/nearai/ironclaw

### Human intervention

Open in reviewed sources: Whether people must confirm tool calls beforehand is not described. Policy rules have severity levels such as Block, Warn, Review and Sanitize, but no review workflow is described.

Evidence: https://github.com/nearai/ironclaw

### Detecting errors

Documented with conditions: A full audit log of tool executions and a logs view in the web UI are mentioned. Format, retention and failure notifications are not described.

Evidence: https://github.com/nearai/ironclaw

### Resuming after failures

Documented with conditions: The page lists automatic detection and recovery of stuck operations. How jobs are resumed or retried is not stated; configuration changes need a manual service restart.

Evidence: https://github.com/nearai/ironclaw

### Editorial assessment

Since you run it yourself, the database, updates and backups are your responsibility. Per-action approval and failure alerts are not settled in the description.

## Memory and conversation continuity

Scope: Workspace memory and memory tools
Sources accessed: 2026-11-04

Persistent documents are used through hybrid search and explicit write tools.

### Storage and scope

Partly documented: Memory stores documents under virtual workspace paths with a search index; the inspected guide names no backend type.

- [Memory capability](https://raw.githubusercontent.com/nearai/ironclaw/main/docs/capabilities/memory/memory.mdx)

### Selection and timing

Documented: Instructions require retrieval before questions about the past and saving useful summaries at task completion.

- [Memory capability](https://raw.githubusercontent.com/nearai/ironclaw/main/docs/capabilities/memory/memory.mdx)

### Inspect, edit and delete

Partly documented: Tools read, search and overwrite documents; a deletion tool is not listed among the four described tools.

- [Memory capability](https://raw.githubusercontent.com/nearai/ironclaw/main/docs/capabilities/memory/memory.mdx)

### Agent and channel boundaries

Partly documented: Documents remain in the workspace across sessions. Fine-grained user, project and channel access boundaries are not described there.

- [Memory capability](https://raw.githubusercontent.com/nearai/ironclaw/main/docs/capabilities/memory/memory.mdx)

### Retrieval

Documented: Hybrid search combines full-text and vector search; documents can also be read by known paths.

- [Memory capability](https://raw.githubusercontent.com/nearai/ironclaw/main/docs/capabilities/memory/memory.mdx)
- [IronClaw repository](https://github.com/nearai/ironclaw)

### Session reset and compaction

Partly documented: Workspace documents remain persistently available across sessions. The guide describes no specific relationship with conversation compaction.

- [Memory capability](https://raw.githubusercontent.com/nearai/ironclaw/main/docs/capabilities/memory/memory.mdx)

## Context

Configure the model, channels and permissions yourself.

Provider sources reviewed; examples are editorial. No hands-on tests.

## Open points

Requirements and limits, not yet confirmed:
- German in everyday use
- Reliability

## Sources

- https://github.com/nearai/ironclaw

## Provider

Publishes IronClaw and the linked product information.

- Operator: NEAR AI
- Organization: Open-source project
- Website: https://github.com/nearai/ironclaw
- Reviewed: 2026-10-16

- Provider source: https://github.com/nearai/ironclaw

[Sources and method](https://ki-agentenkompass.de/en/sources/)
