常见问题

产品基础

由界是什么？

由界（YojeX）是一款本地 AI Agent 安全沙箱管理平台。它让你能够一键安装、运行主流 AI Agent，同时通过由界沙箱技术将每个 Agent 与你的真实系统环境隔离，保护你的文件和数据不受 Agent 的意外影响。

由界支持哪些操作系统？

由界支持哪些语言？

目前支持简体中文和英文，可在"用户与设置"中随时切换。

怎么登录由界？

由界当前仅支持手机号 + 短信验证码登录。输入手机号，点击"获取验证码"，收到短信后填入验证码即可登录。首次登录自动完成注册，无需单独注册。

怎么用

由界支持哪些 AI Agent？

由界 Agent 市场持续更新，收录主流 AI Agent 模板。具体列表请打开由界客户端查看最新 Agent 市场。

怎么做安全配置？

详细参见安全配置页中关于文件、网络等相关的说明。

Skills（技能）是什么？

Skills 是为 Agent 扩展能力的功能模块，例如：长期记忆、任务规划、自我调试、文件管理、浏览器自动化等。由界兼容 OpenClaw / QClaw 技能生态，内置常用 Skills，也支持自定义扩展。在我的 Agent 的"Agent 配置"标签中安装和管理。

Agent 怎么访问我的文件？

在我的 Agent → 安全设置 → 文件权限中，将你希望 Agent 访问的目录添加到白名单，并设置只读或读写权限，Agent 即可访问这些目录。白名单外的目录对 Agent 不可见。

Agent 生成的文件在哪里？

每个 Agent 都有独立的「专属电脑」，Agent 生成的文件都保存在里面，与你的真实文件系统隔离。点击我的 Agent 顶部的"XX 的电脑"按钮，或在底栏图标上右键 → 访问 XX 的电脑，即可浏览和导出文件。

可以同时运行多个 Agent 吗？

可以。由界支持多个 Agent 并行运行，每个在独立沙箱中运行，互不影响。在"仪表盘"中可以监控所有运行中 Agent 的资源占用情况。

OpenClaw 默认使用哪个大模型？能换回来吗？

OpenClaw 默认使用**那歌（Nagara）**大模型。如果你通过与 OpenClaw 对话、修改配置文件等方式将模型切换为其他自定义大模型，目前暂不支持通过由界界面恢复回那歌模型，请避免随意修改 OpenClaw 的模型配置。

如何配置 Agent 的模型？

在我的 Agent → Agent 配置标签中，选择由界自带的模型。这里的配置与你的系统环境隔离，仅对当前 Agent 可见。也可以自定义配置。

如何更新到最新版本？

当有新版本时，左侧导航栏顶部会显示更新提示。也可以在"用户与设置 → 关于由界 → 检查更新"手动检查。

更新会清除我的 Agent 数据吗？

不会。由界版本更新只升级程序本身，不影响你的 Agent 配置和专属电脑数据。

出了问题怎么办

macOS 上安装完成后，沙箱功能不工作

macOS 需要完成系统权限授权才能启用沙箱。首次启动时由界会引导你依次授权：守护进程服务、系统扩展、完全磁盘访问权限、网络代理、辅助功能。请确保每一步都已正确完成。详见：下载与安装 → macOS 系统权限授权

登录时收不到短信验证码

1. 确认手机号输入正确（无多余空格）
2. 等待 60 秒后重新发送
3. 检查手机是否屏蔽了该号码的短信
4. 尝试切换网络环境（Wi-Fi / 移动数据）

Agent 安装卡住不动

1. 检查网络连接是否正常
2. 点击进度旁的"重试"按钮
3. 如使用网络代理，在"用户与设置 → 更多"中确认代理配置正确
4. 等待几分钟后重试

Agent 启动后立即停止

在我的 Agent → 控制台标签查看错误日志，根据错误信息排查：

• Permission denied：安全设置中未开放 Agent 需要的目录权限
• Port already in use：已有同类 Agent 在运行，停止后重试
• 内存不足：关闭其他运行中的 Agent 后重试

Agent 无法联网

在我的 Agent → 安全设置 → 网络权限中检查当前配置。如果开启了"拦截本地网络"但 Agent 需要访问网络服务，请根据实际需求调整设置。

由界打开后白屏或闪退

1. 完全退出由界，重新启动
2. 重启计算机后再次尝试
3. 卸载后重新安装（用户数据和 Agent 配置不会丢失）

Agent 如何升级？

不同 Agent 的升级方式有所不同：

• OpenClaw：不支持通过 Web UI 升级，请在由界客户端中找到对应 Agent，通过由界界面执行升级。
• 其他类型的 Agent：是否支持在 Agent 应用内自行升级，取决于该 Agent 自身的设计。如果 Agent 内不支持升级，请回到由界界面操作升级。

如果在由界界面中未看到 Agent 的升级入口，说明后台尚未推送新版本，请耐心等待。

macOS 如何卸载由界？

1. 打开 访达（Finder） → 应用程序，找到由界（KongurBox）
2. 右键 → 显示包内容
3. 依次进入 Contents → SharedSupport → application
4. 双击运行 KongurBoxUninstall.app 完成卸载

积分会员权益与增量包的关系是怎么样的？

• 用户可以选择合适自己的会员进行订阅，在会员权益积分不够使用时，可以按自己需求叠加购买对应会员等级的增量包

积分扣减优先级是怎么样的？

1. 最先扣除注册赠送的积分
2. 然后扣除每日登陆赠送的积分
3. 然后扣除系统赠送的积分（如有多个，过期时间距离现在越近的，更优先扣除）
4. 然后扣除增量包（如有多个，过期时间距离现在越近的，更优先扣除）
5. 最后扣除会员权益积分

还有其他问题怎么办？

• 查看 故障排除 获取更多技术问题解决方案
• 在由界客户端"用户与设置 → 更多 → 提交反馈"联系我们