openclaw-ops
A comprehensive operations guide for OpenClaw, covering installation, configuration, model management, migration, cron tasks, security checks, and debugging.
About this skill
This skill provides a complete operational manual for the OpenClaw system, detailing everything from initial setup and model configuration to advanced topics like migration, backup/restore procedures, and routine maintenance. It includes specific instructions for managing OpenAI Codex OAuth, hot-reload rules for models, and Gateway service administration, ensuring a robust and well-maintained OpenClaw environment. Users would leverage this skill to streamline their OpenClaw management tasks, troubleshoot issues efficiently, and maintain the system's security and performance. It serves as a centralized knowledge base for both routine operations and complex scenarios like system migrations or disaster recovery. The comprehensive nature of this skill makes it indispensable for administrators and developers working with OpenClaw, allowing them to quickly access critical information and execute complex procedures with confidence, reducing downtime and ensuring operational continuity.
Best use case
The primary use case is for managing, maintaining, migrating, securing, and troubleshooting the OpenClaw system. System administrators, DevOps engineers, and developers who are responsible for the uptime, performance, and configuration of an OpenClaw instance will benefit most by having a structured, AI-guided resource for these complex operational tasks.
A comprehensive operations guide for OpenClaw, covering installation, configuration, model management, migration, cron tasks, security checks, and debugging.
Users can expect successful setup, migration, maintenance, and troubleshooting of their OpenClaw system, leading to stable and secure operations.
Practical example
Example input
I need to configure OpenClaw's OpenAI OAuth settings for GPT-5.4. Can you guide me through the process?
Example output
Okay, I can help with that. To configure OpenAI Codex OAuth for GPT-5.4, I will refer to `setup/openai-oauth.md`. First, ensure you have your GPT-5.4 subscription details ready. Then, I will guide you through authenticating OpenClaw with your OpenAI account. What's the first step you'd like to take, or should I proceed?
When to use this skill
- When setting up or configuring new OpenClaw instances or components.
- When migrating an OpenClaw setup between different machines, especially Mac-to-Mac.
- When performing routine maintenance, backups, security audits, or troubleshooting OpenClaw errors.
- When managing OpenClaw's models, gateways, or cron jobs.
When not to use this skill
- When performing tasks unrelated to OpenClaw system operations.
- When seeking general AI agent development or coding assistance not specific to OpenClaw.
- When the issue is with the underlying operating system or hardware, not OpenClaw itself.
How openclaw-ops Compares
| Feature / Agent | openclaw-ops | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | easy | N/A |
Frequently Asked Questions
What does this skill do?
A comprehensive operations guide for OpenClaw, covering installation, configuration, model management, migration, cron tasks, security checks, and debugging.
How difficult is it to install?
The installation complexity is rated as easy. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
SKILL.md Source
# OpenClaw 運維全指南 > 實戰驗證於 2026-03-08 | OpenClaw 2026.3.2 | macOS (Apple Silicon) 本 skill 涵蓋 OpenClaw 的完整運維知識。以下是各文件索引和使用場景。 ## 文件索引 ### 安裝與設定 | 文件 | 場景 | |------|------| | [setup/openai-oauth.md](setup/openai-oauth.md) | 設定 OpenAI Codex OAuth（GPT-5.4 訂閱） | | [setup/model-config.md](setup/model-config.md) | 主力/備援模型、別名、hot-reload 規則 | | [setup/gateway.md](setup/gateway.md) | Gateway 服務管理、LaunchAgent、日誌 | ### 遷移 | 文件 | 場景 | |------|------| | [migration/mac-to-mac.md](migration/mac-to-mac.md) | Mac-to-Mac 遷移實戰紀錄（含踩坑） | > 完整遷移 SOP 另見對應的 AI agent migration skill（如有設定）。 ### 備份與還原 | 文件 | 場景 | |------|------| | [backup/backup-guide.md](backup/backup-guide.md) | 完整備份策略（含外部依賴 manifest） | | [scripts/backup.sh](scripts/backup.sh) | 一鍵全量備份（core + 外部 + 系統） | | [scripts/restore.sh](scripts/restore.sh) | 從備份還原到新機器 | ### 日常運維 | 文件 | 場景 | |------|------| | [cron/jobs-inventory.md](cron/jobs-inventory.md) | 全部 cron 任務清單、排程、外部依賴 | ### 安全 | 文件 | 場景 | |------|------| | [security/audit-guide.md](security/audit-guide.md) | 安全檢查指南、清理 checklist、假陽性說明 | | [scripts/security-audit.sh](scripts/security-audit.sh) | 一鍵安全掃描（密碼/token/key/IP 洩漏偵測） | ### 排錯 | 文件 | 場景 | |------|------| | [troubleshooting/common-issues.md](troubleshooting/common-issues.md) | 10 個常見問題排解（附真實錯誤訊息） | --- ## 快速參考 ### 常用指令 ```bash openclaw --version # 版本 openclaw gateway health # Gateway + Telegram 健康檢查 openclaw models status # 模型 + auth 狀態 openclaw cron list --all # 所有 cron jobs openclaw agents list # 所有 agents openclaw channels status --probe # 通道即時測試 openclaw cron run <job-id> # 手動觸發 cron job ``` ### 重啟 Gateway ```bash launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.gateway.plist launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.gateway.plist ``` ### 安全掃描 ```bash bash scripts/security-audit.sh # 帶密碼掃描 AUDIT_PASSWORDS="mypassword" bash scripts/security-audit.sh ``` --- ## 環境快照範例 > 根據你的實際部署修改以下值。 ``` Primary Model : <your-primary-model> Fallbacks : <fallback-1>, <fallback-2> Auth Providers: <provider-1> (OAuth), <provider-2> (OAuth), ... Gateway : port 18789, LaunchAgent, Telegram @<your-bot> Active Cron : <N> jobs (heartbeat, patrol, etc.) CLI Tools : gcloud, gh (<your-gh-user>), python3, curl, git ``` ## 相關 Skills 如果你有設定對應的 AI agent skills，可參照： - 跨機器遷移 SOP（7 Phase） - 日常管理操作
Related Skills
OpenClaw Mastery — The Complete Agent Engineering & Operations System
> Built by AfrexAI — the team that runs 9+ production agents 24/7 on OpenClaw.
openclaw-safe-change-flow
Safe OpenClaw config change workflow with backup, minimal edits, validation, health checks, and rollback. Single-instance first; secondary instance optional.
jqopenclaw-node-invoker
统一通过 Gateway 的 node.invoke 调用 JQOpenClawNode 能力（file.read、file.write、process.exec、process.manage、system.run、process.which、system.info、system.screenshot、system.notify、system.clipboard、system.input、node.selfUpdate）。当用户需要远程文件读写、文件移动/删除、目录创建/删除、进程管理（列表/搜索/终止）、远程进程执行、命令可执行性探测、系统信息采集、截图采集、系统弹窗、系统剪贴板读写、输入控制（鼠标/键盘）、节点自更新、节点命令可用性排查或修复 node.invoke 参数错误时使用。
linux-shell-scripting
Provide production-ready shell script templates for common Linux system administration tasks including backups, monitoring, user management, log analysis, and automation. These scripts serve as building blocks for security operations and penetration testing environments.
iterate-pr
Iterate on a PR until CI passes. Use when you need to fix CI failures, address review feedback, or continuously push fixes until all checks are green. Automates the feedback-fix-push-wait cycle.
istio-traffic-management
Comprehensive guide to Istio traffic management for production service mesh deployments.
incident-runbook-templates
Production-ready templates for incident response runbooks covering detection, triage, mitigation, resolution, and communication.
incident-response-smart-fix
[Extended thinking: This workflow implements a sophisticated debugging and resolution pipeline that leverages AI-assisted debugging tools and observability platforms to systematically diagnose and res
incident-responder
Expert SRE incident responder specializing in rapid problem resolution, modern observability, and comprehensive incident management.
expo-cicd-workflows
Helps understand and write EAS workflow YAML files for Expo projects. Use this skill when the user asks about CI/CD or workflows in an Expo or EAS context, mentions .eas/workflows/, or wants help with EAS build pipelines or deployment automation.
error-diagnostics-error-trace
You are an error tracking and observability expert specializing in implementing comprehensive error monitoring solutions. Set up error tracking systems, configure alerts, implement structured logging,
error-debugging-error-trace
You are an error tracking and observability expert specializing in implementing comprehensive error monitoring solutions. Set up error tracking systems, configure alerts, implement structured logging, and ensure teams can quickly identify and resolve production issues.