weaver onboard

Initialize Weaver configuration and workspace

The onboard command sets up Weaver for first-time use by creating the configuration file and workspace directory with default templates.

Usage

weaver onboard

What It Does

1. Creates configuration at ~/.weaver/config.json
2. Creates workspace directory with embedded templates
3. Prompts for overwrite if config already exists
4. Displays next steps for API key setup

Interactive Example

First run

$ weaver onboard
🕸️ weaver is ready!

Next steps:
  1. Add your API key to /home/user/.weaver/config.json
     Get one at: https://openrouter.ai/keys
  2. Chat: weaver agent -m "Hello!"

Generated Files

Configuration File

Location: ~/.weaver/config.json

Contains:

• Provider settings (OpenRouter, Anthropic, OpenAI, etc.)
• Agent defaults (model, temperature, max tokens)
• Gateway configuration (host, port)
• Channel settings (Telegram, Discord, Slack)
• Workspace path

Workspace Directory

Default location: ~/.weaver/workspace/

Structure:

workspace/
├── skills/         # Custom agent skills
├── cron/          # Scheduled task definitions
│   └── jobs.json
└── state/         # Runtime state storage

Exit Codes

Code	Reason
0	Success - config and workspace created
1	Failed to save config or create workspace

Error Conditions

Error saving config: permission denied

Ensure you have write permissions to ~/.weaver/

Error copying workspace templates: ...

Workspace directory creation failed - check disk space and permissions

Next Steps

After onboarding:

1. Add API Key

   Edit ~/.weaver/config.json and add your OpenRouter API key:

   "openrouter": {
     "api_key": "sk-or-..."
   }
   
2. Test Agent

   Verify setup with a test message:

   weaver agent -m "Hello!"
   
3. Start Gateway (Optional)

   Launch the gateway server for channel integrations:

   weaver gateway
   

Configuration Override

To re-run onboarding and overwrite existing config:

$ weaver onboard
Config already exists at /home/user/.weaver/config.json
Overwrite? (y/n): y
🕸️ weaver is ready!

Overwriting will reset all custom configuration. Back up your config first if you have custom settings.

Related Commands

• weaver status - Verify onboarding success
• weaver agent - Start using the agent
• weaver migrate - Migrate from OpenClaw instead of onboarding