clawdoc-onboarding

name	clawdoc-onboarding
description	Guided first-run setup for ClawDoc (the docs/skills themselves), NOT for OpenClaw runtime first-run (use openclaw-start for that). Walks through installing ClawDoc skills, configuring docs sync, and end-to-end verification of the ClawDoc layer. Triggers on: "ClawDoc first run", "ClawDoc setup", "install ClawDoc", "ClawDoc getting started", "set up ClawDoc skills", "ClawDoc install verification".

Routing hints

You should route to this skill when the user is installing ClawDoc for the first time, wants a guided walkthrough of the dual install modes, or needs help verifying their install completed successfully. References: README.md (the full setup walkthrough).

ClawDoc Onboarding

Walk a new ClawDoc user through their first successful setup in under 15 minutes.

What it checks

1. OpenClaw installed — binary reachable, gateway can start
2. Model configured — primary model set + auth configured
3. First channel connected — Discord, Telegram, or other
4. Verification — agent responds to first message

Step-by-step

Step 1 — Verify OpenClaw install

openclaw --version
openclaw gateway status

If gateway won't start → troubleshoot install first.

Step 2 — Configure model

Prompt user to pick a provider:

Provider	Effort	Best for
MiniMax	Low — free tier	New users, fast setup
OpenAI	Medium — needs API key	Advanced users
Gemini	Medium — needs API key	Advanced users
Ollama	High — local setup	Self-hosted enthusiasts

For MiniMax (recommended):

openclaw config set agents.defaults.model.primary "minimax/MiniMax-M2.7"
openclaw config set auth.profiles.minimax.provider "minimax"

Step 3 — Connect first channel

Discord (most common):

openclaw config set channels.discord.token "YOUR_BOT_TOKEN"
openclaw config set channels.discord.enabled true
openclaw gateway restart

Verify DM policy and pairing:

openclaw pairing approve discord <CODE>

Telegram:

openclaw config set channels.telegram.token "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

Step 4 — Install ClawDoc skills

# Via clawdhub (recommended)
clawdhub install https://github.com/Hashi-Ai-Dev/openclaw-clawdoc

# Or manual clone
git clone https://github.com/Hashi-Ai-Dev/openclaw-clawdoc.git ~/.openclaw/skills/openclaw

Step 5 — End-to-end verification

Ask user to send a test message:

@your-agent "Hello, are you working?"

Expected: agent responds within 10 seconds.

Common first-run failures

Symptom	Fix
"command not found"	OpenClaw not in PATH — check install location
"invalid config"	openclaw doctor --fix to auto-repair
Discord bot silent	Verify Message Content Intent enabled in Discord Developer Portal
Model auth failing	Check API key format, account credits
Gateway won't start	Port 18789 already in use — openclaw gateway restart

Output

## Onboarding Checklist — [date]

### Install
- [ ] openclaw --version succeeds
- [ ] Gateway can start

### Model
- [ ] Primary model set
- [ ] Auth configured

### Channel
- [ ] First channel connected
- [ ] Bot responds to DMs

### ClawDoc
- [ ] Skills installed
- [ ] Agent responds correctly

### Verification
- [ ] First test message succeeded

References

• references/first-run-guide.md — detailed first-run steps