← 返回命令列表

Linux command

nullclaw 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Start interactive agent

nullclaw agent

Send a single message

nullclaw agent -m "[message]"

Start the HTTP gateway

nullclaw gateway --port [3000]

Run the onboarding wizard

nullclaw onboard --interactive

Start a messaging channel

nullclaw channel start [telegram]

Check system health

nullclaw status

Run diagnostics

nullclaw doctor

Install as a system service

nullclaw service install

说明

nullclaw is a minimalist AI agent framework built entirely in Zig, delivering a single static 678 KB binary with under 2 ms startup time and approximately 1 MB peak memory usage. It runs on any hardware with a CPU — ARM, x86, and RISC-V architectures are supported without modification. The framework integrates 22+ AI providers (including Anthropic, OpenAI, Ollama, and OpenRouter), 18 communication channels (Telegram, Signal, Discord, Slack, iMessage, Matrix, WhatsApp, IRC, and more), and customizable tools — all with zero external runtime dependencies beyond libc. All subsystems use vtable interfaces enabling swappable implementations without code changes. This covers providers, channels, memory backends, tools, runtimes, and security sandboxes. The memory system uses hybrid search combining FTS5 full-text indexing with vector similarity within SQLite.

参数

agent
Interactive or single-message conversation mode.
-m, --message _MESSAGE_
Execute a single message then exit (used with agent).
gateway
Start HTTP runtime with integrated channels.
--port _PORT_
Listen port for the gateway (default: 3000).
onboard
Configuration wizard for initial setup.
--api-key _KEY_
Set API key directly during onboarding.
--provider _PROVIDER_
Specify model provider during onboarding.
--interactive
Step-by-step interactive configuration.
channel {start|stop|status} _CHANNEL_NAME_
Manage messaging integrations.
service {install|status|stop}
Background daemon management.
status
Display system health and configuration summary.
doctor
Run comprehensive system diagnostics.
migrate openclaw --dry-run
Import data from compatible systems. Use --dry-run to preview without applying.

FAQ

What is the nullclaw command used for?

nullclaw is a minimalist AI agent framework built entirely in Zig, delivering a single static 678 KB binary with under 2 ms startup time and approximately 1 MB peak memory usage. It runs on any hardware with a CPU — ARM, x86, and RISC-V architectures are supported without modification. The framework integrates 22+ AI providers (including Anthropic, OpenAI, Ollama, and OpenRouter), 18 communication channels (Telegram, Signal, Discord, Slack, iMessage, Matrix, WhatsApp, IRC, and more), and customizable tools — all with zero external runtime dependencies beyond libc. All subsystems use vtable interfaces enabling swappable implementations without code changes. This covers providers, channels, memory backends, tools, runtimes, and security sandboxes. The memory system uses hybrid search combining FTS5 full-text indexing with vector similarity within SQLite.

How do I run a basic nullclaw example?

Run `nullclaw agent` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does agent do in nullclaw?

Interactive or single-message conversation mode.