openclaw
npx machina-cli add skill PaulRBerg/agent-skills/openclaw --openclawOpenClaw CLI
Overview
OpenClaw is a multi-channel messaging and agent platform. The CLI provides commands for gateway management, agent orchestration, channel operations (WhatsApp, Telegram), device pairing, and automated messaging workflows.
Quick Reference
# Check CLI version and help
openclaw --version
openclaw --help
# Setup and configuration
openclaw setup # Initialize config and workspace
openclaw onboard # Interactive setup wizard
openclaw configure # Set credentials and defaults
openclaw doctor # Health checks and diagnostics
# Gateway operations
openclaw gateway # Start the WebSocket gateway
openclaw gateway --port 18789 # Custom port
openclaw --dev gateway # Dev mode (isolated state, port 19001)
openclaw health # Check gateway health
openclaw status # Channel health and sessions
# Agent operations
openclaw agent --to +15555550123 --message "Hello"
openclaw agents # Manage agent workspaces
# Messaging
openclaw message send --target +15555550123 --message "Hi"
openclaw message send --channel telegram --target @mychat --message "Hi"
# Channel management
openclaw channels login --verbose # Link WhatsApp/Telegram
openclaw channels # Manage channels
# Device and session management
openclaw devices # Device pairing and tokens
openclaw sessions # List conversation sessions
Common Workflows
Initial Setup
openclaw setup
openclaw onboard
openclaw channels login --verbose
Start Gateway and Send Message
openclaw gateway &
openclaw message send --target +15555550123 --message "Test"
Run Agent Turn
openclaw agent --to +15555550123 --message "Run summary" --deliver
Profile Isolation
Use --dev or --profile <name> to isolate state:
openclaw --dev gateway # Uses ~/.openclaw-dev
openclaw --profile test gateway # Uses ~/.openclaw-test
Documentation
Run openclaw --help for the latest available commands and options.
Full documentation: https://docs.openclaw.ai/cli
Source
git clone https://github.com/PaulRBerg/agent-skills/blob/main/skills/openclaw/SKILL.mdView on GitHub Overview
OpenClaw CLI is a multi-channel messaging and agent platform controller. It exposes commands for gateway management, agent orchestration, channel operations (WhatsApp, Telegram), device pairing, and automated messaging workflows to streamline setup and runtime tasks.
How This Skill Works
The CLI issues commands to the OpenClaw backend to perform actions such as starting the gateway, configuring channels, managing agent workspaces, and sending messages. Users interact with commands like openclaw gateway, openclaw agent, openclaw message send, and openclaw channels login to orchestrate workflows and monitor health via status and health commands.
When to Use It
- Initial setup and onboarding: run setup, onboard, and channels login to configure environments.
- Starting the gateway and sending a test message to verify connectivity and channel delivery.
- Running agent turns or delivering automated messages to recipients.
- Managing devices, sessions, and channel health to ensure reliable operations.
- Isolating environments for testing or development using --dev or --profile and consulting documentation.
Quick Start
- Step 1: openclaw setup; openclaw onboard; openclaw channels login --verbose
- Step 2: openclaw gateway &; openclaw health; openclaw status
- Step 3: openclaw message send --target +15555550123 --message "Hello"
Best Practices
- Isolate test runs with --dev gateway or --profile <name> to avoid production interference.
- Run health checks frequently with openclaw doctor and openclaw health to detect issues early.
- Always login channels (WhatsApp/Telegram) before attempting messaging to ensure delivery targets are linked.
- Verify gateway status and channel health with openclaw status and openclaw health before large campaigns.
- Store credentials securely and consult the latest docs (Full documentation link) for updated commands.
Example Use Cases
- Onboard a new workspace and link channels: openclaw setup; openclaw onboard; openclaw channels login --verbose.
- Start the gateway and send a test message: openclaw gateway &; openclaw message send --target +15555550123 --message "Test".
- Run an agent turn to deliver a summary: openclaw agent --to +15555550123 --message "Run summary" --deliver.
- List devices and verify sessions: openclaw devices; openclaw sessions.
- Test in isolation: openclaw --dev gateway and openclaw --profile test gateway.
