VerifiedPlugin
openclaw-workspace
A Claude Code skill for maintaining and optimizing OpenClaw workspace files — the markdown files that form an AI agent's soul, memory, and operating procedures.
1 skill
@win4rAgent Orchestration
Plugin
openclaw-skill
A comprehensive Agent Skill for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway.
Plugin Signal47/100Fair
maintained42
capable14
documented100
adopted53
Install
$ npx -y skills add win4r/openclaw-skill --agent claude-code
What's inside
README
OpenClaw Agent Skill 🦞
中文文档 | English
A comprehensive Agent Skill for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway.
What is This?
This is an Agent Skill designed for AI coding assistants (like Claude with Antigravity). Once installed, the AI assistant gains deep knowledge of OpenClaw and can help you with:
- Installation & Updates — Install, upgrade, or migrate OpenClaw
- Configuration — Edit
openclaw.json, set up models, manage secrets - Channel Management — Set up WhatsApp, Telegram, Discord, Slack, iMessage, and 15+ other channels
- Gateway Operations — Start, stop, restart, health check, remote access
- Multi-Agent Routing — Configure multiple agents with isolated workspaces and sessions
- ACP Agents — Spawn external AI runtimes (Codex, Claude Code, Gemini CLI, 14+ harnesses)
- Browser Automation — Multi-profile browser control, Chrome MCP existing-session, snapshots/refs
- Plugin System — Capability model, context engine plugins, SDK, hook API
- Automation — Cron jobs, standing orders, background tasks, webhooks, hooks
- Security Hardening — Audit, lock down access, manage tokens, trusted proxy, incident response
- Troubleshooting — Diagnose and fix common errors from CLI and Gateway
Skill Structure
OpenClaw-Skill/
├── SKILL.md # Main entry (core workflows, commands, troubleshooting)
└── references/
├── architecture.md # Gateway architecture, wire protocol, pairing, invariants
├── agent_runtime.md # Agent runtime, bootstrap, agent loop, hooks, timeouts
├── bonjour.md # Bonjour/mDNS: TXT keys, wide-area DNS-SD, debugging
├── channel_routing.md # Channel routing, session keys, Mattermost, BlueBubbles
├── channels.md # 20+ channel setup guides (WhatsApp, Telegram, Discord, etc.)
├── clawhub.md # ClawHub public skill registry, CLI commands
├── gateway_internals.md # Network model, lock, health, doctor, logging, background exec
├── gateway_ops.md # Gateway operations, service management
├── heartbeat.md # Heartbeat: config, delivery, visibility, HEARTBEAT.md
├── media.md # Media: camera capture, images, audio/voice notes, transcription
├── memory.md # Memory system, vector search, hybrid BM25, QMD backend
├── model_failover.md # Model failover, OAuth, auth profiles, cooldowns
├── multi_agent.md # Multi-agent routing, bindings, per-agent config
├── pairing.md # Gateway pairing: node approval, CLI, API, auto-approval
├── polls.md # Polls (Telegram, WhatsApp, Discord, MS Teams)
├── presence_discovery.md # Presence system, discovery (Bonjour/Tailscale)
├── providers.md # 35+ model providers (Anthropic, OpenAI, Google, Ollama, etc.)
├── queue.md # Command queue: steer/followup/collect modes
├── security.md # Auth, access control, hardening baseline
├── streaming.md # Block streaming, chunking, coalescing, preview modes
├── thinking.md # Thinking levels, verbose directives, reasoning visibility
├── tui.md # TUI: keyboard shortcuts, slash commands, pickers, local shell
├── voice.md # Talk Mode (voice interaction) + Voice Wake (wake words)
└── ... (51 reference files total)
Total: ~6,000+ lines of structured reference covering all core OpenClaw functionality.
Installation
For Antigravity (Claude)
Copy the skill folder to your Antigravity skills directory:
# Clone this repo
git clone https://github.com/win4r/OpenClaw-Skill.git
# Copy to your skills directory
cp -r OpenClaw-Skill ~/.gemini/antigravity/skills/openclaw
The skill will be automatically detected and triggered when you ask about OpenClaw-related tasks.
For Other AI Assistants
The SKILL.md and references/ files contain structured documentation that can be adapted for any AI assistant that supports skill/knowledge injection.
Usage Examples
Once installed, just ask naturally:
| What You Say | What the AI Does |
|---|---|
| "Help me upgrade OpenClaw" | Runs npm install -g openclaw@latest, openclaw doctor, restarts Gateway, verifies |
| "Set up a Telegram bot" | Walks through bot creation, token setup, config, and verification |
| "Gateway is not responding" | Runs diagnostic command ladder: status → logs → doctor → channels probe |
| "Lock down my OpenClaw security" | Runs security audit, applies hardened baseline, fixes permissions |
| "Add a second agent for work" | Creates agent, sets up workspace, configures bindings, restarts |
| "Spawn a Codex ACP session" | Configures acpx plugin, sets permissions, spawns bound session |
| "Attach browser to my Chrome" | Sets up user profile with Chrome MCP existing-session driver |
| "EADDRINUSE error" | Identifies port conflict, runs openclaw gateway --force or changes port |
Key Commands Quick Reference
# Status & Health
openclaw status # Overall status
openclaw gateway status # Gateway daemon status
openclaw doctor # Diagnose issues
openclaw channels status --probe # Channel health
# Gateway Management
openclaw gateway install # Install as system service
openclaw gateway start/stop/restart
# Configuration
openclaw config get <path> # Read config value
openclaw config set <path> <value> # Set config value
openclaw configure # Interactive wizard
# Security
openclaw security audit # Check security posture
openclaw security audit --fix # Auto-fix issues
openclaw secrets reload # Reload secret refs
# Channels
openclaw channels add # Add channel (wizard)
openclaw channels login # WhatsApp QR pairing
openclaw channels list # Show configured channels
# Models
openclaw models set <model> # Set default model
openclaw models status --probe # Check auth status
Documentation Source
This skill is built from the official OpenClaw Documentation, covering:
- Install
- Gateway Architecture
- Agent Runtime
- Agent Loop
- Configuration
- Channels
- Model Providers
- Model Failover & OAuth
- Tools
- Thinking Levels
- Command Queue
- Streaming & Chunking
- Memory & Vector Search
- ClawHub Registry
- Multi-Agent Routing
- Talk Mode & Voice Wake
- Polls
- Presence & Discovery
- ACP Agents
- Sandboxing
- Automation (Cron, Webhooks, Hooks)
- Background Tasks
- Standing Orders
- Context Engine
- Plugin Architecture
- Browser Tool
- Agent Send
- Security
- Formal Verification
- Troubleshooting
- CLI Reference
License
This skill is provided as-is for use with AI assistants. OpenClaw itself is MIT licensed.
Contributing
Issues and PRs welcome! If OpenClaw releases new features or changes, feel free to update the reference files accordingly.
File tree
win4r/openclaw-skillView on GitHub
README_CN.md README.md references/ acp_agents.md agent_runtime.md architecture.md automation.md bonjour.md browser.md channel_routing.md channel_troubleshooting.md channels.md clawhub.md config_reference.md diffs_firecrawl.md elevated.md exec_approvals.md exec.md gateway_internals.md gateway_ops.md heartbeat.md hooks.md install.md llm_task.md lobster.md media.md memory.md model_failover.md multi_agent.md nodes.md openprose.md pairing.md pdf_tool.md platforms.md plugins.md polls.md presence_discovery.md providers.md queue.md remote_access.md sandboxing.md secrets.md security.md sessions.md skills.md slash_commands.md streaming.md subagents.md thinking.md tools.md tui.md voice.md web_tools.md web_ui.md SKILL.md
More Flows by @win4r.
@win4rFAQ
openclaw-skill is a Claude Code plugin with 1 hand-picked skill for agent orchestration work, indexed on Flowy. Install it with the command on its page. It includes OpenClaw-Skill. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is openclaw-skill?
- A comprehensive Agent Skill for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway.
- How do I install openclaw-skill?
- Run these in Claude Code: npx -y skills add win4r/openclaw-skill --agent claude-code. Then prompt normally.
- Does openclaw-skill auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is openclaw-skill free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.