常见问题FAQ

模型(Model)问题
配置模型提示错误
403 This model is not available in your region.

或者

提示fetch failed

魔法问题,打开魔法Tun模式

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

在小龙虾 OpenClaw模型页面添加提供商,配置对应模型API key

在卸载重装后,模型提供商页面有显示配置好的模型仍提示上述报错,删除重新配置模型即可

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

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

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

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

你本身是支持图片识别的,帮我修改配置,能够支持图片上传和识别
技能(Skill)问题
技能市场里下载失败超时,提示繁忙

目前clawhub 存在限流,建议直接到clawhub官方https://clawhub.ai/ 下载。

下载的 skills zip 文件解压后移动到本地 .openclaw-ai下的 skills 目录 (注意:请确认下载的skill被移动到该目录,否则小龙虾 OpenClaw可能无法识别)

Windows用户路径为 C:\Users\{你的用户名}\.openclaw-ai\skills

Mac用户路径为 ~/.openclaw-ai/skills


Agents 问题
Agent 和连接器的关系是什么?

简单总结:一个连接器(如小龙虾 OpenClaw)可以创建多个机器人,一个机器人只能对应一个 Agent

详细:

Agent 是处理消息的“执行者”,连接器是“消息来源”(如 Feishu/Lark、DingTalk 等)。

实际绑定单位是“连接器账号(Account) -> Agent”。

一个连接器账号(机器人)同一时间只能绑定一个 Agent(互斥)。注意:一定不要将同一个连接器账号,例如小龙虾 OpenClaw机器人绑定到多个Agent!!!

一个 Agent 可以绑定多个不同连接器。

对同一连接器类型,一个 Agent 同一时间只保留一个账号绑定(互斥):如果把该 Agent 绑定到该连接器的另一个账号,会替换原绑定。

怎么配置 Agent 和连接器?

先到 Agents 页面创建/确认 Agent。

到 Linker 页面配置连接器(可新增多个账号)。

在“已配置连接器”的账号卡片里,用“绑定 Agent:”下拉框选择目标 主智能体。

保存后该账号收到的消息会由所选 主智能体 处理。

补充:

解绑时可在下拉框选“未绑定”。

主智能体(默认)通常用于兜底和默认处理。

连接器(Linker)问题
插件安装失败,小龙虾 OpenClaw插件导致网关启动失败,小龙虾 OpenClaw连接失败

检查本地 .openclaw-ai下extensions目录是否有feishu-openclaw-plugin文件夹

Windows用户路径为 C:\Users\{你的用户名}\.openclaw-ai\extensions

Mac用户路径为~/.openclaw-ai/extensions

1. 如果有第一步的feishu-openclaw-plugin,建议先删除

2. 检查本地 .openclaw-ai下的openclaw.json文件内容,检查其中的内容,找到如下配置plugins.allow配置,如果有feishu,需要将feishu去掉, 只保留小龙虾 OpenClaw插件的官方plugin ID openclaw-lark

Windows用户路径为 C:\Users\{你的用户名}\.openclaw-ai

Mac用户路径为 ~/.openclaw-ai

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

3. 重启小龙虾 OpenClaw,在连接器页重新添加小龙虾 OpenClaw连接器

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

1. 检查本地 .openclaw-ai目录下的extensions子目录是否有wecom文件夹

windows用户路径为 C:\Users\{你的用户名}\.openclaw-ai\extensions

Mac用户路径为 ~/.openclaw-ai/extensions

2. 如果有第一步的wecom, 建议先删除

3. 检查本地 .openclaw-ai下的openclaw.json文件内容,检查其中的内容,找到如下配置plugins.allow配置,如果有wecom-opendlaw-plugin ,需要将wecom-opendlaw-plugin 去掉, 只保留企业微信插件的官方plugin ID wecom

Windows用户路径为 C:\Users\{你的用户名}\.openclaw-ai

Mac用户路径为 ~/.openclaw-ai

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

4. 重启小龙虾 OpenClaw,在连接器页重新添加企业微信连接器

命令行(Terminal)问题
可以在小龙虾 OpenClaw中使用OpenClaw原生命令吗

可以,小龙虾 OpenClaw会将openclaw 原生命令注入到环境变量中

OpenClaw版本可以在小龙虾 OpenClaw中更新吗

不可以,因为openclaw目前不稳定,直接在小龙虾 OpenClaw中升级会导致各种兼容性问题,小龙虾 OpenClaw会紧更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-ai 目录下 skillsworkspaceopenclaw.json文件

Mac用户 ~/.openclaw-ai目录下 skillsworkspaceopenclaw.json文件

正式版本下载链接: http://cipgpt.com

自动更新失败怎么办

http://cipgpt.com 手动下载最新版

安装完小龙虾 OpenClaw软件打不开怎么办

检查一下安装路径是否有中文,如有中文卸载重装

定时任务(Cron)问题
无法发定时任务到小龙虾 OpenClaw

1. 在小龙虾 OpenClaw上手动创建的定时任务只支持发送到小龙虾 OpenClaw中的聊天会话中

2. 如果需要在小龙虾 OpenClaw中设置定时任务,可以私聊创建的小龙虾 OpenClaw机器人,要求其创建openclaw定时任务(注意:由于模型幻觉等问题,此步骤可能失败,如果失败可在聊天中继续引导)