OpenClaw FAQ 常见问题

快速答案 + 实际设置的深入故障排除

如果出现问题，前 60 秒

# 快速状态（第一次检查）
openclaw status

# 可粘贴的报告（安全分享）
openclaw status --all

# 守护进程 + 端口状态
openclaw gateway status

# 深度探测
openclaw status --deep

# 查看最新日志
openclaw logs --follow

# 运行医生（修复）
openclaw doctor

快速开始和首次运行设置

推荐的安装方式

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

打开仪表板

openclaw dashboard
# 或
http://127.0.0.1:18789/

需要什么运行时

Node >= 22 是必需的。推荐使用 pnpm。Bun 不推荐用于 Gateway。

它能在 Raspberry Pi 上运行吗

是的。Gateway 轻量级 - 文档列出 512MB-1GB RAM、1 核、约 500MB 磁盘足以供个人使用，并指出 Raspberry Pi 4 可以运行它。

什么是 OpenClaw

OpenClaw 是一个在您自己的设备上运行的个人 AI 助手。它在您已经使用的消息传递表面上回复（WhatsApp、Telegram、Slack、Mattermost、Discord、Google Chat、Signal、iMessage、WebChat），还可以在支持的平台上进行语音 + 实时 Canvas。Gateway 是始终在线的控制平面；助手是产品。

价值主张

• 您的设备，您的数据: 在您想要的任何地方运行 Gateway（Mac、Linux、VPS）并保持工作区 + 会话历史本地
• 真实频道: WhatsApp/Telegram/Slack/Discord/Signal/iMessage 等，加上移动语音和 Canvas
• 模型无关: 使用 Anthropic、OpenAI、MiniMax、OpenRouter 等，具有每个代理的路由和故障转移
• 纯本地选项: 运行本地模型以便所有数据可以保留在您的设备上
• 多代理路由: 每个频道、账户或任务的单独代理，每个都有自己的工作区和默认值
• 开源和可 hack: 检查、扩展和自托管，无供应商锁定

模型: 默认、选择、别名、切换

默认模型是什么

agents.defaults.model.primary 设置默认模型。agents.defaults.model.fallbacks 是全局故障转移。

推荐什么模型

• 最新一代、最佳层级模型，用于任何可以运行工具或接触文件/网络的机器人
• 避免较弱的层级（例如 Sonnet 或 Haiku）用于启用工具的代理或不受信任的收件箱

如何在不擦除配置的情况下切换模型

/model openai/gpt-5.2

或使用别名：

/model opus

Gateway: 端口、”已在运行”和远程模式

Gateway 使用什么端口

默认: 18789

配置/标志/环境: gateway.port、--port、OPENCLAW_GATEWAY_PORT

如何在远程模式下运行 OpenClaw

openclaw config set gateway.mode remote
openclaw config set gateway.remote.url "wss://gateway.example.com"

控制 UI 说 “未授权”

• 本地主机：将 gateway.auth.token 粘贴到控制 UI 设置中
• 远程：使用 Tailscale Serve 或 SSH 隧道

日志和调试

日志在哪里

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

openclaw gateway start
openclaw gateway stop
openclaw gateway restart

安全和访问控制

将 OpenClaw 暴露给入站 DM 安全吗

谨慎行事。使用配对/允许列表，启用沙盒，并保持工具权限收紧。

提示注入只与公共机器人有关吗

不是。即使只有您可以给机器人发消息，提示注入仍可通过机器人读取的任何不受信任内容发生。

我的机器人应该有自己的电子邮件/GitHub 账户或电话号码吗

是的，建议。将机器人身份与您的个人身份分开。

来源: https://docs.openclaw.ai/help/faq