客户常见问题解答：腰痛要不要拍片子？

FAQ - OpenClaw

OpenClaw Docs

Search documentation

OpenClaw Docs

Documentation

On this page

On this page

View as Markdown View this page as plain text

Open in ChatGPT Ask questions about this page

Open in Claude Ask questions about this page

Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS, multi-agent, OAuth/API keys, model failover). For runtime diagnostics, see Troubleshooting . For the full config reference, see Configuration .

This page is an index. The day-to-day FAQ is split across thirteen pages, one per

topic. The triage ladder stays on this page; open the page that matches your question.

Read it when

What is OpenClaw?

You are evaluating OpenClaw, or explaining what it is and who funds it.

Skills and automation

You are customizing skills, or a cron job, reminder, or subagent misbehaved.

Sandboxing and memory

You are tuning the sandbox, or memory is not persisting.

Where things live on disk

You need to find, back up, move, or remove OpenClaw data.

Config basics

You are editing config, enabling web search, or recovering from config.apply .

Remote gateways and nodes

You run the Gateway on a VPS or another machine, or you are adding a node.

Env vars and .env loading

You are setting keys through env or .env , or the service lost them.

Sessions and multiple chats

You are managing sessions, resets, context limits, groups, or several bots.

Gateway ports, already running, and remote mode

The Gateway will not bind, says it is already running, or you want remote mode.

Logging and debugging

You need logs or a service restart, or replies never arrive.

Media and attachments

A skill produced an image or PDF but nothing was sent.

Security and access control

You are exposing OpenClaw to inbound messages or judging plugin risk.

Chat commands, aborting tasks, and stopping a run

A task will not stop, or you are tuning slash commands and the queue.

First 60 seconds if something is broken

Quick status

openclaw status

Fast local summary: OS + update, Gateway/service reachability, agents/sessions, provider config + runtime issues (when the Gateway is reachable).

Pasteable report (safe to share)

openclaw status --all

Read-only diagnosis with a log tail (tokens redacted).

Daemon + port state

openclaw gateway status

Shows supervisor runtime vs RPC reachability, the probe target URL, and which config the service likely used.

Deep probes

openclaw status --deep

Live Gateway health probe, including channel probes when supported (requires a reachable Gateway). See Health .

Tail the latest log

openclaw logs --follow

If RPC is down, fall back to:

tail -f "/tmp/openclaw/openclaw- $(date +%F) .log" # Named profile example: tail -f "/tmp/openclaw/openclaw-dev- $(date +%F) .log"

File logs are separate from service logs; see Logging and Troubleshooting .

Run the doctor (repairs)

openclaw doctor

Repairs/migrates config and state, then runs health checks. See Doctor .

Gateway snapshot (WS-only)

openclaw health --json openclaw health --verbose # shows the target URL + config path on errors

Asks the running Gateway for a full snapshot. See Health .

Quick start and first-run setup

First-run Q&A - install, onboard, auth routes, subscriptions, initial failures - lives on the First-run FAQ .

Models, failover, and auth profiles

Model Q&A - defaults, selection, aliases, switching, failover, auth profiles - lives on the Models FAQ .

Miscellaneous

What is the default model for Anthropic with an API key?

Credentials and model selection are separate. Setting ANTHROPIC_API_KEY (or storing an Anthropic API key in auth profiles) enables authentication, but the actual default model is whatever you configure in agents.defaults.model.primary (for example anthropic/claude-sonnet-4-6 or anthropic/claude-opus-4-6 ). No credentials found for profile "anthropic:default" means the Gateway could not find Anthropic credentials in the SQLite auth stores available to the running agent.

Still stuck? Ask in Discord or use the GitHub issue chooser .

Where each section moved

Every question heading from the previous single-page version keeps its anchor

here, so an existing link such as /help/faq#where-things-live-on-disk still

resolves. Each entry points at the page that now holds the answer.

What is OpenClaw?

What is OpenClaw, in one paragraph?

Can my team share one OpenClaw?

Value proposition

I just set it up - what should I do first?

What are the top five everyday use cases for OpenClaw?

Can OpenClaw help with lead gen, outreach, ads, and blogs for a SaaS?

Is OpenClaw owned by OpenAI?

What does OpenClaw send to the Foundation?

How is OpenClaw funded, and how does that compare?

What are the advantages vs Claude Code for web development?

Skills and automation

How do I customize skills without keeping the repo dirty?

Can I load skills from a custom folder?

How can I use different models or settings for different tasks?

The bot freezes while doing heavy work. How do I offload that?

How do thread-bound subagent sessions work on Discord?

A subagent finished, but the completion update went to the wrong place or never posted. What should I check?

Cron or reminders do not fire. What should I check?

Cron fired, but nothing was sent to the channel. Why?

Why did an isolated cron run switch models or retry once?

How do I install skills on Linux?

Can OpenClaw run tasks on a schedule or continuously in the background?

Can I run Apple macOS-only skills from Linux?

Do you have a Notion or HeyGen integration?

How do I use my existing signed-in Chrome with OpenClaw?

Sandboxing and memory

Is there a dedicated sandboxing doc?

Docker feels limited - how do I enable full features?

Can I keep DMs personal but make groups public/sandboxed with one agent?

How do I bind a host folder into the sandbox?

How does memory work?

Memory keeps forgetting things. How do I make it stick?

Does memory persist forever? What are the limits?

Does semantic memory search require an OpenAI API key?

Where things live on disk

Is all data used with OpenClaw saved locally?

Where does OpenClaw store its data?

Where should AGENTS.md / SOUL.md / USER.md / MEMORY.md live?

Can I make SOUL.md bigger?

Recommended backup strategy

How do I completely uninstall OpenClaw?

Can agents work outside the workspace?

Remote mode: where is the session store?

Config basics

What format is the config? Where is it?

I set gateway.bind: "lan" (or "tailnet") and now nothing listens / the UI says unauthorized

Why do I need a token on localhost now?

Do I have to restart after changing config?

How do I enable web search (and web fetch)?

config.apply wiped my config. How do I recover and avoid this?

How do I run a central Gateway with specialized workers across devices?

Can the OpenClaw browser run headless?

How do I use Brave for browser control?

Remote gateways and nodes

How do commands propagate between Telegram, the gateway, and nodes?

How can my agent access my computer if the Gateway is hosted remotely?

Tailscale is connected but I get no replies. What now?

Can two OpenClaw instances talk to each other (local + VPS)?

Do I need separate VPSes for multiple agents?

Is there a benefit to using a node on my personal laptop instead of SSH from a VPS?

Do nodes run a gateway service?

Is there an API / RPC way to apply config?

Minimal sane config for a first install

How do I set up Tailscale on a VPS and connect from my Mac?

How do I connect a Mac node to a remote Gateway (Tailscale Serve)?

Should I install on a second laptop or just add a node?

Env vars and .env loading

How does OpenClaw load environment variables?

I started the Gateway via the service and my env vars disappeared. What now?

I set COPILOT_GITHUB_TOKEN, but models status shows "Shell env: off." Why?

Sessions and multiple chats

How do I start a fresh conversation?

Do sessions reset automatically if I never send /new?

Is there a way to make a team of OpenClaw instances (one CEO and many agents)?

Why did context get truncated mid-task? How do I prevent it?

How do I completely reset OpenClaw but keep it installed?

I am getting "context too large" errors - how do I reset or compact?

Why am I seeing "LLM request rejected: messages.content.tool_use.input field required"?

Why am I getting heartbeat messages every 30 minutes?

Do I need to add a "bot account" to a WhatsApp group?

How do I get the JID of a WhatsApp group?

Why does OpenClaw not reply in a group?

Do groups/threads share context with DMs?

How many workspaces and agents can I create?

Can I run multiple bots or chats at the same time (Slack), and how should I set that up?

Gateway: ports, "already running", and remote mode

What port does the Gateway use?

Why does openclaw gateway status say "Runtime: running" but "Connectivity probe: failed"?

Why does openclaw gateway status show "Config (cli)" and "Config (service)" different?

What does "another gateway instance is already listening" mean?

How do I run OpenClaw in remote mode (client connects to a Gateway elsewhere)?

The Control UI says "unauthorized" (or keeps reconnecting). What now?

I set gateway.bind tailnet but it listens only on loopback

Can I run multiple Gateways on the same host?

What does "invalid handshake" / code 1008 mean?

Logging and debugging

Where are logs?

How do I start/stop/restart the Gateway service?

I closed my terminal on Windows - how do I restart OpenClaw?

The Gateway is up but replies never arrive. What should I check?

"Disconnected from gateway: no reason" - what now?

Telegram setMyCommands fails. What should I check?

TUI shows no output. What should I check?

How do I completely stop then start the Gateway?

ELI5: openclaw gateway restart vs openclaw gateway

Fastest way to get more details when something fails

Media and attachments

My skill generated an image/PDF, but nothing was sent

Security and access control

Is it safe to expose OpenClaw to inbound DMs?

Is prompt injection only a concern for public bots?

Is OpenClaw less safe because it uses TypeScript/Node instead of Rust/WASM?

I saw reports about exposed OpenClaw instances. What should I check?

Are ClawHub skills and third-party plugins safe to install?

Should my bot have its own email, GitHub account, or phone number?

Can I give it autonomy over my text messages and is that safe?

Can I use cheaper models for personal assistant tasks?

I ran /start in Telegram but did not get a pairing code

WhatsApp: will it message my contacts? How does pairing work?

Chat commands, aborting tasks, and "it will not stop"

How do I stop internal system messages from showing in chat?

How do I stop/cancel a running task?

How do I send a Discord message from Telegram? ("Cross-context messaging denied")

Why does it feel like the bot "ignores" rapid-fire messages?

First-run FAQ - install, onboard, auth, subscriptions, early failures

Models FAQ - model selection, failover, auth profiles

Troubleshooting - symptom-first triage

Was this useful? Yes No

Open issue

Pull up a chair.

There’s a place for you in the AI future. Join the Community on Reddit, Discord, and X.

An OpenClaw Foundation project.

Open-source assistant infrastructure.

© 2026 OpenClaw Foundation

Esc Cancel

Suggested searches

Install OpenClaw

Connect Telegram

Troubleshoot the Gateway

Build a plugin

Responses are generated using AI and may contain mistakes.