Raydo
控制与集成

模型、工具与运行方式

介绍 Raydo 如何把模型、工具、CLI 与外部入口组织到同一个桌面工作台里。

Raydo 的思路不是替换掉你已经在用的所有工具,而是把这些入口重新收束到一个更清楚的工作台里。

模型接入

Raydo 可以统一管理常见模型服务与兼容接口。对用户来说,重点不是背后接了多少种方式,而是你能在一个地方完成查看、切换和使用。

运行方式

当前公开文档里,可以重点理解三类常见运行方式:

  • Raydo 内置的 OpenClaw runtime
  • 本地 Codex 工作流
  • 本地 Claude Code 工作流

它们不是彼此割裂的几套产品,而是被收进同一个桌面控制面里。

Channels 与外部入口

Raydo 可以连接常见的外部沟通入口,让消息、通知或协作关系不必一直停留在桌面内部。具体可用范围,以当前版本界面显示为准。

飞书 / Lark 连接:一个入口,两种服务区域

Raydo 里把飞书中国大陆版和 Lark 全球版收在同一个入口里。用户不需要理解两套能力,只需要在配置时选对自己的工作区版本:

  • 飞书 中国大陆:使用 feishu.cn 相关授权与 API 域名。
  • Lark 全球:使用 larksuite.com 相关授权与 API 域名。

这个选择只决定 Raydo 连接哪个平台域名,不影响 Raydo 里的使用方式。

飞书 / Lark 接入通常有两层配置,解决的是两件不同的事:

  • Channel settings 里的 App ID / App Secret 是应用级钥匙。它来自飞书开放平台里的应用,用来告诉飞书“是哪一个应用在发起连接”。Raydo 会用这组钥匙启动 OAuth、换取授权码和刷新访问令牌。
  • App Connections 里的 Connect account 是用户级授权。用户在浏览器里同意授权后,Raydo 才能代表这个账号读取已允许的飞书资源。授权结果由 Raydo 的连接密钥存储管理,不会写进 openclaw.json

推荐操作顺序:

  1. 在 Raydo 的 Channel settings 里选择服务区域:飞书中国大陆版或 Lark 全球版。
  2. 在对应开放平台创建应用,填写 App ID / App Secret。
  3. 在同一个应用里,添加 Raydo 显示的回调地址。桌面本地连接默认是 http://localhost:1456/connections/feishu/oauth/callback
  4. 回到 Raydo 的 App Connections,选择飞书 / Lark 并点击连接账号。
  5. 浏览器完成授权后,回到 Raydo 给项目、角色或后续能力授予可用范围。

如果授权页提示“重定向 URL 有误”,通常表示对应开放平台里登记的回调地址与 Raydo 发起授权时使用的地址不完全一致,或者服务区域选错了。请重点检查协议、域名、端口和路径是否逐字一致。这个错误发生在飞书 / Lark 侧,Raydo 本地回调还没有收到授权结果。

MCP 与工具接入

如果你已经在使用 MCP 或其他本地工具,Raydo 的价值在于把这些配置和连接面收拢起来,而不是继续分散在不同文件和不同入口里。

为什么这层能力重要

模型会变,工具会变,团队习惯也会变。Raydo 试图保持稳定的,是上层的工作台体验:无论底下接的是哪种模型、哪种工具、哪种运行方式,用户看到的入口都应该尽量一致。