NextClaw

An open-source, extensible, local-first self-hosted agent workspace that takes you from one request to a usable result without losing work in between.

Source repo
Peiiii/nextclaw
Stars
★ 262
Last updated
1d ago
License
MIT
Primary language
TypeScript

At a glance

How it runs
Desktop appCLISelf-hosted service
Works with
Universal · cross-platformCodex · Claude Code
Cost
Free software; you pay for model usage
Setup effort
Low · running in minutes
You'll need
Node.js LTS (for npm install)pnpm (for source development)Docker (optional server deployment)Shell / CLINetwork accessLocal filesystemMCP Server
Typical use
A researcher who collects web pages, notes, and references and needs them turned into a brief, source list, or comparison table
Not a fit if
  • Remote deployments that require HTTPS by default
  • Users who need long-term stable use without connecting their own model provider

What does this agent do, and when should you use it?

NextClaw is an open-source, self-hosted agent workspace positioned as a long-term personal AI partner, deployable on macOS, Windows, Linux, Docker, and cloud VMs. It ships as a desktop app, an npm package, and a first-class nextclaw CLI, serving a local web workspace by default at 127.0.0.1:55667. Core capabilities include task workspaces that keep conversations, local files, web research, and generated documents in one context; multi-runtime execution with Native, Codex, Claude Code, OpenCode, and Hermes; Dedicated Agents with their own role, memory, skills, and runtime; scheduled tasks; messaging channels such as Weixin, Feishu/Lark, QQ, and Telegram; and persistent Panel Apps you build with the agent. Models include a built-in free-trial gateway plus OpenRouter, OpenAI, Anthropic, Gemini, DeepSeek, and custom OpenAI-compatible endpoints. The project is working toward a 1.0 that understands users, takes initiative, and improves itself, but full acceptance testing is incomplete and no release date is set.

You issue a request in the local workspace — a report, data analysis, file operation, small app, or recurring task — and NextClaw organizes the tools and steps behind it. Concretely it can: collect pages, notes, and references into a brief, source list, or comparison table; gather data from websites, CSV files, or spreadsheets, clean it, draw charts, and write conclusions; shape source material into reports, articles, proposals, or weekly updates; inspect, rename, extract, classify, and summarize local documents; turn repeated jobs into scripts, local apps (Panel Apps), or reusable workflows; and receive requests from chat channels, run scheduled briefs, and deliver results to an AI Inbox. Each task can run on Native, Codex, Claude Code, OpenCode, or Hermes at start time while keeping the Agent's identity, workspace, memory, and skills. The workspace opens code, Markdown, HTML, Word, Excel, and PowerPoint beside the conversation, supports image generation, a skill market (MCP servers, CLI tools, browser control), and configurable model providers.

  1. A researcher who collects web pages, notes, and references and needs them turned into a brief, source list, or comparison table
  2. A data worker who needs to pull data from CSVs or spreadsheets, clean it, plot charts, and write conclusions
  3. Users processing many local documents who want to inspect, rename, classify, and summarize files without losing task context
  4. Developers or power users who want to turn recurring jobs into scripts, dashboards, or reusable workflows
  5. Teams on Weixin, Feishu, or Telegram who want to send tasks from chat, receive scheduled briefs, and get results back in the right channel

How do you install or deploy this agent?

Desktop app: download the latest stable release for macOS, Windows, or Linux from https://nextclaw.io/en/download/. Via npm: install Node.js LTS first, then run:

npm install -g nextclaw
nextclaw start

Open http://127.0.0.1:55667 and start with the built-in free-trial model; no API key required. Docker (for long-running servers or cloud VMs):

curl -fsSL https://nextclaw.io/install-docker.sh | bash

Port 55667 on remote hosts serves plain HTTP; terminate HTTPS with Nginx or Caddy for regular access. From source: run pnpm install && pnpm dev start at the repo root, optionally split with pnpm dev:backend / pnpm dev:frontend. The default data directory is ~/.nextclaw; set NEXTCLAW_HOME for isolation.

How do you use this agent?

After starting, issue natural-language requests in the web workspace at 127.0.0.1:55667 — reports, data analysis, or file operations. Choose a runtime (Native, Codex, Claude Code, OpenCode, or Hermes) when starting a task. Inspect and edit generated files (code, Markdown, Office documents, images) beside the conversation, and keep generated pages as Panel Apps to improve later. In settings, connect messaging channels (Weixin, Feishu/Lark, QQ, Telegram, Slack, etc.) so Agents can receive and reply to messages, configure scheduled jobs for recurring briefs or checks, and route results to the AI Inbox. CLI users can run core operations via nextclaw commands with machine-readable output for scripts, CI, or other Agents. Stop the service with nextclaw stop. The built-in free trial uses a public gateway — avoid sending sensitive data; connect your own provider for production use.

What are this agent's strengths and limitations?

Pros
  • Local-first and self-hosted: configuration, conversations, and credentials stay in an environment you control, with desktop, server, NAS, and Docker deployment paths
  • Multi-runtime architecture: switch between Native, Codex, Claude Code, OpenCode, and Hermes while keeping the Agent's identity, workspace, memory, and skills
  • Complete task context: conversations, local files, research, and generated documents stay in one task, with in-place preview including Office formats
  • Broad connectivity: a dozen messaging channels and many model providers, plus custom OpenAI-compatible endpoints
  • First-class CLI: nextclaw commands support scripts, CI jobs, and other Agents with machine-readable output
Limitations
  • The 1.0 goals (proactive analysis, continuous self-improvement) are planned scope; acceptance testing is incomplete with no release date
  • The built-in free trial runs through a public gateway with changing limits and models — unsuitable for sensitive or confidential data
  • Remote deployments default to plain HTTP on port 55667; you must set up Nginx/Caddy HTTPS termination for production
  • Memory usage increases during active work, so you should consult the official resource-usage documentation before sizing deployments
  • Long-term stable use requires connecting your own model provider; the free gateway is trial only

How does this agent compare with similar options?

NextClaw's acknowledgements note that its early exploration was inspired by OpenClaw (a full-stack AI assistant) and NanoBot (a small, extensible agent framework), useful as reference projects in the same space.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
NextClaw This agent 58 · Major gaps Desktop appFree + model costs ★ 262 1d ago TypeScript Codex · Claude Code
somora 69 · Some gaps CLIFree ★ 34 7d ago TypeScript ChatGPT · Codex · Claude Code
MyAgents 57 · Major gaps Desktop appFree + model costs ★ 580 1d ago TypeScript Codex · Claude Code · Claude API
PocketPaw 46 · Major gaps Desktop appFree + model costs ★ 894 1mo ago Python Codex · OpenAI API · Claude API

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
58/ 100 5-point scale 2.9 / 5
This review covers the source as of Sep 10, 2026. The project has shipped 18 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 13/29
Reliability 9/14
Adaptability 10/18
Convention 13/18
Effectiveness 9/13
Verifiability 4/8
Why each dimension lost points
Trust13 / 29 · 2.2/5

Evidence: README states config, conversations, and credentials stay local and warns the public trial gateway should not carry sensitive data — decent data-flow transparency; SECURITY.md candidly discloses a 2026 malicious @nextclaw/bird marketplace skill with removal, scanning, republish-rescan, and mirror reconciliation — unusually transparent incident handling. Deductions: no fine-grained least-privilege model documented despite broad capabilities (local files, browser, messaging channels); user-confirmation flows and external-effect controls (remote channel delivery, cron) are not shown in the provided files; rollback appears only as an unfinished 1.0 plan item.

Reliability9 / 14 · 3.2/5

Evidence: the aigen package has vitest unit tests (CLI tree, stable JSON error codes, provider response parsing); the repo carries extensive governance/lint/smoke scripts and release-preflight workflows, structurally self-consistent. Deductions: visible tests only cover the image-generation submodule; no test evidence for core agent runtime behavior; long serial build/lint/tsc chains are fragile to external source failures; failure-message quality is evidenced for one package only.

Adaptability10 / 18 · 2.8/5

Evidence: README clearly defines audience (long-term personal AI partner) and scenarios (research, data, documents, local files, scheduling); multi-runtime (Native/Codex/Claude Code/OpenCode/Hermes) and multi-platform (macOS/Windows/Linux/Docker/cloud) fit well documented; provider and channel lists detailed. Deductions: 1.0 acceptance incomplete and capability boundaries mostly deferred to linked gap-analysis docs; trigger precision (cron/channel matching) has no file evidence.

Convention13 / 18 · 3.6/5

Evidence: full MIT LICENSE consistent with README badge, upstream acknowledgements (OpenClaw, NanoBot) give clear attribution; install notes cover desktop/npm/Docker including port and reverse-proxy cautions; planning docs (ROADMAP, PRD, gap analysis) are public and honestly state 1.0 is unfinished with no release date; changesets and release-preflight workflows exist. Deductions: no CHANGELOG file in evidence — release notes live off-repo; maintenance responsibility rests on a single unverified publisher with no multi-maintainer evidence.

Effectiveness9 / 13 · 3.5/5

Evidence: clear positioning (local-first, multi-runtime, machine-readable CLI output), free trial lowers entry cost, resource-usage docs referenced, concrete use cases. Deductions: effectiveness and correctness are asserted, not statically verifiable; the security cost of the public gateway is covered by a single warning sentence rather than substantive guidance.

Verifiability4 / 8 · 2.5/5

Evidence: README claims (install methods, port, Node 22, test commands) are corroborable against package., workflows, and test files; planned vs current scope is explicitly separated. Deductions: external sources (npm metrics, docs site, Docker install script) fall outside the provided files so cross-source corroboration is limited; performance and 'usable result' claims cannot be verified statically.

Risks and how to mitigate them
  • Static review with low confidence: nothing was installed or executed; effectiveness claims rest on file evidence only.
  • This repository disclosed a malicious marketplace skill (@nextclaw/bird) containing remote-execution instructions, live 2026-02-27 to 2026-08-11. If installed, verify your SKILL.md SHA-256 and follow SECURITY.md remediation steps.
  • The free trial routes through a public gateway; the README itself warns against sending sensitive or confidential data — do not send private content before attaching your own provider.
  • The agent can operate local files, browsers, multiple messaging channels, and scheduled jobs — a large permission surface; deploy in an isolated environment and vet channel and skill sources.
  • 1.0 acceptance is incomplete and capability boundaries live in external links; confirm the current feature scope before relying on it.
  • Publisher identity is unverified and maintenance rests on a single party; continuity of updates and security patches is uncertain.
Evidence confidence: Low Reviewed Sep 10, 2026 Reviewed revision 45f4b2575e46 New commits since this review; the score may not cover them
See the full review method →

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. [email protected] NextClaw v0.59.3
    Release notes excerpt
    NextClaw v0.59.3 中文 长会话压缩恢复、大历史按需加载,并修复 Windows 会话创建与导入。 压缩与恢复 - 保留原始历史并确认执行条件:不完整摘要不会被当作完整历史。上下文仍可容纳时延后压缩;必须缩减时保存恢复检查点,先回读历史或明确澄清业务条件,再继续执行其它工具。 大历史加载 - 按页加载与原文分片:页面、原文读取和运行缓存设有容量预算。需要重建索引时显示准备进度,可停止和重试;首次准备仍需扫描原始记录。 Windows 会话 - 修复创建与快照导入:修复 Windows 目录同步引发的 EPERM;源记录和恢复意图文件仍执行落盘,普通文件写入错误会明确返回。0.59.2 未推广至 Runtime 通道,本版整合其长会话改进。 升级与回退 - 保留配置与原始记录:通过 stable NPM 和 runtime 通道交付。旧版不能直接继续写入使用新恢复语义的会话,回退需先由当前版本恢复成完整快照;本次不发布新的桌面安装包。 [查看完整更新说明](https://docs.nextclaw.io/zh/notes/2026-10-20-nextclaw-v0-59-3) English …
    View on GitHub ↗
  2. v0.59.1-desktop.1 NextClaw Desktop 0.0.302
    Release notes excerpt
    NextClaw v0.59.1 中文 上下文压缩后保留已有进展,减少重复调查和重复执行。 长任务连续性 - 保留执行事实与近期轮次:摘要保留工具身份与结果,继承已完成事项并更新下一步;近期完整轮次按预算保留,后续新增内容只投影一次。压缩失败保持上次检查点,执行状态不完整时先核对结果。 [查看完整更新说明](https://docs.nextclaw.io/zh/notes/2026-10-09-nextclaw-v0-59-1) English Preserve task progress after compaction to reduce repeated investigation and execution. Long-task continuity …
    View on GitHub ↗
  3. [email protected] NextClaw v0.59.1
    Release notes excerpt
    NextClaw v0.59.1 中文 上下文压缩后保留已有进展,减少重复调查和重复执行。 长任务连续性 - 保留执行事实与近期轮次:摘要保留工具身份与结果,继承已完成事项并更新下一步;近期完整轮次按预算保留,后续新增内容只投影一次。压缩失败保持上次检查点,执行状态不完整时先核对结果。 [查看完整更新说明](https://docs.nextclaw.io/zh/notes/2026-10-09-nextclaw-v0-59-1) English Preserve task progress after compaction to reduce repeated investigation and execution. Long-task continuity …
    View on GitHub ↗

FAQ

Can I keep using the free trial forever?
No. The built-in free trial uses a public gateway whose limits and models may change; the README explicitly advises against sending sensitive or confidential data through it. Connect your own provider for production.
Where is my data stored?
Configuration, conversations, and credentials stay in an environment you control, by default ~/.nextclaw (changeable via NEXTCLAW_HOME); data you send through connected providers and channels passes through them.
Is remote server deployment secure?
Port 55667 on remote hosts is plain HTTP, fine only for a quick check; for regular access terminate HTTPS with Nginx or Caddy. The Docker guide covers reverse proxy, domain, and remote access setup.
Am I locked into a paid model?
No. It supports OpenRouter, OpenAI, Anthropic, Gemini, DeepSeek, MiniMax, Moonshot, DashScope, Zhipu, vLLM, and any OpenAI-compatible endpoint, including self-hosted vLLM.
Who is this for?
It fits individuals or small teams willing to deploy and maintain a service who want data and context kept local, plus multi-channel chat, scheduled tasks, and multi-runtime execution; users unwilling to operate infrastructure will find deployment and security setup a real cost.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents