# OpenClaw常见问题汇总 Flexus L实例提供的OpenClaw应用镜像支持对接飞书、QQ、企业微信、微信或钉钉，更多最佳实践请参见[Flexus L实例最佳实践汇总](https://support.huaweicloud.com/bestpractice-flexusl/bp_overview.html)。使用OpenClaw过程中的高频常见问题如下： 表1OpenClaw高频常见问题汇总 | 问题分类 | 问题链接 | |:---|:---| | OpenClaw使用常见问题 | - [如何查看华为云MaaS的AI模型已消耗多少Tokens？] - [如何查看华为云MaaS Token Plan套餐的用量？] - [网关状态为未知或异常时如何处理？] - [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模型已消耗多少Tokens？ 如果您使用的是华为云MaaS的AI模型，请按照以下方式查看，如果您使用的是其他厂商的AI模型，请前往模型提供商处查看。 **方式一：在L实例控制台查看** 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)，单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 2. 单击目标模型右侧的"调用详情"前往华为云MaaS控制台，可以查看模型的调用数据，包括总调用次数、总调用失败次数、总调用Tokens数、输入Tokens数、输出Tokens数、端到端时延等信息。更多详细信息请参见[在MaaS查看在线推理的调用数据和监控指标](https://support.huaweicloud.com/call-statistics-maas/maas-modelarts-0074.html)。 **方式二：在MaaS控制台查看** 访问[MaaS控制台](https://console.huaweicloud.com/modelarts/?region=cn-southwest-2#/model-studio/statistics)，在左侧导航栏，选择"管理与统计 \> 调用统计"，在服务列表下可以查看已开通模型的调用数据。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) L实例OpenClaw镜像配置的华为云MaaS模型为"**西南-贵阳一** "区域的模型，请确保已切换至"**西南-贵阳一** "区域。 华为云MaaS的模型开通后按模型实际调用用量计费，更多计费详情请参见[模型服务计费项](https://support.huaweicloud.com/price-maas/price-maas-0001.html)。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002531905902.png "点击放大") #### 如何查看华为云MaaS Token Plan套餐的用量？ 您可以在[MaaS控制台](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)的"管理与统计 \> 订阅管理"页面，查看套餐的用量统计数据和剩余额度。更多详情请参见[Token Plan个人版套餐概览](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html)。 #### 网关状态为未知或异常时如何处理？ OpenClaw网关初始状态为加载中，如果等待几分钟后变更为未知或异常，请单击"重启"，重启需要一定时间，请耐心等待，重启成功后将变更为运行中。 如果重启后依旧为未知或者异常，请按照以下方法排查： - **排查方法一** ：查询gateway状态是否正常。 远程登录L实例云主机后，使用以下命令查询gateway状态，如果有报错，请根据报错提示修改。 ``` su - openclaw openclaw gateway status ``` 例如报错提示配置文件参数配置错误。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002531745960.png "点击放大") 执行以下命令，修改参数后再次查询gateway状态，正常后返回L实例控制台刷新网关状态。 ``` vim /home/openclaw/.openclaw/openclaw.json ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002562825831.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - Flexus L实例无初始密码，创建Flexus L实例后，**如需登录云主机，请先设置Flexus L实例的密码。** 更多详情请参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。 - Flexus L实例登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。 - **排查方法二** ：检查是否已开通COC授权及权限。 查询OpenClaw网关状态依赖云运维中心（Cloud Operations Center，简称COC），需要**先授权并开通COC服务** 。登录[COC控制台](https://console.huaweicloud.com/coc?locale=zh-cn)，如果出现下图提示，请按界面提示授权并开通。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002562665865.png "点击放大") 如果您已开通COC委托，但未开通相关权限，请在左侧导航栏中选择"资源管理 \> 应用资源管理"，单击页面上方的"添加授权"，添加成功后，在L实例资源页签下单击"同步资源"。返回L实例控制台刷新网关状态。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002531912278.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) 如果执行上述操作后，网关状态依旧为未知或者异常，请[提交工单](https://console.huaweicloud.com/ticket/?&locale=zh-cn#/ticketindex/createIndex)。 #### OpenClaw有哪些常用命令？ 远程登录L实例云主机后，使用以下命令**切换为OpenClaw用户**，再执行其他命令。 ``` su - openclaw ``` 表2OpenClaw常用命令 | 命令分类 || 命令 | |:---|---|:---| | OpenClaw状态查询 | 查看OpenClaw状态 | ``` openclaw status ``` | | OpenClaw状态查询 | 查看所有命令帮助 | ``` openclaw --help ``` | | Gateway管理 | 启动 Gateway（默认端口 18789） | ``` openclaw gateway start ``` | | Gateway管理 | 停止 Gateway | ``` openclaw gateway stop ``` | | Gateway管理 | 重启 Gateway | ``` openclaw gateway restart ``` | | Gateway管理 | 查看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 ``` | ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - Flexus L实例无初始密码，创建Flexus L实例后，**如需登录云主机，请先设置Flexus L实例的密码。** 更多详情请参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。 - Flexus L实例登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。 #### 如何查询OpenClaw支持哪些Skills？ - 方法一：在L实例控制台，单击资源卡片进入应用详情页面，在技能配置（可选）模块，可以看到当前已安装的所有Skills。 - 方法二：在与机器人的聊天对话框中，询问机器人"你现在有哪些可用的Skills"，机器人将自动搜索并整理Skills列表并答复。 - 方法三：远程登录L实例云主机，使用以下命令行查询。 ``` su - openclaw openclaw skills list ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - Flexus L实例无初始密码，创建Flexus L实例后，**如需登录云主机，请先设置Flexus L实例的密码。** 更多详情请参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。 - Flexus L实例登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。 #### 在线安装技能后无法正常使用？ **问题现象**：已部署OpenClaw，在应用详情页在线安装技能后，与机器人对话时无法正常使用该技能。 **可能原因**：部分技能（例如Playwright MCP）使用时需要依赖其他组件，但技能安装时不会自动安装技能所需要的依赖，需要用户自行安装。 **解决建议** ：前往[ClawHub社区Skills](https://clawhub.ai/skills?sort=downloads)查询技能说明，如果该技能有依赖请先安装依赖后再使用技能。例如技能[Playwright MCP](https://clawhub.ai/spiceman161/skills/playwright-mcp)，在skill.md中说明，首次使用前需要先安装chromium，您可以将命令行发送到机器人对话框，让机器人执行安装，或者远程登录到L实例云主机中，手动执行该命令。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002633997506.png "点击放大") #### 对话时机器人不回复 **问题现象**：已按照指导完成配置，与机器人对话，机器人不回复。 **可能原因**：AI模型的API Key配置错误。 **解决建议** ：参考[模型配置](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html#section2)修改AI模型的API Key。 #### 对话时飞书机器人不回复 **问题现象**：已按照指导完成配置，与飞书机器人对话，机器人不回复。 **可能原因**：飞书机器人缺少"cardkit:card:write"权限。 **解决建议**： 1. 登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，在应用的权限管理页面查看已开通权限中是否存在"cardkit:card:write"权限，若没有，单击"开通权限"，查找并开通"cardkit:card:write"权限。 2. 返回L实例控制台，参考[通道配置](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0002.html#section4)，重新配置飞书应用信息。 #### 在群聊中@飞书机器人时，机器人不回复 **问题现象**：已按照指导完成配置，在飞书APP中创建群组并邀请机器人入群后，@飞书机器人，机器人不回复。 **可能原因**：飞书APP中的机器人名称与L实例控制台中的机器人别名（即OpenClaw应用配置文件中的飞书机器人botName名称）不一致。 **解决建议**： - 方法一：登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，查看已创建应用名称，将其**修改为L实例控制台中的机器人别名** 。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002619182831.png "点击放大") - 方法二：在飞书机器人聊天窗口直接对话修改，其中xxx**替换为飞书APP中机器人的名称** 。 ``` 请修改配置文件 /home/openclaw/.openclaw/openclaw.json，将 botName 字段改为"xxx"。 ``` 修改完成后，让机器人执行以下命令，重启网关。 ``` openclaw gateway restart ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002588625546.png "点击放大") - 方法三：登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)，单击资源卡片上的"立即配置"，进入应用详情页，在已接入通道中，单击目标机器人的别名修改按钮，**修改别名使其与飞书APP中机器人名称一致** 。修改完成后单击应用管理中的**重启** 。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002619190119.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) L实例控制台设置机器人别名时，长度支持3到20个字符，输入支持小写英文字母、数字、中划线，暂不支持中文字符。如果需要将机器人别名修改为包含中文字符的名称，请参考方法二操作。 #### QQ机器人回复：我的'灵魂'不在线 **问题现象**：已按照指导完成配置，与QQ机器人对话，机器人回复：我的'灵魂'不在线，请检查你的主机服务部署环境。 **可能原因**： - 未配置QQ机器人的App ID和App Secret。 - QQ机器人的App ID和App Secret配置错误。 **解决建议** ：请参考[通道配置](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0003.html#section3)完成配置或修改QQ机器人的App ID和App Secret。 #### API rate limit reached. Please try again later. **问题现象**：已按照指导完成配置，与机器人对话，机器人回复：API rate limit reached. Please try again later。 **可能原因** ：AI模型限流，当模型调用次数达到规定额度后，模型将被限制调用。华为云MaaS的模型限流信息请在[MaaS控制台](https://console.huaweicloud.com/modelarts/?region=cn-southwest-2#/model-studio/deployment)对应模型的**模型限流**列查看。自定义模型的限流信息请以模型提供商处信息为准。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002619481769.png "点击放大") **解决建议**： - 如果您希望继续使用当前模型，请按照模型限流次数进行调用，或者[提交工单](https://console.huaweicloud.com/ticket/?&locale=zh-cn#/ticketindex/createIndex)申请扩大当前模型的限流额度。 - 如果您需要高频调用模型，请参考[模型配置](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html#section2)添加其他的AI模型，或者切换默认模型为其他模型。 #### HTTP 401：invalid authorization header **问题现象**：已按照指导完成配置，与机器人对话，机器人回复：HTTP 401：invalid authorization header。 **可能原因**：AI模型的API Key配置错误。 **解决建议** ：请参考[模型配置](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html#section2)配置或修改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、Anthropic兼容协议的API地址，格式样例：https://api.openai.com/v1。请向模型供应商获取API地址，参考[OpenClaw对接自定义AI模型](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0006.html)修改自定义模型的base_url。