常见问题 FAQ

配置模型提示错误

报错示例：

403 This model is not available in your region.

或者提示 fetch failed。

• 魔法问题，打开魔法 Tun 模式。

提示 “Agent failed before reply: No API key found for provider”

• 在 Mindway claw 模型页面添加提供商，配置对应模型 API key。
• 在卸载重装后，如果模型提供商页面显示已配置好的模型但仍提示上述报错，删除后重新配置模型即可。

如何在预设模型提供商里修改模型

• 目前 openrouter 支持在添加 provider 时填入模型 ID。
• 其他提供商切换模型可在聊天框中与 AI 对话切换，也支持使用 openclaw /model 命令修改。

当自定义配置了可以识别图像的模型，如何生效

直接通过对话的方式让其修改。

示例提示词：

你本身是支持图片识别的，帮我修改配置，能够支持图片上传和识别。

技能市场里下载失败超时，提示繁忙

• 目前 clawhub 存在限流，建议直接到 clawhub 官方 https://clawhub.ai/ 下载。
• 下载的 skills zip 文件解压后，移动到本地 .openclaw 下的 skills 目录。
• 注意：请确认下载的 skill 被移动到该目录，否则 Mindway claw 可能无法识别。
• Windows 用户路径为 C:\Users\{你的用户名}\.openclaw\skills
• Mac 用户路径为 ~/.openclaw/skills

Agent 和频道的关系是什么？

简单总结：一个频道（如飞书）可以创建多个机器人，一个机器人只能对应一个 Agent。

详细说明：

• Agent 是处理消息的“执行者”，频道是“消息来源”（如 Feishu/Lark、DingTalk 等）。
• 实际绑定单位是“频道账号（Account） -> Agent”。
• 一个频道账号（机器人）同一时间只能绑定一个 Agent（互斥）。注意：一定不要将同一个频道账号，例如飞书机器人绑定到多个 Agent。
• 一个 Agent 可以绑定多个不同频道。
• 对同一频道类型，一个 Agent 同一时间只保留一个账号绑定（互斥）：如果把该 Agent 绑定到该频道的另一个账号，会替换原绑定。

怎么配置 Agent 和频道？

1. 先到 Agents 页面创建或确认 Agent。
2. 到 Channels 页面配置频道，可新增多个账号。
3. 在“已配置频道”的账号卡片里，用“绑定 Agent:”下拉框选择目标 Agent。
4. 保存后，该账号收到的消息会由所选 Agent 处理。

补充：

• 解绑时可在下拉框选择“未绑定”。
• 主 Agent（默认）通常用于兜底和默认处理。

飞书插件安装失败，飞书插件导致网关启动失败，飞书连接失败

1. 检查本地 .openclaw 下 extensions 目录是否有 feishu-openclaw-plugin 文件夹。
2. Windows 用户路径为 C:\Users\{你的用户名}\.openclaw\extensions
3. Mac 用户路径为 ~/.openclaw/extensions
4. 如果有第一步的 feishu-openclaw-plugin，建议先删除。
5. 检查本地 .openclaw 下的 openclaw.json 文件内容，找到 plugins.allow 配置。如果有 feishu，需要将 feishu 去掉，只保留飞书插件的官方 plugin ID openclaw-lark。
6. Windows 用户路径为 C:\Users\{你的用户名}\.openclaw
7. Mac 用户路径为 ~/.openclaw

"plugins": {
    "allow": [
      "discord",
      "openclaw-lark",
      "feishu"
    ]
   ...

8. 重启 Mindway claw，在频道页重新添加飞书频道。

企业微信插件安装失败，企业微信相关报错

1. 检查本地 .openclaw 目录下的 extensions 子目录是否有 wecom 文件夹。
2. Windows 用户路径为 C:\Users\{你的用户名}\.openclaw\extensions
3. Mac 用户路径为 ~/.openclaw/extensions
4. 如果有第一步的 wecom，建议先删除。
5. 检查本地 .openclaw 下的 openclaw.json 文件内容，找到 plugins.allow 配置。如果有 wecom-opendlaw-plugin，需要将 wecom-opendlaw-plugin 去掉，只保留企业微信插件的官方 plugin ID wecom。
6. Windows 用户路径为 C:\Users\{你的用户名}\.openclaw
7. Mac 用户路径为 ~/.openclaw

"plugins": {
    "allow": [
      "discord",
      "wecom-opendlaw-plugin",
      "wecom"
    ]
   ...

8. 重启 Mindway claw，在频道页重新添加企业微信频道。

可以在 Mindway claw 中使用 OpenClaw 原生命令吗

可以，Mindway claw 会将 openclaw 原生命令注入到环境变量中。

OpenClaw 版本可以在 Mindway claw 中更新吗

不可以，因为 openclaw 目前不稳定，直接在 Mindway claw 中升级会导致各种兼容性问题，Mindway claw 会紧跟 openclaw 最新版本。

(macOS) openclaw: command not found

export PATH=$HOME/.local/bin:$PATH

• 添加至 ~/.bashrc 或 ~/.zshrc
• 或者使用 ~/.local/bin/openclaw

Alpha、Beta 和正式版有区别吗

• Alpha、Beta 是测试版本，Bug 比较多，修完测试完之后才发正式版，不建议下载。
• 如想体验，记得备份配置文件。
• Windows 用户备份 C:\Users\.\.openclaw 目录下 skills、workspace、openclaw.json 文件。
• Mac 用户备份 ~/.openclaw 目录下 skills、workspace、openclaw.json 文件。
• 正式版本下载链接：https://www.mindway.chat/mindway-claw.html

自动更新失败怎么办

到 https://www.mindway.chat/mindway-claw.html 手动下载最新版。

安装完 Mindway claw 软件打不开怎么办

检查一下安装路径是否有中文，如有中文请卸载后重新安装。

无法发定时任务到飞书

1. 在 Mindway claw 上手动创建的定时任务，只支持发送到 Mindway claw 中的聊天会话中。
2. 如果需要在飞书中设置定时任务，可以私聊创建的飞书机器人，要求其创建 openclaw 定时任务。