常见问题

安装相关

Node.js 版本不够怎么办？

OpenClaw 需要 Node.js >= 22。推荐使用 nvm 管理版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 22
nvm use 22

Windows 可以用吗？

可以，但需要通过 WSL2（Windows Subsystem for Linux）运行：

# 安装 WSL2
wsl --install

# 在 WSL2 中安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

安装后 openclaw 命令找不到？

# 检查 npm 全局路径
npm config get prefix

# 确保路径在 PATH 中
export PATH="$(npm config get prefix)/bin:$PATH"

模型相关

哪个模型最好？

社区推荐：

• 最强 Agent 能力：Claude Opus 4.6
• 性价比：Claude Sonnet 4.6
• 免费方案：Ollama + Llama 3.1

API Key 从哪里获取？

提供商	获取地址
Anthropic	console.anthropic.com
OpenAI	platform.openai.com
Google	aistudio.google.com
OpenRouter	openrouter.ai

可以用国内的模型吗？

可以通过 OpenRouter 或自定义 API 端点使用通义千问等国内模型。也可以用 Ollama 在本地运行开源模型。

消息平台相关

Telegram Bot 收不到消息？

1. 确认 Bot Token 正确
2. 检查 openclaw channels list 状态
3. 确认已完成配对：openclaw pairing list
4. 运行 openclaw doctor 检查

WhatsApp 扫码后断线？

• 确保手机 WhatsApp 保持在线
• 检查网络连接
• 尝试重新扫码：openclaw channels login

可以同时连接多个平台吗？

可以。OpenClaw 支持同时连接多个平台，每个平台独立运行。

运行相关

如何查看日志？

# 实时日志
openclaw gateway logs

# 或查看日志文件
tail -f ~/.openclaw/logs/gateway.log

如何重启？

# 重启 Gateway
openclaw gateway restart

# 或停止后重新启动
openclaw gateway stop
openclaw gateway start

占用多少资源？

• 内存：约 200-500MB（取决于连接的平台数量）
• CPU：空闲时几乎为 0，处理消息时短暂占用
• 磁盘：基础安装约 200MB，数据随使用增长