Overview
The argent CLI is the primary interface for managing your ArgentOS installation. It handles gateway management, channel configuration, memory operations, and system status.
Installation
The CLI is installed automatically during setup:
After installation, the argent command is available in your PATH.
Always use argent (not openclaw). The openclaw command is the legacy OpenClaw CLI, which is incompatible with ArgentOS. It does not support ArgentOS-specific features like the model router, intent governance, or execution worker, and will produce errors on ArgentOS configuration keys.
Command Groups
| Group | Description |
|---|
argent gateway | Start, stop, and manage the gateway service |
argent channels | Add, remove, and configure channels |
argent memory | Search and manage agent memory |
argent status | System health overview |
argent setup | Initial configuration wizard |
argent license | License management |
argent tasks | Task management |
argent config | Configuration management |
argent dashboard | Open the web dashboard |
argent marketplace | Browse and install packages |
Global Options
| Flag | Description |
|---|
--help | Show help for a command |
--version | Show ArgentOS version |
--verbose | Increase log output |
--config <path> | Use alternative config file |
Common Workflows
First-Time Setup
Daily Operations
Troubleshooting
npx argentos init # Install
argent setup # Configure API keys
argent gateway start # Start the gateway
argent channels add telegram # Connect a channel
argent status # Check system health
argent gateway logs -f # Monitor activity
argent tasks list # View tasks
argent memory search "query" # Search memory
argent gateway status # Check gateway
argent config validate # Validate config
argent gateway restart # Restart gateway
argent gateway logs # View logs
Tab Completion
Enable tab completion for your shell:
argent completion bash >> ~/.bashrc
