Models, Tools, Runtime Paths
Raydo가 models, tools, CLI workflows, 외부 진입점을 하나의 desktop workspace에 모으는 방식을 설명합니다.
Raydo는 이미 쓰고 있는 모든 tool을 대체하려는 제품이 아닙니다. 흩어진 진입점을 더 선명한 workspace 안으로 다시 끌어오는 제품입니다.
Model access
Raydo는 일반적인 model service와 호환 endpoint를 한곳에서 다룰 수 있습니다. 대부분의 사용자에게 중요한 것은 뒤에서 몇 가지 연결 방식이 돌아가는가가 아닙니다. 하나의 desktop에서 보고, 바꾸고, 쓸 수 있다는 점입니다.
Runtime paths
공개된 product story 안에서 이해해야 할 핵심 runtime paths는 세 가지입니다.
- Raydo에 내장된 OpenClaw runtime
- local Codex workflows
- local Claude Code workflows
이것들은 서로 떨어진 제품처럼 느껴지면 안 됩니다. 하나의 control surface 아래로 모여 있습니다.
Channels와 외부 진입점
Raydo는 일반적인 communication surface와 연결될 수 있습니다. 업데이트, 협업, 알림이 desktop 안에만 갇히지 않도록 하기 위해서입니다. 정확한 범위는 현재 product에 실제로 보이는 내용을 기준으로 보는 것이 맞습니다.
Feishu 연결: 앱 자격 증명과 사용자 승인
Feishu 연결에는 서로 다른 역할을 하는 두 단계의 설정이 있습니다.
- Channel settings의 App ID / App Secret은 앱 수준 자격 증명입니다. Feishu Open Platform 앱에서 가져오며, Feishu에 “어떤 앱이 연결을 시작하는지”를 알려줍니다. Raydo는 이 값을 사용해 OAuth를 시작하고, authorization code를 교환하고, access token을 갱신합니다.
- App Connections의 Connect account는 사용자 수준 승인입니다. 사용자가 브라우저에서 권한을 허용하면 Raydo가 그 계정에 허용된 Feishu 리소스를 사용할 수 있습니다. 승인 결과는 Raydo의 connection secret storage에서 관리되며
openclaw.json에는 쓰이지 않습니다.
권장 순서:
- Raydo의 Channel settings에 Feishu App ID / App Secret을 입력하고, Feishu 중국 서비스인지 Lark 글로벌 서비스인지 확인합니다.
- 같은 Feishu Open Platform 앱에 Raydo가 표시한 callback URL을 추가합니다. desktop 로컬 연결의 기본값은
http://localhost:1456/connections/feishu/oauth/callback입니다. - Raydo의 App Connections로 돌아가 Feishu를 선택하고 계정을 연결합니다.
- 브라우저 승인이 끝나면 Raydo로 돌아와 project, role, capability에 필요한 범위를 허용합니다.
Feishu가 redirect URL이 잘못되었다고 표시하면, Feishu Open Platform에 등록한 callback URL과 Raydo가 OAuth에 사용한 URL이 정확히 일치하지 않는 것입니다. protocol, host, port, path를 문자 단위로 확인하세요. 이 오류는 Feishu 쪽에서 발생하며, Raydo의 로컬 callback은 아직 승인 결과를 받지 못한 상태입니다.
MCP와 tool 연결
이미 MCP나 다른 local tools를 쓰고 있다면, Raydo는 설정과 연결 작업을 한곳으로 모아주는 방식으로 도움이 됩니다. 여러 file과 진입점에 흩어지지 않게 해줍니다.
왜 이 층이 중요한가
models는 바뀝니다. tools도 바뀝니다. team의 습관도 바뀝니다. Raydo는 그 아래 구성이 변해도 위쪽 workspace를 최대한 안정적으로 유지해, 사용자 경험이 덜 흔들리게 하려 합니다.