よくある質問
ディープリンクプロトコル
機能説明
Olenro は olenro:// ディープリンクプロトコルをサポートしており、リンクからワンクリックで設定をインポートできます。
使用シーン：
- チーム内での設定共有
- チュートリアルでのワンクリック設定
- デバイス間の素早い同期
オンライン生成ツール
Olenro はオンラインのディープリンク生成ツールを提供しています：
アクセス先：https://olenro.com/deplink.html
使用方法
- 上記の Web ページを開く
- インポートタイプを選択（プロバイダー/MCP/Prompt）
- 設定情報を入力
- 「リンクを生成」をクリック
- 生成されたディープリンクをコピー
- 他の人に共有するか、別のデバイスで使用
プロトコル形式
V1 プロトコル
URL パラメータ形式で、読みやすく生成しやすい形式です：
olenro://v1/import?resource={type}&app={app}&name={name}&...共通パラメータ：
| パラメータ | 必須 | 説明 |
|---|---|---|
resource | はい | リソースタイプ：provider / mcp / prompt / skill |
app | はい | アプリタイプ：claude / codex / gemini / opencode / openclaw |
name | はい | 名前 |
プロバイダーパラメータ（resource=provider）：
| パラメータ | 必須 | 説明 |
|---|---|---|
endpoint | いいえ | API エンドポイントアドレス（カンマ区切りで複数 URL 対応） |
apiKey | いいえ | API キー |
homepage | いいえ | プロバイダー公式サイト |
model | いいえ | デフォルトモデル |
haikuModel | いいえ | Haiku モデル（Claude のみ） |
sonnetModel | いいえ | Sonnet モデル（Claude のみ） |
opusModel | いいえ | Opus モデル（Claude のみ） |
notes | いいえ | メモ |
icon | いいえ | アイコン |
config | いいえ | Base64 エンコードされた設定内容 |
configFormat | いいえ | 設定形式：json / toml |
configUrl | いいえ | リモート設定 URL |
enabled | いいえ | 有効にするかどうか（ブール値） |
usageScript | いいえ | 使用量クエリスクリプト |
usageEnabled | いいえ | 使用量クエリを有効にするか（デフォルト true） |
usageApiKey | いいえ | 使用量クエリ専用 API Key |
usageBaseUrl | いいえ | 使用量クエリ専用アドレス |
usageAccessToken | いいえ | 使用量クエリアクセストークン |
usageUserId | いいえ | 使用量クエリユーザー ID |
usageAutoInterval | いいえ | 自動クエリ間隔（分） |
プロンプトパラメータ（resource=prompt）：
| パラメータ | 必須 | 説明 |
|---|---|---|
content | はい | プロンプト内容 |
description | いいえ | 説明 |
enabled | いいえ | 有効にするかどうか（ブール値） |
MCP パラメータ（resource=mcp）：
| パラメータ | 必須 | 説明 |
|---|---|---|
apps | はい | アプリリスト（カンマ区切り、例：claude,codex,gemini,opencode） |
config | はい | MCP サーバー設定（JSON 形式） |
enabled | いいえ | 有効にするかどうか（ブール値） |
Skill パラメータ（resource=skill）：
| パラメータ | 必須 | 説明 |
|---|---|---|
repo | はい | リポジトリ（形式：owner/name） |
directory | いいえ | ディレクトリパス |
branch | いいえ | Git ブランチ |
例：
olenro://v1/import?resource=provider&app=claude&name=My%20Provider&endpoint=https%3A%2F%2Fapi.example.com&apiKey=sk-xxxインポートタイプの例
プロバイダーのインポート
olenro://v1/import?resource=provider&app=claude&name=My%20Provider&endpoint=https%3A%2F%2Fapi.example.com&apiKey=sk-xxxMCP サーバーのインポート
olenro://v1/import?resource=mcp&apps=claude,codex&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-fetch%22%5D%7D&name=mcp-fetchPrompt プリセットのインポート
olenro://v1/import?resource=prompt&app=claude&name=%E4%BB%A3%E7%A0%81%E5%AE%A1%E6%9F%A5&content=%23%20%E8%A7%92%E8%89%B2%0A%E4%BD%A0%E6%98%AF%E4%B8%80%E4%B8%AA%E4%B8%93%E4%B8%9A%E7%9A%84%E4%BB%A3%E7%A0%81%E5%AE%A1%E6%9F%A5%E4%B8%93%E5%AE%B6Skill のインポート
olenro://v1/import?resource=skill&name=my-skill&repo=owner/repo&directory=skills/my-skill&branch=mainディープリンクの生成
手動生成
- パラメータを準備
- V1 プロトコル形式で URL を組み立て
- 特殊文字を URL エンコード
例：
const params = new URLSearchParams({
resource: 'provider',
app: 'claude',
name: 'My Provider',
endpoint: 'https://api.example.com',
apiKey: 'sk-xxx'
});
const url = `olenro://v1/import?${params.toString()}`;オンラインツール
Olenro 公式のオンラインディープリンク生成ツールを使用するとより便利です。
ディープリンクの使用
リンクのクリック
ブラウザや他のアプリでディープリンクをクリック：
- システムが Olenro を開くかどうかを確認
- 確認後、Olenro が起動
- インポート確認ダイアログを表示
- インポートを確認
インポートの確認
インポート前に確認ダイアログが表示され、以下が含まれます：
- インポートタイプ
- 設定のプレビュー
- 確認/キャンセルボタン
セキュリティ上の注意：信頼できるソースからの設定のみインポートしてください。
プロトコルの登録
自動登録
Olenro のインストール時に olenro:// プロトコルが自動登録されます。
手動登録
プロトコルが正しく登録されていない場合：
macOS： アプリを再インストールするか、以下を実行：
/usr/bin/open -a "Olenro" --args --register-protocolWindows： アプリを再インストールするか、レジストリを確認：
HKEY_CLASSES_ROOT\olenroLinux：
.desktop ファイルの MimeType 設定を確認。
セキュリティに関する考慮事項
機密情報
ディープリンクには機密情報（API Key など）が含まれる場合があります：
- API Key を含むリンクを公開の場で共有しない
- 共有前に機密情報を削除または置換
- 安全なチャネルでリンクを送信
ソースの確認
インポート前に Olenro は以下を実行します：
- データ形式の検証
- 設定のプレビュー表示
- ユーザーの確認を要求
悪意のあるリンクからの防護
Olenro は以下を確認します：
- データ形式が正当か
- 必須フィールドが揃っているか
- 設定値が妥当な範囲内か
サンプルリンク
例：Claude プロバイダーのインポート
olenro://v1/import?resource=provider&app=claude&name=Test%20Provider&apiKey=sk-xxx&endpoint=https%3A%2F%2Fapi.example.com例：MCP サーバーのインポート
olenro://v1/import?resource=mcp&name=mcp-fetch&apps=claude,codex,gemini&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-fetch%22%5D%7Dトラブルシューティング
リンクが開けない
確認事項：
- Olenro がインストールされているか
- プロトコルが正しく登録されているか
- リンクの形式が正しいか
インポートに失敗する
考えられる原因：
- Base64 エンコードのエラー
- JSON 形式のエラー
- 必須フィールドの不足
解決方法：
- 元の JSON 形式を確認
- Base64 エンコードをやり直す
- すべての必須フィールドが存在することを確認