常见访问题解决

安装访问题

Q1: Node.js版本不对

# 检查版本
node --version

# 如果低于22，升级
nvm install 22
nvm use 22

Q2: 权限错误

# macOS/Linux
sudo chown -R $USER ~/.openclaw

# Windows
# 以管理员身份运行PowerShell

Q3: 网络连接失败

• 检查网络连接
• 尝试使用代理
• 或使用云端部署

API配置访问题

Q1: API Key无效

• 检查是否完整复制（包括sk-前缀）
• 检查是否有多余空格
• 检查账户余额是否充足

Q2: 模型不可用

• 检查模型ID是否正确
• 检查API服务是否正常
• 尝试切换其他模型

Q3: Token消耗太快

• 使用更便宜的模型（DeepSeek）
• 优化提示词
• 定期清理会话历史

Gateway访问题

Q1: Gateway无法启动

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

# 重启Gateway
openclaw gateway restart

Q2: 端口被占用

# 查看端口占用
lsof -i :18789

# 修改端口
openclaw config set gateway.port 18790