常见问题FAQ

遇到问题先来这里找答案，涵盖产品基础、积分消耗、故障排查等核心问题。

5.1产品基础与版本选择

1. EasyClaw有哪些版本？怎么选？

2. 国内版和海外版有什么区别？能共存吗？

• 模型差异： 国内版支持国产头部大模型（DeepSeek、千问等）；海外版支持海外主流模型（Claude/GPT/Gemini等）。
• 无法共存： 不能同时安装。安装目录相同，安装第二款会直接覆盖第一款。

详细对比见下图

3. 桌面版是本地部署吗？和云端版有何差异？

是的，桌面版为本地部署。用户文件、记忆、配置全在本地，不上传云端，数据安全性极高。

差异总结： 本地版Agent运行在您的电脑上，能操控电脑，但您关机它就下班；云端版运行在云服务器上，24小时待命，但无法操控您本地的电脑文件。

对比图如下所示

4.桌面版和Bot版有什么区别？

5.2使用问题与积分规则

1. 如何切换模型？

• 桌面版： 对话框右下角点击当前模型名称 → 选择新模型。
• 云端版： 发送指令 /model模型名（如 /model claude-sonnet-4.6）。

注意：不同渠道的模型设置不互通，飞书、Telegram需分别独立设置。

2.积分和Token是什么关系？

• 积分：EasyClaw的通用计价单位，使用任何模型都消耗积分
• Token：模型服务商的计量单位。如果你接入了自定义API Key，则消耗你自己账户的Token + EasyClaw的操作积分

3.不同积分有什么区别，积分会过期吗？

• ✅ 购买的积分累积不清零，只要续费就继续有效，不会当月未用完即作废
• ⚠️ 每天赠送的 200积分当天到期，未用完不累计

4. 积分消耗太快怎么办？

您可以采取以下措施降低消耗：

• 立即见效： 切换使用低倍率模型（如Qwen 3.5 Plus 0.6x）；定期发送 /new 清空对话历史（建议每10-20轮执行一次）；将复杂任务拆解为小步骤。
• 长期省钱： 配置自定义API Key（对话将不消耗平台积分）。
• 扩展阅读： Token降本三大技巧，告别龙虾天价消耗

5. 使用自定义API还扣积分吗？

对话类请求： 0积分。
仍扣积分项： browser-use（浏览器控制）、computer-use（电脑控制）、图像生成、语音转写等调用官方底层的服务。

6. 积分能退款或转移吗？

付费后不支持退款。但V1.3.23及以上版本支持在 桌面版 ↔ 企业版 之间进行积分转移。

7. 如何取消自动续费订阅？

1

打开账单与用量

悬停右上角的积分显示区域，点击弹出菜单中的「账单与用量」。

2

点击管理

进入账单与用量页面后，找到你当前的订阅套餐，点击右侧的「管理」按钮。

3

点击更改套餐

在订阅管理页面中，点击「更改套餐」按钮。

4

点击确认降级

选择「确认降级」。取消成功后，你的订阅将在当前计费周期结束时停止续费。

需要帮助？如果在取消订阅过程中遇到任何问题，请联系支持团队：support@easyclaw.com

8.会员比普通用户多哪些权益？

• 额度：每月等额的积分补贴
• 优先级：任务处理优先级更高，支持购买更多积分
• 性价比：推荐「年度会员」，是最实惠的选择

5.3安装与数据迁移

1. Mac安装后提示"无法打开"？

解决办法： 进入Mac的「系统设置」 → 「隐私与安全性」 → 「安全性」 → 点击 "仍要打开"。或者按住 Control 键点击应用图标进行打开。
注意：M系列芯片请下载ARM版，Intel芯片请下载Intel版。

2. 换电脑/重装系统如何迁移数据？

重要提醒：渠道配置需重新设置，积分和套餐无法手动迁移。云端备份仅保留60天，会员到期后数据会清除。

5.4核心功能操作

1.如何配置飞书 / 其他远程渠道？

点击界面左侧「手机远程」→ 选择渠道 → 扫码或按提示连接。目前推荐飞书，接入体验最完整。

2.如何切换模型或接入自己的API Key？

在对话框右上角点击「模型切换」即可实时切换模型。如需接入自定义API，点击「添加自定义模型」（需1.3.24及以上版本）。

3.为什么有时候执行特别慢？

5.5飞书渠道与多Agent架构

1. 使用个人飞书账号还是企业账号注册机器人？

- 个人账号：可以创建机器人，能加入自己的群，个人用完全够用
- 企业账号：权限范围覆盖整个企业空间，能加入他人群
- 结论：个人用、自己建群 → 个人账号完全够用

2. 飞书里如何新建对话（防止上下文太长变慢）？

直接告诉Agent："新建对话" 或 "重置上下文"。Agent确认后即可重新开始。高级用户也可在 SOUL.md 中配置自动压缩规则（每10条消息执行一次记忆压缩）。

3. 一个对话框 = 一个Agent吗？

不完全一样。Agent 是有自己人格、记忆、技能配置的AI实例；而 对话框 是跟同一个Agent的一段对话历史（Session）。想要真正不同的工作流，需要配置多个Agent并分别绑定不同飞书应用。

4. 多Agent架构是怎么运作的？

在Multi-Agent架构中，拥有一只主Agent（Boss Agent）负责统筹调度。Boss会将任务分配给专门的 Sub-Agent（子数字员工）。子员工完成后汇报给主Agent，最后由主Agent统一回复用户。

5. 想让主Agent调度后，结果直接在飞书对话框生成，能实现吗？

可以，但结果必须由Boss Agent回复给你，不是子Agent直接回复。
流程：你 → Boss Agent → sessions_spawn启动子Agent → 子Agent返回结果给Boss → Boss在飞书对话框回复你

5.6系统环境问题

1.Mac用户下载哪个版本？

• Apple M系列芯片（M1/M2/M3/M4）→ 下载 ARM版
• Intel芯片 → 下载 Intel版

如不确定：Apple菜单 → 关于本机，查看「处理器」字段。

2.长时间运行自动化任务的注意事项

• 必须保持电源连接，防止进入睡眠模式（长任务中途休眠会中断）
• 开启高性能模式，并关闭系统的「节能」或「监控」自动关机功能

3.版本更新会影响哪些内容？

小版本更新通常会带来新功能、Bug修复，以及Skills和Memory文件的优化。更新后请注意检查MEMORY.md和已安装的Skills是否正常工作。

如遇异常，联系官方支持：support@easyclaw.com

5.7故障排查与开票服务

1. 飞书机器人不回复怎么办？

请按以下步骤排查：

• 软件内测试： 在EasyClaw桌面端直接发消息，能回复吗？
  如果不能，输入 /status 检查积分或Gateway状态。
  如果能，说明问题在于飞书连接
• 检查连接： 在对话框输入「检查飞书连接」。
• 常见阻碍： 电脑进入休眠/睡眠状态（建议Mac安装Amphetamine，Win关闭休眠）；或积分已耗尽。

2. 报错 "LLM request timed out" 怎么办？

这通常是因为模型服务器过载、上下文太长或任务太复杂。
最有效的解决办法： 发送 /new 清空历史对话。或尝试切换至低延迟模型（如DeepSeek, Kimi, Qwen），并将复杂任务拆解为小步骤下发。