常见问题
按问题类型查看安装登录、MCP 授权、业务系统集成、畅算粒和技能训练的处理方案。
使用 CClaw 过程中遇到问题时，可以先按左侧类别定位，再在右侧快速导航中直接跳到对应问题。
产品形态与权限问题
Q：畅龙虾有没有手机端？
畅龙虾目前是独立应用，不是单独的手机端产品。移动端或外部协同场景可以通过对接钉钉、飞书、QQ、企业微信等渠道来承接通知和任务触发。
Q：畅龙虾以后会预制到业务软件中吗？
不会。畅龙虾会保持独立应用形态，不会直接预制到具体业务软件中。
Q：畅龙虾如何设置预警和权限？可以按人员设置使用量吗？
可以，这部分能力后续会持续迭代。预警、权限控制和按人员设置使用量都属于后续增强方向。
安装与登录问题
Q：mac 安装报错 Read-only file system 怎么处理？
如果出现 write openclaw shim: Read-only file system (os error 30)，通常是因为应用仍在 dmg 镜像中运行，目录不可写。
处理步骤：
- 退出当前客户端。
- 打开
CClaw.dmg，将 CClaw 拖入 应用程序（Applications）。 - 从 应用程序 中重新启动 CClaw，不要从镜像窗口启动。
Q：系统权限为什么建议允许？
安装后首次使用，建议允许 CClaw 请求的系统权限，常见包括：
- 文件与文件夹访问权限
- 辅助功能权限
- 自动化权限
权限不足时，可能出现以下现象：
- 能看到功能但执行失败
- 工具调用中断或返回异常
- 自动化动作无法完成
遇到上述问题时，先完成系统权限授权，再重试同一任务。
Q：畅捷通账号登录后，企业应该怎么选？
推荐路径：通过畅捷通账号登录 -> 企业加入 -> 企业管理。
选择企业时，请优先参考以下规则：
- 先选你当前在管的企业。
- 企业管理列表中没有“退出”按钮的企业，通常是你当前应选企业。
- 显示“退出”的企业，通常表示你是成员身份加入，不作为默认扣减主体，实际以业务规则为准。
如果误选企业，可能出现身份识别与资源扣减主体不一致。此时请退出登录并重新进入企业选择页完成重选。
Q：我自己建的企业为什么还需要验证？
即使是自己创建的企业，系统仍需要进行基本身份验证，以确保账号安全、企业归属清晰和服务可用性。
这是标准安全流程，不影响正常使用。按页面提示完成验证后，即可继续登录、开通授权或使用相关服务。
Windows 常见问题
Q：Windows 网关连接失败时应该先怎么处理？
如果 Windows 客户端左侧显示 网关连接失败，或主界面提示 网关启动失败，请优先使用自助诊断：
- 点击客户端左下角的 诊断 图标。
- 在诊断窗口中选择 快速扫描。
- 按扫描结果提示处理后，再尝试重新连接。
Q：连接一直转圈或超时，如何排查？
建议按以下顺序排查：
- 检查本机网络是否正常。
- 检查 T+、好业财或好生意服务端是否正常运行。
- 如果正在使用 VPN 或代理，尝试关闭后重试。
- 使用客户端内置的 诊断 → 快速扫描 检查具体错误。
- 如果以上均正常，重启客户端和对应业务服务后再试。
如果问题只发生在 T+，可进一步参考 T+ 接口服务 404/异常处理。
Q：Windows 出现 Agent failed before reply 怎么办？
如果 Windows 客户端主对话中出现 Agent failed before reply: Unknown model，请将 CClaw 升级到 0.7.9 及以上版本 后再重试。
升级后建议重新启动客户端，并重新发起一次相同对话确认问题是否恢复。
MCP 授权与调用问题
Q：登录 CClaw 后，如何调用畅龙虾的 MCP 服务？
进入 MCP 插件市场 后，先在页面顶部点击当前企业名称，切换到需要调用 MCP 服务的目标云企业，再选择目标插件卡片并点击 生成 MCP 配置。应选择实际需要查询或操作其业务数据的企业。
如果此前未订阅授权该插件，会弹出 mcphub 的开通授权窗口。这里授权的是 mcphub，不是 CClaw；需要选择目标应用在期的云企业和应用，才能真实调用对应业务系统服务。
例如选择 HYC-MCP 插件时，需要用好业财对应企业完成开通授权。如果弹窗中的应用列表不包含好业财，通常说明当前云企业没有好业财在期鉴权，请先开通好业财试用，或切换到好业财在期的云企业。
Q：订阅 MCP 需要什么条件？
订阅 MCP 前需要满足以下条件：
- 企业已经开通需要连接的应用，例如 T+、好业财或好生意。
- 由企业管理员或具备该应用订阅权限的管理员先订阅对应 MCP，其他企业成员之后才能使用。
- 使用手机号注册的畅捷通账号完成登录和授权。
如果当前账号不是目标企业的管理员，请先联系企业管理员完成首次订阅和开通授权。
Q：生成 MCP 配置后没有自动弹出导入引导怎么办？
如果 CClaw 没有自动识别剪贴板配置并弹出导入引导，可以手动导入：
- 回到 CClaw 的 MCP 页面。
- 点击 添加服务。
- 选择 JSON。
- 粘贴从 MCP 插件市场复制的
mcp-json配置。 - 点击 导入。
具体图文步骤可查看 MCP配置。
Q：刚配好 MCP，怎么确认连通正常？
建议先新建一个会话，使用低风险的只读查询验证：
- 查询一条已知客户、商品或单据。
- 确认返回的是目标企业和目标账套的数据。
- 对比业务系统页面，确认数据内容一致。
- 确认当前账号只能访问其权限范围内的数据。
如果同一企业存在多个账套，CClaw 提示选择账套也说明 MCP 已经可以发现可用账套；选定目标账套后再继续验证。
Q：授权产品应该怎么选？
授权时选择的产品必须与插件对应。
- 配置好业财 MCP，就选择好业财。
- 配置好生意 MCP，就选择好生意。
- 配置 T+ MCP，请按 T+ 企业和账套实际情况选择。
产品选错时，后续调用可能出现企业、应用或账套不匹配的问题。
Q：提示“未找到云企业（orgid）对应的账套，请重新选择企业登录”怎么办？
该提示通常表示 T+Cloud 的授权或登录状态已经失效，或者当前选择的云企业与目标账套不匹配。
建议按以下顺序处理：
- 检查当前选择的企业和账套是否正确。
- 重新登录 T+Cloud，避免登录凭据已经过期。
- 重新生成或更新 MCP 配置中的认证信息。
- 回到 MCP 插件市场，切换到目标账套所属企业后重新授权。
如果重新登录和授权后仍然报错，请确认目标 T+ 账套已经绑定到当前云企业。
Q：如何让 AI 学会使用 MCP 工具？
开始做业务查询前，建议先让 AI 了解当前可用的 MCP 工具能力。可以在 CClaw 聊天窗口发送以下提示词：
你先跟龙虾聊天！详细介绍一下 MCP 工具以及如何使用。你先学习一下 T+ 的工具的全部工具能力，学习后完成记忆，学完告诉我后续我分析业务数据，都需要使用 MCP 工具来查询。这段提示词的作用是：
- 让 AI 先了解当前 MCP 有哪些工具能力。
- 让 AI 建立对这些工具的使用认知。
- 明确告诉 AI，后续业务数据分析需要优先使用 MCP 工具查询。
建议操作步骤：
- 在 CClaw 聊天窗口发送上述提示词。
- 等待 AI 响应，并查看它对 MCP 工具能力的理解。
- AI 回复已完成学习或已处理工具后，再下达业务查询指令。
- 每次新会话或重启后，建议重新发送一次提示词，确保 AI 重新建立 MCP 工具上下文。
Q：AI 说“自动去调浏览器了，没有 MCP 的接口”是什么意思？
这通常表示 AI 在执行任务时选择了 浏览器工具，而不是选择 MCP 工具。常见原因是当前会话里还没有明确告诉 AI 优先使用 MCP。
可以按以下方式处理：
- 先发送“学习 MCP 工具”的提示词，让 AI 了解当前可用的 MCP 能力。
- 在业务查询指令中明确强调：不要使用浏览器，只使用 MCP 工具查询业务数据。
- 如果 AI 仍然反复使用浏览器，可以在当前任务说明中再次限制工具选择，或检查 MCP 配置是否已正确导入和启用。
从工具选择逻辑看，CClaw 中可能存在 MCP、浏览器、文件读写等多类工具。AI 会根据任务描述自行选择工具；如果没有明确引导，它可能会选择自己判断更熟悉的方式。因此，业务系统数据查询类任务建议在提示词中明确要求使用 MCP。
Q：mcphub 开通授权后出现 code=4028 怎么处理？
1.问题现象：开通授权时，抛错误码code=4028是T+侧异常，如果渲染的是页面（如阿里云防火墙等），则判定为 T+订阅消息同步抛错：Unexpected character encountered while parsing value: <. Path ......
2.原因分析：由于畅云管家或自有服务器的安全配置，使用畅云管家或自有服务器对接，需要在T+里配置畅云管家或自有域名才可以进行OpenAPI对接；
3.问题方案：登录系统管理员，配置外网地址（配置后点击“连接测试”，返回成功后即可。）；登录账套，打开“云应用管理”菜单，点击“服务器网络连接”（返回“连接测试成功”后即可）；再次授权，就不报错了。 参见：https://open.chanjet.com/docs/file/qa/qa/tplusopenapi/cjtmspAuthError
Q：MCP 授权后工具列表为空，怎么处理？
按以下顺序检查：
- 确认 MCPHub 已经在应用市场正常开通。
- 确认授权时选择的企业与 CClaw 当前登录企业一致。
- 确认对应 MCP 服务已经启用。
- 删除该服务后重新添加配置。
- 如果工具列表仍为空，在 MCP Hub 中退订对应服务，再重新订阅和授权。
工具列表恢复后，建议先使用只读查询验证连接，再执行后续业务任务。
Q：同时配置多个 MCP 会不会调错？
不同产品的 MCP 使用独立配置，不会共享调用凭证，但同时启用多个相近 MCP 时，AI 可能选错产品或账套。建议这样管理：
- 当前任务需要哪个 MCP，就只启用哪个 MCP，暂时禁用其他不相关服务。
- 在会话开始时明确说明产品和账套，例如“请使用好业财 MCP 查询……”。
- 如果要切换产品或账套，建议新建会话，并重新确认已启用的 MCP。
- 不再使用的 MCP 可以保持禁用；需要时再重新启用，无需反复删除配置。
Q：调用 MCP 服务时提示 orgid and appid not match 怎么办？
该提示通常表示 mcphub 授权时选择的企业或主应用与当前插件不匹配。
处理方式：
- 进入应用市场的 我的应用。
- 找到目标企业下的 mcphub。
- 使用与目标插件匹配的主应用重新完成开通授权。
- 重新进入应用，触发更新最新调用令牌后再发送请求。
也可以在 MCP hub 的已订阅服务列表中退订后重新订阅。
Q：怎么退订已授权的 MCP？什么情况下需要退订？
进入 MCP Hub → MCP 服务器 → 我的服务管理 → 已订阅服务，找到目标服务后，点击右侧的 退订 并确认。
以下情况可以退订：
- 已经不再使用该 MCP 服务。
- 订阅时选错了企业或产品，需要重新选择。
- 出现企业、应用或授权关系异常，需要退订后重新建立授权。
退订后，原有授权和 MCP 配置可能不再可用。如果还要继续使用该服务，需要重新订阅、授权并生成最新配置。
业务系统集成问题
Q：好业财和好生意的对接流程在哪里看？
好业财和好生意的详细对接流程当前使用外部实施文档：
Q：T+ 授权时 T+Cloud 和 Tplus 怎么选？
如果不确定哪个是订单企业、哪个是账套企业，可以先登录目标 T+ 账套，进入 基础设置 → 云应用。页面中会显示当前账套企业名称和企业 ID，并可查看其关联的订单企业。配置 MCP 时，应选择实际需要查询或操作其账套数据的企业。
通过 mcphub 授权 T+ 相关插件时，云企业可能存在多种情况：
- 纯 T+C 订单企业，且未绑定任何 T+ 账套：通常只露出 T+Cloud，可能无法调用到账套数据，建议切换到 T+ 账套企业。
- 既是 T+C 订单企业又是 T+ 账套企业：会露出 T+Cloud 和 Tplus，通常选择任一主应用都可以调用该云企业绑定的 T+ 账套数据。
- 纯 T+ 账套企业，或绑定了 T+ 专属云订单企业的账套企业：通常只露出 Tplus，选择 Tplus 授权即可。
更多说明可查看 连接T+ 指南。
Q：通过 MCP 写入、审核或删除数据前要注意什么？
写入操作会改变业务系统数据，应遵循以下五项规则：
- 先查后写：先查询并确认客户、存货、单据等真实数据，不要依赖猜测写入。
- 小范围试跑：先用测试数据或少量数据验证，再扩大到真实业务数据和批量任务。
- 提交前复述：执行前列出客户、金额、数量、日期、目标账套等关键内容，请用户确认。
- 高风险操作二次确认：删除、审核、弃审、批量改价和批量开单等动作，必须在提交前再次确认。
- 使用真实唯一标识：单据号、客户编码、存货编码等必须来自系统查询结果，不要让 AI 自行猜测。
推荐在任务中明确要求：“先告诉我准备调用哪个接口、写入什么数据、是否需要审核，暂时不要提交。”
畅算粒与模型消耗问题
Q：生成技能后是快速调用，还是可以减少畅算粒消耗？
生成技能后，一方面可以让高频任务更快被调用，另一方面使用现成技能通常也有助于减少无效尝试，从而降低不必要的畅算粒消耗。
不同技能的消耗不一样，具体消耗取决于任务复杂度、调用的 MCP 能力、模型、上下文长度和输出内容。
Q：不同产品的同一项技能消耗一样吗？
不一定。即使业务名称相似，不同产品的业务路径、字段、MCP 能力和执行步骤也可能不同，因此同一类技能在不同产品中的畅算粒消耗可能不一样。
Q：模型怎么选更省畅算粒？
- 千问模型：默认开启思考模式，支持更长上下文，适合长周期持续对话和持续调优场景。
- GLM 模型：上下文相对更短，多轮后更易出现注意力衰减，但在复杂推理任务中常有优势，适合 ERP 复杂逻辑场景。
建议根据任务类型选择模型：长链路任务优先选择长上下文模型，规则推理任务优先测试推理强模型。
Q：日常使用怎么控制消耗？
建议从输入、会话和输出三处控制：
- 提问尽量结构化，明确目标、输入、约束和输出格式。
- 对话过长时，定期开新会话，并用“阶段摘要”承接上下文。
- 上传文件遵循“先小后大”，先用小样本验证，再放量执行。
- 增加输出长度约束，例如“控制在 200 字内”，避免无效长回复。
Q：为什么对话轮次越多，消耗越高？
大模型每轮请求通常会携带部分历史上下文。轮次越多，单次请求包含的信息越多，输入和输出总量都可能上升，因此畅算粒消耗会逐步增加。
实操建议：当任务进入新阶段时，先让 CClaw 总结关键结论，再开新会话继续执行。
Q：未执行成功的任务会扣除畅算粒吗？
畅算粒按实际使用流量计费。即使任务最终未执行成功，只要过程中产生了模型调用、上下文处理或工具调用，就可能产生消耗。
Q：一年快到期还没用完，续费后畅算粒会结转到下一年吗？
不会结转到次年。畅算粒按使用流量计费，到期未使用完的部分不做跨年结转。
Q：畅算粒是否绑定客户产品？更换产品后可以迁移吗？
畅算粒不和客户的具体产品绑定。例如客户 T+ 到期后重新开通好业财，畅算粒不按产品绑定关系限制使用。
Q：畅算粒余额以后会展示在畅龙虾左下角吗？
后续会增加跳转链接。当前建议在企业工作台中查看畅算粒余额和使用情况。
Skill 训练与问题复盘
Q：任务执行失败时，如何让 CClaw 自查自纠？
如果某个任务执行失败，不要只停留在“结果不对”，而是继续通过对话引导它分析：
- 失败发生在哪一步？
- 是数据输入问题、工具调用问题，还是指令约束不够明确？
- 如果重新执行，应该调整哪些前提条件？
这样做可以先把失败原因显性化，再针对原因优化提示词、技能文档或操作流程，让后续同类任务更稳定。
Q：如何把成功经验沉淀为稳定约束？
可以把高频成功步骤写进技能说明里，并补充以下内容：
- 输入格式
- 输出结构
- 必要检查步骤
- 禁止项或风险提示
对于容易出错的环节，建议增加明确的检查步骤，让后续执行更稳定。
功能迭代与技能通用性问题
Q：好业财龙虾目前不支持自动创建 BOM，缺少的功能需要等迭代吗？
是的。当前暂不支持的业务能力，会根据产品规划和场景优先级持续补充，近期迭代也会继续完善相关能力。
Q：不同产品之间的技能通用吗？
不同产品之间的技能通常不通用。例如好业财生成的技能，不建议直接复制到 T+ 产品中使用。
原因是各产品的业务路径、字段结构和底层 MCP 能力不同，技能需要基于对应产品的业务流程和 MCP 能力设计。