常见问题 FAQ

安装相关

Q: OpenClaw 支持哪些操作系统？

A: OpenClaw 支持 macOS、Linux 和 Windows（通过 WSL2）。推荐使用 macOS 或 Linux 获得最佳体验。

Q: Node.js 版本要求是什么？

A: 需要 Node.js 22.16+ 或 Node 24（推荐）。可以使用 node -v 检查当前版本。

Q: 安装时遇到权限错误怎么办？

A: 在 macOS/Linux 上运行：

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Q: 国内网络环境下安装慢怎么办？

A: 配置国内镜像：

npm config set registry https://registry.npmmirror.com

配置相关

Q: 如何配置 AI 模型？

A: 编辑 ~/.openclaw/openclaw.json：

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

或使用 openclaw onboard 引导配置。

Q: 支持哪些 AI 模型？

A: OpenClaw 支持多种模型：

• OpenAI (GPT-4, GPT-4o)
• Anthropic (Claude 系列)
• 智谱 GLM
• 豆包/火山引擎
• 本地模型 (Ollama)

Q: 如何配置消息渠道？

A: 不同渠道有不同的配置方式：

• Telegram: 设置 TELEGRAM_BOT_TOKEN 环境变量
• WhatsApp: 运行 openclaw channels login 扫码登录
• Discord: 设置 DISCORD_BOT_TOKEN 环境变量

详见 渠道配置

使用相关

Q: 如何发送消息给 AI？

A: 使用 CLI：

openclaw agent --message "你的问题"

或通过已连接的消息渠道直接发送消息。

Q: 如何安装 Skills？

A:

# 列出可用 Skills
openclaw skills list

# 安装 Skill
openclaw skills install <skill-name>

Q: Gateway 是什么？

A: Gateway 是 OpenClaw 的控制平面，负责：

• 管理会话和状态
• 路由消息到正确的渠道
• 执行工具和 Skills
• 提供 WebSocket 接口

Q: 如何让 OpenClaw 保持运行？

A: 使用 daemon 模式：

openclaw onboard --install-daemon

这会安装系统服务，OpenClaw 将在后台持续运行。

故障排除

Q: Gateway 启动失败怎么办？

A: 检查以下几点：

1. 端口是否被占用（默认 18789）
2. Node.js 版本是否正确
3. 查看 openclaw doctor 的诊断结果

Q: AI 不回复消息怎么办？

A:

1. 检查模型 API Key 是否正确
2. 检查网络连接
3. 查看 Gateway 日志是否有错误
4. 确认消息渠道配对状态

Q: 如何查看详细日志？

A: 启动 Gateway 时添加 --verbose 参数：

openclaw gateway --verbose

日志文件位于 ~/.openclaw/logs/

安全相关

Q: OpenClaw 安全吗？

A: OpenClaw 采用本地优先架构：

• 数据存储在本地
• 可完全离线运行（配合本地模型）
• 不强制上传数据到云端

Q: 如何防止未授权访问？

A:

1. 使用 DM 配对功能（默认开启）
2. 设置访问白名单
3. 启用密码认证

详见 安全指南