OpenClaw常见问题汇总
Flexus L实例提供的OpenClaw应用镜像支持对接飞书、QQ、企业微信或钉钉，更多最佳实践请参见OpenClaw最佳实践汇总。使用OpenClaw过程中的高频常见问题如下：
问题分类 | 问题链接 |
|---|---|
OpenClaw使用常见问题 | |
对话过程常见问题 |
如何查看华为云MaaS的AI模型已消耗多少Tokens？
如果您使用的是华为云MaaS的AI模型，请按照以下方式查看，如果您使用的是其他厂商的AI模型，请前往模型提供商处查看。
访问MaaS控制台，在左侧导航栏，选择“管理与统计 > 调用统计”，在服务列表下可以查看已开通模型的调用数据，包括总调用次数、总调用失败次数、总调用Tokens数、输入Tokens数、输出Tokens数、端到端时延等信息。更多详细信息请参见在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实例控制台刷新网关状态。
如果执行上述操作后，网关状态依旧为未知或者异常，请提交工单。
OpenClaw有哪些常用命令？
远程登录L实例云主机后，使用以下命令切换为OpenClaw用户，再执行其他命令。
su - openclaw
命令分类 | 命令 | |
|---|---|---|
OpenClaw状态查询 | 查看OpenClaw状态 | openclaw status |
查看所有命令帮助 | 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 |
查看所有状态为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实例登录方式请参见登录方式概述。
如何查询OpenClaw支持哪些Skills？
- 方法一：在L实例控制台，单击资源卡片进入应用管理页面，在技能配置（可选）模块，可以看到当前已安装的所有Skills。
- 方法二：在与机器人的聊天对话框中，询问机器人“你现在有哪些可用的Skills”，机器人将自动搜索并整理Skills列表并答复。
- 方法三：远程登录L实例云主机，使用以下命令行查询。
su - openclaw openclaw skills list
- Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。
- Flexus L实例登录方式请参见登录方式概述。
对话时飞书机器人不回复
问题现象：已按照指导完成配置，与飞书机器人对话，机器人不回复。
可能原因：飞书机器人缺少“cardkit:card:write”权限。
解决建议：
- 登录飞书开放平台，在应用的权限管理页面查看已开通权限中是否存在“cardkit:card:write”权限，若没有，单击“开通权限”，查找并开通“cardkit:card:write”权限。
- 返回L实例控制台，参考步骤三：配置OpenClaw应用中的通道配置，重新配置飞书应用信息。
QQ机器人回复：我的‘灵魂’不在线
问题现象：已按照指导完成配置，与QQ机器人对话，机器人回复：我的‘灵魂’不在线，请检查你的主机服务部署环境。
可能原因：
- 未配置QQ机器人的App ID和App Secret。
- QQ机器人的App ID和App Secret配置错误。
解决建议：请参考配置OpenClaw应用配置或修改QQ机器人的App ID和App Secret。
HTTP 401：invalid authorization header
问题现象：已按照指导完成配置，与机器人对话，机器人回复：HTTP 401：invalid authorization header。
可能原因：AI模型的API Key配置错误。
解决建议：请参考配置OpenClaw应用配置或修改AI模型的API Key。
HTTP 403：input text may contain sensitive information,please try again
问题现象：已按照指导完成配置，与机器人对话，机器人回复：HTTP 403：input text may contain sensitive information,please try again。
可能原因：历史对话信息中输入或输出内容可能包含敏感信息。
解决建议：请在聊天对话框中输入“/new”重新开启对话，新的输入避免包含敏感信息。
HTTP 404：not found
问题现象：已按照指导完成配置，与机器人对话，机器人回复：HTTP 404：not found。
可能原因：自定义模型的base_url填写错误。
解决建议：自定义模型目前仅支持OpenAI兼容协议的API地址，格式样例：https://api.openai.com/v1。请向模型供应商获取OpenAI兼容协议的API地址，参考OpenClaw对接自定义AI模型修改自定义模型的base_url。
