菜单
Use when OpenClaw is not working, the gateway is not responding, the user wants to run openclaw doctor, debug OpenClaw, view openclaw logs, a channel is not responding, messages are not being delivered, the dashboard shows errors, or cron/heartbeat jobs are failing.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Audit one or more OpenClaw agents, analyse what they require (complexity, tool use, context window, volume, autonomy, sensitivity), and recommend the best-fit OpenRouter models by pricing tier with ready-to-paste openclaw.json config snippets. Use when the user says "what model should I use", "recommend a model for my agent", "audit my agent models", "find a cheaper model", "openrouter model suggestions", "which model fits my agent", or invokes /openclaw-model-advisor.
Create, optimize, and maintain OpenClaw agent workspace files — SOUL.md, IDENTITY.md, AGENTS.md, MEMORY.md, and GOALS.md. Use this skill whenever the user mentions OpenClaw agent setup, agent personality, agent identity, agent workspace files, SOUL.md, IDENTITY.md, AGENTS.md, MEMORY.md, GOALS.md, agent persona, "set up my agent", "configure my agent", "make my agent", or wants to scan/optimize/audit an existing OpenClaw workspace. Also trigger when the user wants to create a new agent from scratch, refine an agent's personality, add goals or memory structure, or review workspace files for consistency. This skill conducts targeted interviews, generates production-ready markdown files, and can scan existing workspaces to optimize them.
Diagnose and fix OpenClaw agent and gateway problems — heartbeats not firing, cron jobs failing, agents not responding, wrong routing, model errors, workspace issues, channel connection failures, and openclaw.json config errors. Use this skill when the user reports: agent not responding, heartbeat stopped, cron job not running, wrong agent getting messages, model errors, gateway won't start, channel disconnected, agent sending to wrong place, memory not writing, session errors, openclaw doctor errors, or any "something isn't working" situation with OpenClaw. This skill reads the openclaw.json config, interprets error patterns, walks through diagnostic steps, identifies the root cause, and produces the exact commands or file changes needed to fix it.
Brainstorm, design, and document OpenClaw agents and multi-agent teams. Use this skill whenever the user wants to plan what agents to build, figure out what agents they need, design agent capabilities and permissions, plan a multi-agent architecture, decide how agents should work together, or create documentation for their agent team. Also trigger when the user says things like "what agents do I need", "help me plan my agents", "I want to set up multiple agents", "document my agent", "agent permissions", "agent roles", "agent team", or asks about agent capabilities, responsibilities, tool access, or inter-agent communication. This skill produces a comprehensive Agent Team Documentation package (markdown + optional .docx) covering every agent's role, persona, permissions, tools, boundaries, and team interaction rules.
Surgically update existing OpenClaw agent workspace files based on conversational change requests — without rewriting the soul, persona, or hard limits. Use this skill when the user says things like "update the agent", "tell NEXUS about the new client", "HUNTER's ICP has changed", "add this to APEX's memory", "RPS paid their invoice", "change SENTINEL's heartbeat", "update the goals", "the client list changed", "add a new cron job", "remove the stale goal", "SCRIBE needs to know about ISO 14001 scope change", or any request to change, add, remove, or refresh content in an existing agent's workspace files. Also trigger when business state changes (new client, lost client, invoice paid, tender outcome, staff change, new service, pricing update) that should be reflected in agent memory. This skill identifies which files and sections need changing, shows exactly what will change before touching anything, makes surgical edits that preserve the persona soul, and outputs ready-to-apply file patches.
Run the complete IBS OpenClaw client onboarding process — from scoping a new client's agent requirements, through designing their agent architecture, building their workspace files and openclaw.json, to producing a professional handover package. Use this skill when IBS is onboarding a new client onto OpenClaw, productising the agent deployment service, creating a client's first agent setup, or when the user says things like "onboard this client", "set up OpenClaw for a new client", "create an agent for our client", "deploy agents for [company]", or "build the OpenClaw setup for [client name]". This skill runs the full IBS OpenClaw product workflow: client interview, needs assessment, architecture design, workspace generation, openclaw.json configuration, deploy script, and professional handover documentation.
| name | openclaw-troubleshooting |
| description | Use when OpenClaw is not working, the gateway is not responding, the user wants to run openclaw doctor, debug OpenClaw, view openclaw logs, a channel is not responding, messages are not being delivered, the dashboard shows errors, or cron/heartbeat jobs are failing. |
Diagnose and fix common OpenClaw issues using a systematic command ladder.
Run these in order for initial triage:
openclaw status # Quick health check
openclaw gateway status # Gateway runtime state
openclaw logs --follow # Real-time log stream
openclaw doctor # Config/service diagnostics
openclaw channels status --probe # Channel connectivity
Healthy signals:
openclaw gateway status shows Runtime: running and RPC probe: okopenclaw doctor reports no blocking issuesopenclaw channels status --probe shows channels connectedopenclaw status - is it running?openclaw gateway status - check runtime stateopenclaw logs --follow - look for errorsEADDRINUSE), missing auth on non-loopback bind, gateway.mode not set to "local"openclaw channels status --probe - channels connected?openclaw pairing list <channel> - pending pairing requests?dmPolicy and allowFrom in configrequireMention and groupPolicyopenclaw gateway status - verify gateway is runningopenclaw config get gateway.auth.token - check tokendmPolicy (pairing/allowlist/open/disabled)groupPolicy and requireMentionmention required, blocked, allowlist in logsopenclaw cron status - scheduler enabled?openclaw cron list - jobs exist?openclaw cron runs --id <jobId> --limit 20 - run historyquiet-hours, dm-blocked, requests-in-flightopenclaw nodes status - node online?openclaw nodes describe --node <id> - capabilitiesopenclaw approvals get --node <id> - exec approvalsopenclaw browser status - browser running?openclaw browser profiles - valid profiles?openclaw doctor # Validate config, show errors
openclaw doctor --fix # Auto-repair fixable issues
openclaw doctor --yes # Auto-repair without prompting
openclaw doctor --generate-gateway-token # Generate missing token
Doctor checks: config syntax/schema, service metadata, port availability, file permissions, browser paths.
openclaw logs --follow # Real-time stream
openclaw logs --tail 50 # Last N lines
OPENCLAW_LOG_LEVEL=debug openclaw status # Debug-level output
Log levels: trace > debug > info > warn > error
openclaw config get gateway.auth.mode - non-loopback binds now require authopenclaw config get gateway.bind - verify bind/auth alignmentopenclaw devices list - pending approvals after identity changesopenclaw pairing list <channel> - re-approve if neededopenclaw gateway install --force && openclaw gateway restart| Log Message | Meaning | Fix |
|---|---|---|
Gateway start blocked: set gateway.mode=local | Local mode not enabled | Set gateway.mode: "local" |
refusing to bind ... without auth | Non-loopback without token | Add gateway.auth.token |
EADDRINUSE | Port conflict | Change port or stop other process |
device identity required | Device auth not satisfied | Update client, check device pairing |
NODE_BACKGROUND_UNAVAILABLE | Node app not in foreground | Bring app to foreground |
SYSTEM_RUN_DENIED | Exec approval pending | Check openclaw approvals |
See references/common-issues.md for detailed troubleshooting per issue type.