AI 入门通识 · 第 2 章
AI 使用常见问题速查清单
把初学阶段最常遇到的问题按现象归类，一条条给出可执行的处理做法，遇到问题先查这份清单。
AI 使用常见问题速查清单
Q&A 问题速查清单
整体排查问题思路：
Q1：飞书如何发送本地文件
A1：给你的龙虾发送以下消息：
🥖
不要用通用 message/media 发文件，直接走 Feishu 真文件链路。成功步骤
- 从 你的
openclaw.json里读取当前 Feishu 账号的appId/appSecret - 用 Feishu SDK 建立
Client - 调
im.file.create上传本地文件 - 从返回里拿
file_key - 再调
im.message.create - 参数里明确用
msg_type: "file" content传{"file_key":"..."}
关键点
- 必须是当前会话绑定账号，不能误用别的 account
- 目标消息必须是
msg_type=file - 只看到
messageId不算，飞书界面里要显示成真正的文件消息 - 文件大小要在飞书这条上传链路可接受范围内，太大就提醒用户，最高30兆。
A1:图文教程：
Q2：怎么完全卸载Openclaw？
A2：在以管理员身份运行的PowerShell里执行：
第一步——卸载服务和数据：
openclaw uninstall --all --yes
第二步——删除 npm 包本体：
npm uninstall -g openclaw
第三步——清理残留目录（PowerShell 管理员身份运行）：
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot
只跑 npm uninstall 会把命令删掉，但后台服务还在，重启后可能还会自动拉起。
高频问题及解决方案合集：
1.API rate limit reached. Please try again later.或已达到 API 速率限制。请稍后再试，这是什么情况，怎么解决？
问题描述
API rate limit reached. Please try again later. 或已达到 API 速率限制。请稍后再试。
相似问题
频繁出现 API rate limit reached，是因为购买的 Coding Plan Lite 总体算力紧缺还是个人频率超限？
解决方案
您订阅的套餐达到了限额，5 小时后可再次交互。如您订阅其他厂商的套餐，那就哪里订阅的，去哪里看
火山引擎codeplan查看配额及刷新时间：👉 方舟控制台 - 开通管理
解决办法：升级到更高级别套餐或者更换其它大模型API提供商
回答者：
2.我购买的 ArkClaw 套餐到期如何续费以及如何升级?
升级/续费地址💡 升级后立即生效
- 🌐 方舟 Coding Plan 活动页
- 🔧 方舟控制台 - 开通管理
回答者：
3.如何安装火山龙虾ArkClaw，有没有视频版本手把手教学？
视频版教程:📹 手把手视频教学 文档宝典版:📖 立省 500！30 分钟把 OpenClaw 在飞书上配到可用
回答者：
4.从 OpenClaw 2026.3.2 的内置社区版插件升级到最新的官方飞书插件，是否可以直接安装覆盖？会不会有冲突？
问题描述：
从 OpenClaw 2026.3.2 的内置社区版插件升级到最新的官方飞书插件，是否可以直接安装覆盖？会不会有冲突？
解决方案：✅ 可以直接安装覆盖，不会有冲突，新插件会自动禁用原来的内置插件。
注意事项:
- 若提示 OpenClaw 版本不匹配，需确认版本是否符合要求，或回滚到兼容版本
- 若飞书插件加载失败，可能是缺少依赖，需安装依赖并重新启动服务
由整理
5.已经把应用身份和用户身份关于云文档、多维表格的权限（如 drive:drive:readonly， docs:document:readonly）全部打开，为何机器人仍提示无权限或返回 400/404 报错？
问题描述:
已经把应用身份和用户身份关于云文档、多维表格的权限（如
drive:drive:readonly,docs:document:readonly）全部打开，为何机器人仍提示无权限或返回 400/404 报错？
**解决方案:**更新飞书插件，旧版飞书插件对文档的操作有 bug。
回答者：
6.触发 /feishu auth 后，授权卡片弹不出来，或者点击后提示过期，只能在 Web UI 端点击 allow，如何解决？
问题描述:
触发
/feishu auth后，授权卡片弹不出来，或者点击后提示过期，只能在 Web UI 端点击 allow，如何解决？
方法一：检查授权状态与流程
在飞书对话里输入：
plain
复制
/feishu doctor
检查授权状态，若提示「用户身份权限检查未通过，暂无用户授权」：
- 首次以用户身份使用功能时会自动触发授权流程
- 避免无穷无尽的授权申请套娃情况
- 尝试在非与 OpenClaw 对话的情境下使用
/feishu auth进行授权 - 在没有唤起任何 agent 的情况下操作，同时重启网关
方法二：确认权限开通情况
检查飞书开放平台中应用的用户身份权限是否全部开通：
- 登录 飞书开放平台开发者后台
- 进入「权限管理」→「开通权限」→「用户身份权限」
- 开通所有需要的权限
方法三：排查网络与环境问题
- 确保网络连接稳定
- 若使用云服务器部署，检查防火墙设置
- 确保相关端口（如 Web UI 面板访问端口）已开放
方法四：更新插件与重启服务
bash
复制
# 更新飞书插件
feishu-plugin-onboard update
# 或更新 OpenClaw 到最新版本# 重启服务
openclaw gateway restart
方法五：检查配置文件
若 openclaw.json 报错存在无法识别的键值（如 Unrecognized key: "feishu"）：
bash
复制
# 自动修复
openclaw doctor --fix
若自动修复不成功，建议：
- 使用 Claude Code 辅助修复
- 手动打开配置文件，搜索相关关键词并删除对应行
本答案来源于多个社群，由整理
7.飞书个人版用户如何将配置好的 ArkClaw 拉入外部群聊？为何在群成员添加里搜不到机器人？
问题描述:
飞书个人版用户如何将配置好的 ArkClaw 拉入外部群聊？为何在群成员添加里搜不到机器人？
**添加机器人方法：**机器人不是普通群成员，添加方式：
- 进入群聊设置
- 选择「机器人」选项
- 添加机器人
企业认证指南：👉 飞书认证介绍
回答者：
8.机器人可以正常创建飞书云文档和多维表格，但是为何无法往里面写入内容（如报错 Unexpected non-whitespace character after JSON）？
回答者：
问题描述：
机器人可以正常创建飞书云文档和多维表格，但是为何无法往里面写入内容（如报错
Unexpected non-whitespace character after JSON）？
参考答案 1：
原因是模型调用内容写入接口的时候，传递的参数有误。应该是模型没有正确理解飞书插件里面，对如何写入文档内容的说明。
解决方案
- 文字下达指令，让他重新尝试写入。
- 换用更好的模型。
参考答案 2：
问题：机器人缺少文档写入所需的权限（如 docx:document.block：convert）。
解决：登录飞书开放平台，进入应用管理 → 权限管理，添加 docx:document、drive:drive、docx:document.block：convert 等权限并提交审核。最好是根据教程里那个批量导入，避免自己遗漏
9.事件配置时一直提示“未检测到应用连接信息，请确保长连接建立成功后再保存配置”，无法保存长连接模式怎么处理？
参考答案 1：
需要先把龙虾启动起来，关联上飞书的应用信息，再进行保存
检查网关常用命令：
OpenClaw gateway status 查看 gateway 状态
OpenClaw logs --follow 查看网关日志，遇到报错的话，可以把网关日志里面标红的部分发出来，方便排查。
回答者：
参考答案 2：arkClaw 内置了最新的飞书插件，只需要完成消息渠道配置即可成功配置长链接，如果在这一步卡住，大概率是消息渠道配置有问题，建议返回消息渠道配置，检查确认已经配置成功后再回到飞书后台配置长链接。
- 使用飞书消息渠道进行配置，耐心等待配置流程完成。当系统返回 "飞书消息渠道配置成功" 提示后，即代表配置成功。
10.在飞书群聊中，如何让机器人的回复在一个消息中流式追加，而不是分成多条消息发送？
参考答案 1：
- 流式追加能力需要等待后续插件能力更新
- 如果想增长一条消息里回复的文字的话，更改这个“channels.feishu.textChunkLimit”配置项，默认是 2000 可以增达到 3000。
回答者：
参考答案 2：
直接在聊天框里复制下方代码发送：
将飞书消息设置为流式输出：OpenClaw config set channels.feishu.streaming true
开启耗时
OpenClaw config set channels.feishu.footer.elapsed true // 开启耗时
开启状态展示
OpenClaw config set channels.feishu.footer.status true // 开启状态展示
11.群聊中因为自动拉取历史消息过多，导致单条消息报 400 Total tokens of image and text exceed max message tokens，如何解决？
问题描述：
群聊中因为自动拉取历史消息过多，导致单条消息报
400 Total tokens of image and text exceed max message tokens，如何解决？
**原因分析:**当请求中包含图片时，文本和图片编码后的总 token 数超过了模型上下文长度限制。
解决方案:
- 尝试重启网关
- 新开对话方式解决【输入/new】
回答者：
解决方案参考:
这个报错是因为会话超出了模型支持的最大上下文长度，可通过以下步骤进行排查：
- 输入
/status查看状态，可看到上下文占用情况
- 输入
/compact压缩会话上下文 - 若无法压缩，可输入
/new新建会话，开启一个全新的会话（清空上下文） - 若输入
/new新建会话仍报错，则可以输入/context detail查看上下文明细，有时候可能会因为 skills 内容较多等情况导致直接占满上下文。
12.在控制台切换为 Kimi-k2-thinking 或 Doubao 模型后，OpenClaw 仍显示 ark-code-latest 甚至报 404 UnsupportedModel，如何正确切换？
完成修改后执行OpenClaw gateway restart重启服务，使新配置生效
回答者：
13.配置 API Key 后一直报错 401 The API key format is incorrect 或 No API key found for provider "anthropic"，如何重新绑定？
方案 1：通过命令行重新配置
- 打开龙虾的终端
- 执行命令重新配置火山方舟 API Key：
OpenClaw config set models.providers.ark.apiKey "你的新 API Key"
- 重启 OpenClaw 服务使配置生效：
OpenClaw gateway restart
方案 2：通过 Web UI 重新配置
- 执行
OpenClaw dashboard打开 Web UI - 左侧菜单栏选择 Settings - Config - Authentication，选择 Raw 模式查看配置
- 找到
models.providers.ark.apiKey字段，替换为正确的 API Key - 保存配置后点击 Update，重启服务生效
14.购买了火山引擎 Coding Plan，到底是按天计算、按次数计算，还是按 Token 消耗计算？
答：不是按天、也不是按 Token 消耗计费，而是按订阅周期+请求次数来进行计费的。
回答者：
参考文档：套餐概览
15.启动时提示网关服务启动失败，RPC 连接被拒绝（unauthorized 或 ECONNREFUSED），如何排查？
- 检查网关服务基础状态
执行systemctl status clawdbot-gateway确认服务是否为active。如果显示inactive或failed，运行sudo systemctl start clawdbot-gateway启动服务，再通过journalctl -u clawdbot-gateway -n 50查看日志，定位启动失败原因（如端口冲突、配置错误）。 - 验证端口是否被占用
OpenClaw 默认使用 8080 端口，通过lsof -i :8080（Linux/macOS 系统）或netstat -ano | findstr :8080（Windows 系统）检查端口占用情况。如果端口被占用，终止占用进程（kill -9 [PID]）后重启网关即可。 - 检查网络与 RPC 配置
- 测试服务器基础连通性：
ping <目标IP>测试网络，telnet <目标IP>验证端口开放； - 检查 RPC 基础服务：执行
systemctl status rpcbind确认服务运行，异常时可执行systemctl restart rpcbind重启； - 核对配置文件中 RPC 地址、端口信息，修正拼写错误。
- 处理认证权限问题（针对
unauthorized报错）
- 确认防火墙/云服务器安全组已允许 RPC 相关端口（如 111、8080）的入站、出站流量；
- 核对客户端和服务端的认证凭证（API Key、Token），修正不匹配的配置后重启服务。
- 快速修复工具
可以执行以下命令快速诊断修复：
- 重启网关：
OpenClaw gateway restart - 自动诊断配置错误：
OpenClaw doctor - 查看实时日志定位问题：
OpenClaw logs --follow
16.Windows 本地部署使用 npm 安装时报 ENOENT syscall spawn git 错误，Mac 部署报 EACCES: permission denied 权限不足，如何修复？
参考答案 1：
权限不足，Windows 系统使用管理员权限启动 powershell， macOS 系统前面加 sudo
回答者：
参考答案 2：
- Windows 环境
ENOENT syscall spawn git报错修复
该报错通常是系统缺少 Git 环境或 Git 未配置环境变量导致，按以下步骤操作即可解决：
- 从 Git 官网下载安装 Git for Windows，安装时请勾选「添加到系统 PATH」选项；
- 安装完成后重启终端工具，执行
git --version验证 Git 环境可用； - 重新执行 npm 安装命令即可。
- Mac 环境
EACCES: permission denied权限报错修复
该报错是 npm 全局安装路径权限不足导致，推荐使用安全的用户级权限调整方案，执行以下命令即可完成修复：
mkdir -p /.npm-global && npm config set prefix '/.npm-global' && echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
配置完成后重新执行安装命令即可，您也可以选择添加sudo前缀执行安装命令，或是使用 nvm 管理 Node.js 版本从根源避免权限问题。
额外提示：您可以同时检查 Node.js 版本是否符合 OpenClaw 要求，建议使用 Node.js 18 及以上版本
整理者：
17.OpenClaw.json 报错存在无法识别的键值（如 Unrecognized key: "feishu"），如何使用 OpenClaw doctor --fix 进行修复？
OpenClaw doctor --fix 这个指令就是用来进行自动修复，如果不成功的话，建议使用 claude code 辅助修复，或者自己打开配置文件，搜索 feishu 这个词，找到对应这一行，然后把它删了
18.在火山引擎 ECS 云服务器部署后，无法打开 Web UI 面板（Dashboard），是否需要配置旁路由或防火墙端口透传？
龙虾的网关默认监听本地地址，如果你想外部访问的话，首先需要开启防火墙端口，然后配置本地代理转发。
19.在终端执行配对命令后，飞书端没有弹出确认框，导致配对码失效过期，如何重新触发配对流程？
参考答案 1：
在飞书客户端重新向 OpenClaw 机器人任意发送一条信息，机器人会自动生成并返回一个新的配对码，格式如下：
OpenClaw: access not configured.
Your Feishu user id: ou_xxxxxxxxxxxxxxxx
Pairing code: XXXXXXXX
Ask the bot owner to approve with:
OpenClaw pairing approve feishu XXXXXXXX
配对码通常有效期最多为 5-10 分钟。
回答者：
参考答案 2：
通用命令行处理方式
- 重启网关重新触发
登录部署 OpenClaw 的云服务器/本地终端，执行命令：
OpenClaw gateway restart
重启网关后打开飞书，给你的 OpenClaw 机器人发送任意消息，就会重新生成新的配对码，再执行OpenClaw pairing approve feishu [新配对码]（替换为终端显示的新代码）即可完成配对。
如果重启后仍未生效，可执行OpenClaw config clear清除旧配对缓存后，再次执行上述配对流程即可。
- 重启飞书渠道触发
执行以下命令关闭再重新启用飞书渠道，即可重新触发配对：
OpenClaw channels disable feishu
OpenClaw channels enable feishu
不同配置场景的额外方法
- 如果您是通过 WebUI 配置的飞书机器人：
可以进入Settings > Config > Authentication页面，重置飞书相关的认证配置后重新进行配对，即可重新生成有效的配对码。 - 如果您使用的是预装 OpenClaw 镜像的云服务器：
可以通过重装镜像或者执行初始化脚本，重新触发首次配对流程，获取新的配对码完成飞书端配对。 - 如果您是参考活动页教程部署的 OpenClaw：
可以回到配置 AI 管家的步骤，重新执行飞书机器人配置的相关命令，即可重新生成配对信息解决过期问题。
注意事项
操作前请确保您的飞书应用已经完成发布，并且配置了im:message等核心权限，避免配置问题影响配对流程。
20.如何让龙虾机器人具备浏览器的能力去读取小红书、B 站评论、微信公众号或知乎文章，并绕过反爬验证码拦截？
云端龙虾很难实现，本地龙虾使用浏览器 realy 控制，模仿真人操控。
21.龙虾机器人调用即梦 （Jimeng） API 等生图工具后，机器人为何只返回 Base64 代码或本地路径，如何让它直接在飞书聊天框发送图片或视频文件？
原因说明
机器人返回 Base64 代码或本地路径，是因为生图工具（如即梦 API）生成的图片数据需要通过飞书的文件上传接口处理后，才能直接发送到飞书聊天框，OpenClaw 默认输出源数据格式，适配飞书的消息格式要求即可解决该问题。
参考答案 1：
解决步骤
- 确认基础权限配置
参考 OpenClaw 官方文档《接入飞书机器人》章节的配置步骤，确认飞书机器人已开通im:message、file:write等相关权限，并在 OpenClaw 中配置正确的飞书消息发送通道。 - 适配飞书媒体消息格式，可选择以下方案实现
方案一：调用飞书官方接口处理
将 Base64 编码或本地图片/视频转换为二进制流，通过飞书开放平台的文件上传 API（如/api/v2/files/upload）上传至飞书服务器，获取文件的file\_key后，构造飞书支持的媒体消息格式发送，示例格式如下：
{
"msg_type": "image",
"content": {
"image_key": "上传后的 file_key"
}
}
整理者：
参考答案 2：
通过 OpenClaw 自定义能力实现
可通过 OpenClaw 的插件机制或自定义 Skill，添加图片/视频文件上传和发送的逻辑，将 Base64 内容转换为飞书可识别的媒体文件后再发送，具体自定义消息发送逻辑可以查阅 OpenClaw 官方文档《在 Linux 操作系统中快速部署 OpenClaw，并集成 IM 工具 AI 助手》中 IM 集成的相关部分。
- 验证结果
完成配置后重新调用生图工具，即可验证是否能正常发送媒体文件。
整理者：
22.飞书如何配置多个龙虾？或者多 agent
参考答案 1：作者：宇航
参考答案 2：回答者
https://x.com/jungeAGI/status/2024791301783503083
参考答案 3：
23.机器人如何直接读取群里上传的 Word 附件、.xlsx 表格，以及飞书妙记（Minutes）的语音转录文本？
- Word 附件 （。docx)
方法：下载后用 Python 解析
from docx import Document
def read_word(file_path):
doc = Document(file_path)
text = []
for para in doc.paragraphs:
text.append(para.text)
return '\n'.join(text)
需要的权限：
- im:file:download 或 im:resource:download
限制：Bot 只能下载被@时消息中的文件，不能主动遍历群文件。
- Excel 表格 （。xlsx)
方法：用 pandas 或 openpyxl 读取
import pandas as pd
def read_excel(file_path):
df = pd.read_excel(file_path)
return df.to_string()
飞书事件触发：
{
"event_type": "im.message.file_receive",
"file": {
"file_name": "data.xlsx",
"file_key": "file_xxx"
}
}
- 飞书妙记 （Minutes）
难点：妙记有单独的权限体系，普通 Bot API 无法直接访问。
可行方案：
方案 A：妙记导出后上传
- 用户手动导出妙记文本
- 上传为 。txt 或 。docx
- Bot 读取
方案 B：使用飞书开放平台专用接口
需要申请 minutes:readonly 权限
url = "https://open.feishu.cn/open-apis/minutes/v1/records"
headers = {"Authorization": f"Bearer {token}"}
获取转录文本
方案 C：Webhook 接收
- 配置飞书事件订阅
- 妙记完成后自动推送转录文本给 Bot
24.使用 clawhub 下载安装技能时，一直报 Rate limit exceeded，除了等待还有什么命令行方式可以绕过？
您的问题是 OpenClaw 通过 Clawhub 下载 Skills 时，出现Rate limit exceeded（超出频率限制）报错，这个报错是 ClawHub 对请求频率的限制导致，一般是短时间内请求过多、同 IP 请求超限触发，您可以尝试通过以下方案解决：
1、等待重试
暂停操作 5-10 分钟后，使用 OpenClaw skills install [技能名] 命令重新安装，注意一次仅安装一个技能，限流一般会在一段时间后自动解除。
2、手动安装绕过限流
从 ClawHub 网站直接下载对应技能的 ZIP 包，解压到 C:\Users\你的用户名。OpenClaw\skills 目录，即可绕过自动安装的限流限制完成安装。
3、更换网络重试
切换手机热点或其他网络，通过不同 IP 地址访问 ClawHub，即可解除当前 IP 的限流限制。
4、排查并发请求问题
如果您有多个 OpenClaw 实例同时使用同一个 Clawhub 账号请求技能，建议停止多实例并发请求，避免触发频率超限。
您也可以前往 OpenClaw 官方活动页面查看 Clawhub 使用的最新说明。
本答案来自于 OpenClaw 开发者交流群｜火山版，由整理
25.在同一个 OpenClaw 实例下，如何配置多个飞书机器人分别对应不同的 Agent？目前配置第二个机器人时，为何会把第一个默认（default）机器人顶替下线？
参考答案 1：作者：宇航
参考答案 2：
一、配置多个飞书机器人分别对应不同 Agent 的方法
- 创建独立智能体：通过命令行创建多个智能体，每个智能体拥有独立的工作目录，还可按需配置不同的 AI 模型。
- 修改网关配置：在
gateway配置中为每个智能体设置独立的网关和名称映射，保证智能体与飞书应用为唯一绑定关系。 - 独立配置飞书应用：为每个智能体单独创建飞书企业自建应用，分别获取对应应用的
appId和appSecret，再在 OpenClaw 中给对应智能体分别配置这些信息。
二、第二个机器人顶替第一个默认机器人下线的原因
- 配置冲突：没有为新智能体设置独立的网关或名称映射，导致原有的默认配置被覆盖，因此顶掉了原机器人。
- 凭证共享：多个机器人使用了同一个飞书应用的凭证，飞书本身限制同一应用仅能保持一个实例在线，因此会顶替原机器人下线。
整理者：
26.把多个不同的 龙虾机器人拉到同一个飞书群里，如何让它们互相认识、互相正确使用 @ 符号进行工作委派与沟通？
飞书群里的机器人，互相之间看不到对方。【此问题答案还没最终确认，正在研究中】
27.头一天设定好的人设、称呼和定时任务，断网或第二天重启网关后完全失忆。如何让机器人正确读取和更新 SOUL.md、MEMORY.md 等核心记忆文件？
这个问题正常不会出现，这种配置文件都是在会话开始的时候自动读取的，除非你的龙虾并不是重启，而是重置导致配置文件丢失。
28.群聊中，如何避免子 Agent 调度工具时的中间思考过程（如“让我查一下”）泄漏到群里，只让它输出最终结论？
直接让龙虾调整配置文件，禁用思考过程输出就行
29.飞书 OpenClaw 机器人可以加入群组吗？
答：可以的，内部群是没有限制的，但如果是外部群则需要企业认证，企业版需管理员开启应用权限。参考：https://open.feishu.cn/document/develop-robots/add-bot-to-external-group?lang=zh-CN
回答者：
30.如何修改飞书机器人在群内的回复方式？
目前插件在群内默认的方式为：只有@机器人才会回复。
- 模式 1：只有@机器人才回复。
在终端执行以下命令配置飞书机器人，配置完成后重启服务。
# 设置需要 @ 才回复
OpenClaw config set channels.feishu.requireMention true --json
完整的配置示例如下：
{"channels": {"feishu": {"enabled": true,"appId": "你的AppID","appSecret": "你的AppSecret","requireMention": true,"groupPolicy": "open"}}}
- 模式 2：不用@机器人，所有消息都回复。
说明
这个模式在大群里容易刷屏，请谨慎使用！
- 在飞书开放平台，单击创建的飞书开放应用。
- 在左侧菜单中选择”开发配置 > 权限管理“，单击”开通权限“按钮，添加权限”获取群组中所有消息（敏感权限）“，然后单击”确认开通权限“。
- 重新发布应用。
- 在终端执行以下命令配置飞书机器人，配置完成后重启服务。
# 设置不需要 @ 也回复
OpenClaw config set channels.feishu.requireMention false --json
其中完整的配置示例如下：
{"channels": {"feishu": {"enabled": true,"appId": "你的AppID","appSecret": "你的AppSecret","requireMention": "open","groupPolicy": "open"}}}
- 模式 3：只有指定群@机器人才回复，适合不同群不同规则。
- 获取群 ID。
- 在飞书群设置页面中获取群 ID。
- 在飞书群让机器人回复群 ID。
- 配置指定群回复消息规则，配置完成后重启服务。
- 获取群 ID。
# 1. 设置默认所有群都不需要 @
OpenClaw config set channels.feishu.requireMention false --json
# 2. 给特定群设置需要 @（这里群ID只是示例，需要替换成真实的群ID）
OpenClaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
本答案来自官方文档：https://www.volcengine.com/docs/82379/2165245?lang=zh#863901a0
31.为什么开通了读取权限，龙虾机器人没有消息输入框
参考答案 1：
检查下面几个点：
1.有没有添加机器人权限
2.回调里面事件有没有开启
3.回调里面的长链接有没有点击配置保存？
回答者
参考答案 2：
- 登录飞书开发者后台。
- 进入应用机器人详情页。
- 在 权限管理 功能页，确保已经以应用身份开通了 读取用户发给机器人的单聊消息（im:message.p2p_msg:readonly）权限。了解 API 权限，参见申请 API 权限。
- 在 事件与回调 > 事件配置 功能页，确保已经以应用身份订阅接收消息事件。了解事件订阅，参见事件概述。
- 在 版本管理与发布 功能页，确保应用已发布，使以上配置均生效。
32.为什么我只跟龙虾说了 10 几句话，就限额不让用了？
用户的一句话可以视为一条指令，一条指令背后可能是有几十几百条请求组成，所以会出现这样的情况，结合你订阅的套餐来看，比如你是买的 9.9lite 套餐，里面有配额限制 5 小时内不超过 1200 条请求，综上会出现十几句话就达到限额的问题。另一方面，如果你开启了流式输出，也会加剧这个消耗，因为他是会把上下文一起，查看限额地址：方舟控制台-开通管理
回答者：
33.ArkClaw 重启中，正在尝试重连，请耐心等候，若超过 2 分钟未恢复，建议自动修复实例
参考答案 1：
- 打开 arkClaw 右侧的 "设置" 面板。
- 点击 "重新初始化 ArkClaw" 选项。
- 等待 1～2 分钟，直到界面重置为初始状态。
- 界面恢复后，即可重新开始配置流程。
参考答案 2：
重新安装 OpenClaw
回答者：
34.为什么龙虾给我发一句话，ArkClaw 网页也发一句，这个是正常的吗，如果不正常如何调整
答：channel 和 web ui 的对话是同步的， 飞书里私聊对应 agent:main:main，也就是正常的
回答者：wood
35.龙虾隔一会就给我发配对码，是什么情况，如何解决
先重启网关（直接给龙虾说，重启下网关），如果恢复正常就好了，如果还不正常，重新配置下
回答者：何芃
36.创建飞书机器人后，发现机器人界面没有聊天输入框，也看不到配对码
核心原因
机器人本身不会自带配对码。配对码是在完成消息渠道配置后，由 OpenClaw 在配对阶段动态生成的。用户大概率卡在以下环节之一。
排查步骤（按顺序）
第一步：确认应用已发布
进入飞书开放平台 → 你的应用 → 发布管理。确认应用状态不是「草稿」或「审核中」，而是已发布可用状态。
第二步：确认消息渠道配置完整
不是只创建了机器人就可以，还需要确保以下信息都已正确配置到 OpenClaw 中：
- App ID
- App Secret
- 事件订阅/回调
- 消息渠道
第三步：确认 Gateway 在运行
如果 Gateway 未运行，机器人不会返回配对码。执行以下命令检查：
systemctl status --user OpenClaw-gateway.service
第四步：在飞书中触发配对
在飞书中直接给机器人发送一条消息，或发送 /feishu auth。正常情况下，机器人会回复一条包含 pairing approve 的配对信息。
如果仍然没有配对码
说明不是「码丢了」，而是前面的接入链路未打通。优先排查：
- 应用未发布
- 事件订阅没配好
- Gateway 没启动
- 消息渠道没配成功
37.遇到反复授权请求怎么处理？
问题描述： 在使用过程中，arkClaw 反复弹出授权请求，影响使用体验。
核心原因
此问题与 OpenClaw 无关，是飞书应用本身的权限配置问题。
排查重点
- 权限未添加到应用后台：打开飞书开放平台 → 你的应用 → 权限管理 → 搜索所需权限 → 点击「开通/添加」
- 应用未发布：权限添加后必须点击「申请发布」或「全员可见」，否则权限不会生效
- 混淆了「可用权限」与「已开通权限」：可用权限 = 应用能请求的权限（需手动开通）；已开通权限 = 用户授权后实际生效的权限
快速验证方法
- 打开飞书应用后台 → 权限管理
- 查看「可用权限」和「已开通权限」两栏
- 确认所需权限（drive、contact 等）在两栏中都已存在
一次性完成所有授权方法
如果您希望一次性完成所有授权，可以直接向 arkClaw 输入以下内容：
我想获取所有权限
arkClaw 将一次性请求所有所需的用户授权，避免后续反复弹出授权窗口。
38.为什么总报错：Agent failed before reply: No API key found for provider "anthropic"。
本地安装时认证配置错误，需要有动手能力才可进行修改，小白最好跟着教程重新安装走一遍：
参考方案 1：
https://github.com/OpenClaw/OpenClaw/issues/19961
参考方案 2：
https://github.com/OpenClaw/OpenClaw/issues/5181
39.配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？
解决方案参考
这个报错通常是 OpenClaw 调用 codingplan 套餐内模型时 base url 传错了， 本质还是配置文件填写错误，检查以下两个核心配置文件的 base url ~/.openclaw/openclaw.json ~/.openclaw/agents/main/agent/models.json
- 请检查以下两个配置文件中的 baseurl 等信息是否一致。
- ~/.OpenClaw/OpenClaw.json：全局配置
- ~/.OpenClaw/agents/main/agent/models.json：单个 Agent 本地模型配置，优先级高，会覆盖全局配置。
- 两个配置文件不一致时，需先删除～/. OpenClaw/agents/main/agent/models.json。
- 根据 OpenClaw 配置文档～/。OpenClaw/OpenClaw.json，配置完成后保存文件并执行命令重启服务。
OpenClaw gateway restart
回答来自火山引擎
40.创建龙虾，提示暂无创建 ArkClaw 的权限，请确认账号是否拥有绑定了 ECSClawRolePolicy 策略的 ECSClawRole 角色
子账号没有充分授权，可以创建独立的主账号，然后前往访问控制添加 ECSClawRole，绑定 ECSClawRolePolicy
41.Windows 电脑本地安装的 Open Claw 如何彻底卸载？
步骤 1：停止并卸载网关系统服务
# 停止网关服务
OpenClaw gateway stop
# 卸载网关系统服务
OpenClaw gateway uninstall
# 验证服务是否已移除（无输出则成功）
schtasks /Query /TN "OpenClaw Gateway"
步骤 2：卸载 npm 全局包（核心安装文件）
# 卸载 OpenClaw 全局包
npm uninstall -g OpenClaw
# 清理 npm 缓存（避免重装时缓存干扰）
npm cache clean --force
步骤 3：删除配置文件和数据目录（关键，避免残留配置导致重装报错）
# 删除 OpenClaw 核心配置目录（包含模型、网关配置）
Remove-Item -Recurse -Force $env:USERPROFILE\.OpenClaw
# 删除 npm 全局安装目录下的 OpenClaw 残留（可选，确保彻底）
Remove-Item -Recurse -Force $env:APPDATA\npm\node_modules\OpenClaw
步骤 4：验证卸载完成
# 检查是否还有 OpenClaw 命令（无输出则卸载成功）
OpenClaw --version
# 检查配置目录是否存在（无输出则删除成功）
Test-Path $env:USERPROFILE\.OpenClaw
42.Command Line Tools(CLT) are missing You must install the Command Line Tools (CLT) before installing Homebrew by running`xcode-select --install' from a Terminal.
先在终端中运行：xcode-select --install
然后再运行安装包
收尾时 xcode-select -p 去验证是否安装成功
43.无法获取用户身份，请在飞书对话中使用此命令
1、在终端输入：
OpenClaw channels list
2、输出的内容给 AI 检查，看是否是没有配置任何 OAuth。这个问题反馈在代码里是：Auth providers （OAuth + API keys）:
- none
3、如果是这个问题，在终端运行：
feishu-plugin-onboard install
4、运行完成后，重启。在终端输入：OpenClaw gateway restart
5、收尾时，返回飞书机器人聊天页面，输入/feishu auth，授权即可。
44.抱歉，你的消息因安全策略被拦截了，请修改内容后重新提交，避免包含违规敏感信息哦。
不同大模型风控等级不同，有两种办法解决
①修改本身的消息内容，去除可能的敏感信息
②更换大模型，可以在 codeplan 页面手动切换，在方舟控制台-开通管理可以查看
45.龙虾机器人各种权限不足问题，怎么快速解决
如果希望快速完成给龙虾的权限授权，便于丝滑调用各种飞书工具，可以随时告诉 AI：“我想授予所有用户权限”，来完成权限的授予。
提醒：此举虽然方便，但整体比较危险，不建议在生产环境这么操作
46. 如何将 OpenClaw（龙虾）从飞书个人账号迁移到企业账号？
答案仅适用于本地龙虾，如果是云端龙虾，访问对应的webui地址
步骤一：
A: 迁移的核心是更换飞书机器人的绑定凭证。具体操作如下：
- 获取企业机器人凭证：在飞书开放平台的企业账号应用中，获取新的 App ID 和 App Secret
- 修改配置文件：在 OpenClaw 的配置文件（
openclaw config）中，将原个人账号的 Bot ID 和 Secret 替换为企业账号的对应凭证 - 重新绑定：通过 OpenClaw 的交互界面，发送新的凭证信息完成重新绑定
原理说明：OpenClaw 是通过绑定飞书机器人的凭证来建立连接的，更换凭证即完成了账号迁移。
步骤二：
应该在哪个界面操作绑定？Web UI 入口在哪里？
A: 操作绑定的 Web UI 地址为：http://127.0.0.1:18789/
注意：如果该地址无法访问，说明 OpenClaw Gateway 当前处于离线状态。
步骤三：
Web UI 无法访问（显示离线），该如何处理？
A: 这通常是因为 Gateway 服务未启动。解决步骤如下：
- 启动 Gateway：在终端中输入以下命令启动服务：
openclaw gateway
- 观察日志：启动后观察终端是否有数据流动的日志输出
- 刷新页面：确认 Gateway 正常运行后，重新刷新
http://127.0.0.1:18789/即可访问
步骤四：
迁移完成后，原飞书个人账号需要解绑或做其他设置吗？
A: 不需要。
迁移过程是 OpenClaw 端更换绑定的目标账号，不会对原个人账号的飞书机器人和应用产生任何影响。原个人账号的配置保持完整，未来如有需要可以：
- 继续保留个人账号的配置，用于其他用途
- 或者在该账号上部署另一个独立的 OpenClaw 实例
提示：如果在迁移过程中遇到长时间无响应的情况，建议先检查 Gateway 是否在线，而非重复发送凭证信息。
47.404 The xxxxxx model does not support the coding plan feature. Please refer to the documentation at https://www.volcengine.com/docs/82379/1925114 to select a compatible model.
解决方案参考：
这个报错通常是 OpenClaw 调用 codingplan 套餐内模型时 model name 传错了， 本质还是配置文件填写错误，检查以下两个核心配置文件的 model name
~/.openclaw/openclaw.json ~/.openclaw/agents/main/agent/models.json
都检查并修改完成之后在终端执行 openclaw gateway restart 重启服务以保障配置生效⚠️ 注意： 请勿填写成 在线推理的 Model ID ，这些 Model ID 对应的是在线推理的模型名称
✅ 正确的 model name- doubao-seed-2.0-code
- doubao-seed-2.0-pro
- doubao-seed-2.0-lite
- doubao-seed-code
- minimax-m2.5
- glm-4.7
- deepseek-v3.2
- kimi-k2.5
- ark-code-latest
❌ 错误的 model name- doubao-seed-2-0-pro-260215
- doubao-seed-2-0-code-preview-260215
- glm-4-7-251222
- deepseek-v3-2-251201
回答来自火山引擎
48.401 The API key format is incorrect.
这个报错通常是 OpenClaw 调用 codingplan 套餐内模型时 apikey 传错了， 本质还是配置文件填写错误，检查以下两个核心配置文件的 apikey （获取 API Key） ~/.openclaw/openclaw.json ~/.openclaw/agents/main/agent/models.json
还有一种情况，配置文件中 apikey 使用的是环境变量，环境变量中的值是错误的。
.都检查并修改完成之后在终端执行 openclaw gateway restart 重启服务以保障配置生效
回答来自火山引擎
49.我用的OpenClaw，想要接入火山引擎的CodePlan，应该怎么做？
通过终端进行配置
- 在终端执行以下命令打开 OpenClaw 配置文件。
vim ~/.openclaw/openclaw.json
- 修改配置信息，完成 Coding Plan 对接。
- 修改 baseUrl 为 https://ark.cn-beijing.volces.com/api/coding/v3
- 将<ARK_API_KEY>替换为您自己的 API Key
- 填写 Coding Plan 套餐对应的 model name
如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议在原有配置文件基础上，修改对应的 baseUrl、apiKey、models id 等信息
配置文件参考
{
"models": {
"providers": {
"volcengine": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
"apiKey": "<ARK_API_KEY>",
"api": "openai-completions",
"models": [
{
"id": "ark-code-latest",
"name": "ark-code-latest",
"api": "openai-completions",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 32000
},
{
"id": "doubao-seed-2.0-code",
"name": "doubao-seed-2.0-code",
"api": "openai-completions",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 128000
},
{
"id": "doubao-seed-code",
"name": "doubao-seed-code",
"api": "openai-completions",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 32000
},
{
"id": "glm-4.7",
"name": "glm-4.7",
"api": "openai-completions",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 128000
},
{
"id": "deepseek-v3.2",
"name": "deepseek-v3.2",
"api": "openai-completions",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 32000
},
{
"id": "kimi-k2.5",
"name": "kimi-k2.5",
"api": "openai-completions",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 32000
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "volcengine/ark-code-latest"
},
"models": {
"volcengine/ark-code-latest": {},
"volcengine/doubao-seed-2.0-code": {},
"volcengine/doubao-seed-code": {},
"volcengine/glm-4.7": {},
"volcengine/deepseek-v3.2": {},
"volcengine/kimi-k2.5": {}
}
}
},
"gateway": {
"mode": "local"
}
}
- 配置完成后保存文件，并在终端执行以下命令重启服务使更改生效。
openclaw gateway restart
50.怎么删除企业自建应用（含机器人）？
第一步：企业管理员停用应用
- 拥有飞书企业管理员权限的企业管理员登录飞书后台（飞书管理后台）在左侧的栏目中找到[工作台]→[ 应用管理]。
- 进入应用详情页，在页面右上角找到「停用 / 启用」开关，关闭开关完成应用停用操作。
第二步：应用所有者删除应用
- 应用所有者登录飞书开放平台开发者后台，找到已完成停用的目标应用。
- 点击应用进入应用管理页，找到「删除应用」选项。
- 点击删除并完成二次风险确认，即可完成应用的彻底删除。
注意事项：
1.应用删除后不可恢复，相关的应用凭证、权限配置、业务数据等将全部清空，请提前做好备份和风险评估。
2.应用停用后，企业内所有成员将无法访问、使用该应用，相关机器人消息、自动化流程、API 调用等能力将全部失效。
贡献者名单
感谢以下社区成员的贡献（按字母排序）：
- @离黍
- @王一成
- @折辉
- @虾牛-专业养🦞
- @宇航
- wood
- 何芃
做出来了，下一步：登记
项目能跑只是前半程。源码文档整理、申报材料生成这类重复劳动，可以交给软著通——AI 软件著作权申请工具，材料备齐再提交；登记结果以中国版权保护中心审核为准。