OpenClaw 常见问题手册：新手高频 12 问

1) 安装后提示 openclaw: command not found

npm i -g openclaw@latest
openclaw --version

如果仍失败，重开终端再试。

2) openclaw status 不是 running 怎么办

按顺序执行：

openclaw gateway restart
openclaw status
openclaw health

如果仍失败，先修复服务状态再继续配置机器人。

3) API 401 常见原因是什么

1. API Key 复制不完整
2. 误用云账号 AccessKey
3. 账号没有该模型权限

4) API 429 是什么问题

通常是限流或额度不足。临时处理：

• 降低请求并发
• 缩短上下文
• 切换备用模型

5) 机器人不回复，先看哪三项

1. Gateway 是否 running
2. Bot Token 是否正确
3. allowlist 是否包含你的用户 ID

6) Telegram 用户 ID 去哪里查

在 Telegram 搜索 @userinfobot，点击 Start，读取返回中的 id 数字。

7) 改了配置为什么没生效

改完配置必须重启：

openclaw gateway restart

8) 哪些命令适合做日常巡检

openclaw status
openclaw health

每天至少检查 2 次（上班后、下班前）。

9) 生产环境最小监控该做什么

至少监控：

1. 可用率
2. 错误率
3. 响应延迟

并配置值班群告警。

10) 升级前如何避免翻车

1. 备份当前配置
2. 先在测试环境升级
3. 回归测试 3 条核心消息
4. 再升级生产

11) 回滚怎么做最稳妥

1. 切回上一个稳定配置
2. 重启服务
3. 复测机器人消息
4. 记录事故和根因

12) 新手应该按什么顺序学习

1. 快速开始
2. 安装总览
3. 机器人通道配置
4. 生产上线清单

13) 我还要看哪几篇

• Token 权限错误排查
• 故障排查速查表
• 运维告警指南