OpenClaw常见问题汇总

Flexus L实例提供的OpenClaw应用镜像支持对接飞书、QQ、企业微信或钉钉，更多最佳实践请参见OpenClaw最佳实践汇总。使用OpenClaw过程中的高频常见问题如下：

表1 OpenClaw高频常见问题汇总
问题分类	问题链接
OpenClaw使用常见问题	如何查看华为云MaaS的AI模型已消耗多少Tokens？网关状态为未知或异常时如何处理？ OpenClaw有哪些常用命令？如何查询OpenClaw支持哪些Skills？
对话过程常见问题	对话时机器人不回复对话时飞书机器人不回复在群聊中@飞书机器人时，机器人不回复 QQ机器人回复：我的‘灵魂’不在线 API rate limit reached. Please try again later. HTTP 401：invalid authorization header HTTP 403：input text may contain sensitive information,please try again HTTP 404：not found

如果您使用的是华为云MaaS的AI模型，请按照以下方式查看，如果您使用的是其他厂商的AI模型，请前往模型提供商处查看。

方式一：在L实例控制台查看

登录Flexus应用服务器L实例控制台，单击目标L实例资源卡片上的“立即配置”，进入应用详情页面。
单击目标模型右侧的“调用详情”前往华为云MaaS控制台，可以查看模型的调用数据，包括总调用次数、总调用失败次数、总调用Tokens数、输入Tokens数、输出Tokens数、端到端时延等信息。更多详细信息请参见在MaaS查看在线推理的调用数据和监控指标。

点击放大

方式二：在MaaS控制台查看

访问MaaS控制台，在左侧导航栏，选择“管理与统计 > 调用统计”，在服务列表下可以查看已开通模型的调用数据。

L实例OpenClaw镜像配置的华为云MaaS模型为“西南-贵阳一”区域的模型，请确保已切换至“西南-贵阳一”区域。

华为云MaaS的模型开通后按模型实际调用用量计费，更多计费详情请参见模型服务计费项。

点击放大

OpenClaw网关初始状态为加载中，如果等待几分钟后变更为未知或异常，请单击“重启”，重启需要一定时间，请耐心等待，重启成功后将变更为运行中。

如果重启后依旧为未知或者异常，请按照以下方法排查：

排查方法一：查询gateway状态是否正常。
远程登录L实例云主机后，使用以下命令查询gateway状态，如果有报错，请根据报错提示修改。
```
su - openclaw
openclaw gateway status
```
例如报错提示配置文件参数配置错误。

执行以下命令，修改参数后再次查询gateway状态，正常后返回L实例控制台刷新网关状态。
```
vim /home/openclaw/.openclaw/openclaw.json
```
- Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。
- Flexus L实例登录方式请参见登录方式概述。
排查方法二：检查是否已开通COC授权及权限。
查询OpenClaw网关状态依赖云运维中心（Cloud Operations Center，简称COC），需要先授权并开通COC服务。登录COC控制台，如果出现下图提示，请按界面提示授权并开通。

如果您已开通COC委托，但未开通相关权限，请在左侧导航栏中选择“资源管理 > 应用资源管理”，单击页面上方的“添加授权”，添加成功后，在L实例资源页签下单击“同步资源”。返回L实例控制台刷新网关状态。

如果执行上述操作后，网关状态依旧为未知或者异常，请提交工单。

远程登录L实例云主机后，使用以下命令切换为OpenClaw用户，再执行其他命令。

su - openclaw

表2 OpenClaw常用命令
命令分类		命令
OpenClaw状态查询	查看OpenClaw状态	openclaw status
OpenClaw状态查询	查看所有命令帮助	openclaw --help
Gateway管理	启动 Gateway（默认端口 18789）	openclaw gateway start
	停止 Gateway	openclaw gateway stop
	重启 Gateway	openclaw gateway restart
	查看Gateway运行状态	openclaw gateway status
Skills相关命令	查看所有可用Skills	openclaw skills list
Skills相关命令	查看所有状态为ready的Skills	openclaw skills list \| grep ready
插件相关命令	查看所有可用的插件	openclaw plugins list
插件相关命令	查看插件命令帮助	openclaw plugins -h
查看日志	查看实时日志	openclaw logs
查看日志	查看持续监控日志	openclaw logs --follow

Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。
Flexus L实例登录方式请参见登录方式概述。

问题现象：已按照指导完成配置，与机器人对话，机器人不回复。

可能原因：AI模型的API Key配置错误。

解决建议：参考模型配置修改AI模型的API Key。

问题现象：已按照指导完成配置，与飞书机器人对话，机器人不回复。

可能原因：飞书机器人缺少“cardkit:card:write”权限。

解决建议：

登录飞书开放平台，在应用的权限管理页面查看已开通权限中是否存在“cardkit:card:write”权限，若没有，单击“开通权限”，查找并开通“cardkit:card:write”权限。
返回L实例控制台，参考手动配置，重新配置飞书应用信息。

问题现象：已按照指导完成配置，在飞书APP中创建群组并邀请机器人入群后，@飞书机器人，机器人不回复。

可能原因：飞书APP中的机器人名称与L实例控制台中的机器人别名（即OpenClaw应用配置文件中的飞书机器人botName名称）不一致。

解决建议：

方法一：登录飞书开放平台，查看已创建应用名称，将其修改为L实例控制台中的机器人别名。
方法二：在飞书机器人聊天窗口直接对话修改，其中xxx替换为飞书APP中机器人的名称。
```
请修改配置文件 /home/openclaw/.openclaw/openclaw.json，将 botName 字段改为"xxx"。
```
修改完成后，让机器人执行以下命令，重启网关。
```
openclaw gateway restart
```
方法三：登录Flexus应用服务器L实例控制台，单击资源卡片上的“立即配置”，进入应用详情页，在已接入通道中，单击目标机器人的别名修改按钮，修改别名使其与飞书APP中机器人名称一致。修改完成后单击应用管理中的重启。

L实例控制台设置机器人别名时，长度支持3到20个字符，输入支持小写英文字母、数字、中划线，暂不支持中文字符。如果需要将机器人别名修改为包含中文字符的名称，请参考方法二操作。