Skip to main content
Weaver provides a powerful CLI for managing your AI agent orchestration service. All commands follow the pattern weaver <command> [options].

​
Quick Start

# Initialize Weaver
weaver onboard

# Chat with agent
weaver agent -m "Hello!"

# Start gateway server
weaver gateway

# Check status
weaver status

​
Available Commands

onboard

Initialize configuration and workspace

agent

Interact with the AI agent directly

gateway

Start the gateway server with channels

auth

Manage OAuth and token authentication

cron

Manage scheduled tasks

skills

Install and manage agent skills

migrate

Migrate from OpenClaw to Weaver

status

Show system status and configuration

​
Global Flags

​
--help
flag
Display help information for any command
​
--version
flag
Show version, build time, and Go versionAliases: -v, version

​
Exit Codes

CodeDescription
0Success
1General error (config, network, validation)

​
Terminal Output Format

Weaver uses the 🕸️ emoji as its logo prefix for all output: 
$ weaver agent -m "Hello!"
🕸️ Hello! How can I assist you today?

​
Configuration Path

Weaver stores configuration at ~/.weaver/config.json by default.

​
status

Check system status and configuration: 
weaver status

​
Output

The status command displays:
  • Version Information - Current version, build time, Go version
  • Configuration - Config file path and validation status
  • Workspace - Workspace directory path and validation
  • Model - Configured LLM model
  • Provider Status - API keys and authentication status for all providers
    • OpenRouter API
    • Anthropic API
    • OpenAI API
    • Gemini API
    • Zhipu API
    • Groq API
    • vLLM/Local endpoints
  • OAuth Status - Active OAuth sessions with expiration status

​
Example Output

🕸️ weaver Status
Version: v1.0.0 (git: abc1234)
Build: 2026-03-01T00:00:00Z

Config: /home/user/.weaver/config.json ✓
Workspace: /home/user/.weaver/workspace ✓
Model: gemini-3-flash-preview
OpenRouter API: ✓
Anthropic API: not set
OpenAI API: ✓
Gemini API: ✓
Zhipu API: not set
Groq API: ✓
vLLM/Local: not set

OAuth/Token Auth:
  openai (oauth): authenticated

​
Next Steps

Initial Setup

Get started with weaver onboard

Agent Usage

Learn interactive and message modes

Build docs developers (and LLMs) love

Get started for freeTalk to us