openclaw-ops

Files (1)

• SKILL.md

SKILL.md (first lines)

# OpenClaw Ops — Self-Management Skill

One skill for all OpenClaw operations: config, troubleshoot, sessions, nodes.

## Config Location

- **Config**: `~/.openclaw/openclaw.json` (JSON5)
- **Cron**: `~/.openclaw/cron/jobs.json`
- **Logs**: `/tmp/openclaw/openclaw-YYYY-MM-DD.log`
- **Sessions**: `~/.openclaw/agents/main/sessions/`

Always `cat ~/.openclaw/openclaw.json` before editing.

---

## 1. Models & Providers

### Switch primary model
Edit `agents.list[0].model.primary`:
```json5
"model": { "primary": "kimi/kimi-k2.5", "fallbacks": ["anthropic/claude-opus-4-6"] }
```

### Add provider
```json5
"models": { "providers": { "new-provider": {
  "baseUrl": "https://api.example.com/v1",
  "api": "openai-completions",  // or anthropic-messages | google-generative-ai
  "apiKey": "${NEW_API_KEY}",
  "models": [{ "id": "model-id", "name": "Name", "contextWindow": 128000, "maxTokens": 8192 }]
}}}
```

### Quick model switch (no restart)
Use `/model kimi/kimi-k2.5` in chat, or `session_status(model="anthropic/claude-opus-4-6")`.

---

## 2. Cron Jobs

```bash
openclaw cron list                                    # List all
openclaw cron add --name "Brief" --cron "0 7 * * *" \
  --tz "Asia/Kuala_Lumpur" --session isolated \
  --message "Morning summary" --announce \
  --channel telegram --to "267378578"                 # Recurring
openclaw cron add --name "Remind" --at "20m" \
  --session main --system-event "Check deploy" \
  --wake now --delete-after-run                       # One-shot
openclaw cron edit <jobId> --message "New prompt"     # Edit
openclaw cron run <jobId>                             # Force run
openclaw cron runs --id <jobId> --limit 5             # History
```

| Session type | Use for |
|---|---|
| `main` | Uses heartbeat context, shared session |
| `isolated` | Fresh per run, delivery supported |

---

## 3. Channels

### Telegram (current)
```json5
"telegram": { "enabled": true, "botToken": "...", "dmPolicy": "pairing", "streaming": "partial" }
```

### Add Discord / WhatsApp / Signal
```json5
"discord": { "enabled": true, "token": "${DISCORD_BOT_TOKEN}" }
"whatsapp": { "dmPolicy": "pairing", "allowFrom": ["+60..."] }
"signal": { "enabled": true, "allowFrom": ["+60..."] }
```

---

## 4. Tools & Agents

| Profile | Scope |
|---|---|
| `minimal` | session_status only |
| `coding` | fs + runtime + sessions + memory |
| `messaging` | messaging + sessions |
| `full` | Everything (current) |

### Multi-agent
```json5
"agents": { "list": [
  { "id": "main", "default": true, ... },
  { "id": "public", "tools": { "profile": "messaging", "deny": ["exec","browser"] } }
]},
"bindings": [{ "agentId": "public", "match": { "channel": "telegram", "peer": { "kind": "group" } } }]
```

---

## 5. Sessions & Sub-Agents

```
sessions_list()                                    # All sessions
sessions_list(activeMinutes=60)                    # Recent
sessions_history(sessionKey="<key>", limit=20)     # History
sessions_send(sessionKey="<key>", message="...")   # Send to session
```

### Spawn sub-agent
```
sessions_spawn(task="Research X", mode="run")                    # One-shot
sessions_spawn(task="Fix bug", runtime="acp", thread=true)      # Coding agent
```

### Manage
```
subagents(action="list")                          # List running
subagents(action="steer", target="<id>", message="Focus on API")
subagents(action="kill", target="<id>")           # Kill stuck
```

From ariffazil/arifOS, AGPL-3.0.

More from ariffazil/arifOS