Skip to main content

​
常见问题解答

快速解答以及针对实际环境的深入排查。运行时诊断见 故障排查。

​
如果出问题，前 60 秒先做什么

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

​
快速开始

​
推荐的 OpenClaw 安装和配置方式是什么？

建议从源码运行并使用入门向导： 
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

​
入门后如何打开仪表盘？

入门向导会自动打开无 Token 的仪表盘链接。保持该浏览器标签页打开。

​
需要什么运行时环境？

必须 Node.js 版本 ≥ 22，推荐 pnpm。Bun 不推荐用于 Gateway。

​
能在树莓派上运行吗？

能。Gateway 轻量，文档建议最低 512MB-1GB 内存，1 核，约 500MB 磁盘。

​
安装

​
如何在 Linux 上安装 OpenClaw？

直接依 Linux 指南，运行入门向导即可。 详见：Linux 平台

​
如何在 VPS 上安装 OpenClaw？

任何 Linux VPS 均可安装。直接在服务器上安装，SSH 或 Tailscale 远程访问 Gateway。 详见：exe.dev、Hetzner、Fly.io

​
OpenClaw 可以自我更新吗？

可行，但不推荐。更新时可能重启 Gateway。 CLI 命令有： 
openclaw update
openclaw update status
openclaw update --channel stable|beta|dev

​
配置

​
配置是什么格式，在哪？

配置文件：~/.openclaw/openclaw.json（JSON5 格式） 
openclaw config file
cat ~/.openclaw/openclaw.json

​
改了配置要重启吗？

是的，大多数配置变更需要重启 Gateway： 
openclaw gateway restart

​
网关

​
Gateway 用什么端口？

默认端口是 18789。 可以通过 --port 选项或配置 gateway.port 更改。

​
如何启动/停止/重启 Gateway 服务？

openclaw gateway start
openclaw gateway stop
openclaw gateway restart

​
Gateway 应该跑在笔记本还是 VPS？

想要全天候稳定用 VPS，想省钱且可接受断线睡眠则本地。 笔记本：无云费用，直连本地文件，有实时 UI。但睡眠、网络掉线会断开。 VPS：全天在线，网络稳定，无睡眠问题。

​
模型

​
什么是默认模型？

默认模型是 agents.defaults.model.primary 配置的模型。

​
推荐用什么模型？

  • 日常聊天：anthropic/claude-sonnet-4-5 或 openai/gpt-5.2
  • 代码编写：openai-codex/gpt-5.4 或 anthropic/claude-opus-4-6
  • 快速任务：openai/gpt-5.2-mini 或 anthropic/claude-haiku-4

​
日志和调试

​
日志在哪？

openclaw logs --follow
文件日志：~/.openclaw/gateway.log 或 /tmp/openclaw/openclaw-*.log

​
Gateway 启动但回复不来，怎么检查？

openclaw status
openclaw gateway status
openclaw channels status --probe
openclaw logs --follow

​
相关文档