MetaClaw

(โ˜… 3,492)

๐Ÿฆž Just talk to your agent โ€” it learns and EVOLVES ๐Ÿงฌ.

File Explorer

ZIP Download
  • .gitignore
  • LICENSE
  • pyproject.toml
  • README.md
  • requirements.txt

# Installation Guide

python
Prerequisites

Setup Steps

curl -LO https://github.com/aiming-lab/MetaClaw/releases/download/v0.4.0/metaclaw-plugin.zip

Download the MetaClaw OpenClaw plugin package.

unzip metaclaw-plugin.zip -d ~/.openclaw/extensions

Extract the downloaded plugin to OpenClaw extensions directory.

openclaw plugins enable metaclaw-openclaw && openclaw gateway restart

Enable the plugin and restart the gateway.

pip install -e ".[rl,evolve,scheduler]"

Install the python package with full features (RL, evolve, scheduler).

metaclaw setup

Run the interactive setup wizard to configure agents and auth.

metaclaw start

Start MetaClaw in default auto mode (skills + scheduled RL training).

Key Commands

pip install -e .

Install package in lightweight skills_only mode.

pip install -e ".[rl]"

Install package with RL training support.

metaclaw setup

Run the MetaClaw initial setup wizard.

metaclaw start

Start MetaClaw in default auto mode.

metaclaw start --mode rl

Run RL training immediately on full batch without scheduler.

metaclaw start --mode skills_only

Run with skills only and no RL.

metaclaw config wechat.enabled true

Enable WeChat integration.

Prepare your OpenAI-compatible LLM API key or required OAuth tokens before running.

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Command Glossary

Commands referenced in this DOCs, explained below.

๐Ÿ”

npx

View Details โ–ผ

This command is an alias of `npm exec`.

tldr npm exec

View documentation for the original command:

๐Ÿ”

openclaw

View Details โ–ผ

A personal AI assistant that you run on your own devices.
Some subcommands such as `onboard`, `agent`, `doctor`, etc. have their own usage documentation.
See also: `zeroclaw`.

openclaw onboard --install-daemon

Run the onboarding wizard to set up the gateway and channels:

openclaw gateway --allow-unconfigured --port {{18789}} --verbose

Start the gateway server:

openclaw message send {{[-t|--target]}} {{+1234567890}} {{[-m|--message]}} "{{Hello}}"

Send a message to a contact:

๐Ÿ”

pip install

View Details โ–ผ

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

๐Ÿ”

unzip

View Details โ–ผ

Extract files/directories from Zip archives.
See also: `zip`.

unzip {{path/to/archive1.zip path/to/archive2.zip ...}}

Extract all files/directories from specific archives into the current directory:

unzip {{path/to/archive1.zip path/to/archive2.zip ...}} -d {{path/to/output}}

Extract files/directories from archives to a specific path:

unzip -c {{path/to/archive1.zip path/to/archive2.zip ...}}

Extract files/directories from archives to `stdout` alongside the extracted file names:

๐Ÿ”

zeroclaw service

View Details โ–ผ

Manage the ZeroClaw background service (launchd/systemd user service).

zeroclaw service install

Install the daemon service:

zeroclaw service start

Start the daemon service:

zeroclaw service stop

Stop the daemon service:

๐Ÿ”

zeroclaw

View Details โ–ผ

Fast, small, and fully autonomous AI assistant infrastructure.
Some subcommands such as `onboard`, `models`, `service`, etc have their own usage documentation.
See also: `openclaw`.

zeroclaw onboard --api-key {{api_key}} --provider {{openrouter|anthropic|openai|...}}

Initialize workspace and configuration (quick setup):

zeroclaw onboard --interactive

Run the full interactive onboarding wizard:

zeroclaw agent {{[-m|--message]}} "{{Hello, ZeroClaw!}}"

Send a single message to the AI agent:

๐Ÿ”

systemctl

View Details โ–ผ

Control the systemd system and service manager.
Some subcommands such as `disable`, `status`, `reboot` etc. have their own usage documentation.

systemctl status

Show all running services:

systemctl --failed

List failed units:

systemctl {{start|stop|restart|reload|status}} {{unit}}

Start/Stop/Restart/Reload/Show the status of a service:

๐Ÿ”

launchctl

View Details โ–ผ

Control Apple's `launchd` manager for launch daemons (system-wide services) and launch agents (per-user programs).
`launchd` loads XML-based `*.plist` files placed in the appropriate locations, and runs the corresponding commands according to their defined schedule.

launchctl load ~/Library/LaunchAgents/{{my_script}}.plist

Activate a user-specific agent to be loaded into `launchd` whenever the user logs in:

sudo launchctl load /Library/LaunchAgents/{{root_script}}.plist

Activate an agent which requires root privileges to run and/or should be loaded whenever any user logs in (note the absence of `~` in the path):

sudo launchctl load /Library/LaunchDaemons/{{system_daemon}}.plist

Activate a system-wide daemon to be loaded whenever the system boots up (even if no user logs in):

// repository documentation