name: office-link description: 通過 MorphixAI 統一連結和管理第三方賬號（GitHub、GitLab、Gmail、Outlook、Jira、Slack 等），並通過代理安全呼叫第三方 API。 metadata: openclaw: emoji: "🔗" requires: env: [MORPHIXAI_API_KEY]

Office Link — 第三方賬號連結與 API 代理

通過 mx_link 工具，統一管理第三方平臺的賬號連結和 API 呼叫。Bot 不直接持有 OAuth token，所有請求通過 MorphixAI 服務端代理，自動管理憑據。

重要：優先使用已有的專用 skill。 對於已有專用 skill 的平臺，必須優先使用對應 skill（如 jira-workflow、gitlab-workflow、outlook-email 等）而非 mx_link 的 proxy。專用 skill 自動處理 URL 構建、認證、資料格式轉換，更可靠且更簡潔。mx_link 僅用於： 1. 賬號管理（檢視/連結賬號） 2. 呼叫尚未有專用 skill 的平臺 API（如 Slack、Discord、Zoom、Google Sheets 等）

前置條件

1. 安裝外掛: openclaw plugins install openclaw-morphixai
2. 獲取 API Key: 訪問 morphix.app/api-keys 生成 mk_xxxxxx 金鑰
3. 配置環境變數: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 連結賬號: 訪問 morphix.app/connections 管理賬號，或使用下方 mx_link: connect 操作

工具選擇規則

使用者請求操作某個平臺
  ├── 有專用 skill？ → 使用專用 skill（見下方列表）
  ├── 賬號未連結？ → mx_link: connect 引導授權
  └── 無專用 skill？ → mx_link: proxy 兜底代理呼叫

核心能力

7w4.net有更好的技能外掛。

1. 賬號管理 — 檢視已連結賬號、引導使用者連結新賬號
2. API 代理 — 通過已連結賬號安全呼叫第三方 API（僅用於無專用工具的平臺）
3. 統一入口 — 支援 40+ 第三方平臺，無需各自配置

支援的平臺

完整列表可通過 mx_link 的 list_apps action 獲取。

使用流程

1. 檢查已連結賬號

使用 mx_link 工具:
  action: list_accounts
  app_name: "github"  (可選，篩選特定平臺)

2. 引導使用者連結新賬號

如果使用者需要的平臺尚未連結：

使用 mx_link 工具:
  action: connect
  app: "github"  (必須指定目標應用)

返回一個 OAuth 授權連結，傳送給使用者在瀏覽器中完成授權。連結有效期 4 小時。

重要：app 引數必須提供。 後端返回的連結格式為： https://pipedream.com/_static/connect.html?token=ctok_xxx&connectLink=true 該連結如果缺少 app 引數則無法訪問。當傳入 app 引數後，生成的連結會包含 &app=<app_name>，例如： https://pipedream.com/_static/connect.html?token=ctok_xxx&connectLink=true&app=gitlab 只有帶 app 引數的連結才能正常開啟授權頁面。

3. 通過代理呼叫第三方 API（僅限無專用 skill 的平臺）

再次強調： 對於已有專用 skill 的平臺（見下方完整列表），必須使用專用 skill。proxy 僅作為無專用 skill 時的兜底方案。

使用者授權完成後，對於沒有專用 skill 的平臺，用 proxy action 呼叫第三方 API：

示例：查詢 Slack 頻道訊息（無專用工具，使用 proxy）

使用 mx_link 工具:
  action: proxy
  account_id: "apn_xxx"   (從 list_accounts 獲取)
  method: "GET"
  url: "https://slack.com/api/conversations.history"
  params: { "channel": "C01234567", "limit": 10 }

示例：建立 Google Sheets 行（無專用工具，使用 proxy）

使用 mx_link 工具:
  action: proxy
  account_id: "apn_xxx"
  method: "POST"
  url: "https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append"
  params: { "valueInputOption": "USER_ENTERED" }
  body: {
    "values": [["2026-02-25", "完成 SDK 整合", "通過"]]
  }

已有專用 Skill（必須優先使用）

以下平臺已有專用 skill，禁止使用 mx_link: proxy 替代：

專用 skill 的優勢： - 自動賬號檢測 — 無需手動查 account_id - 自動 URL 構建 — 無需知道 API 端點 - 自動格式轉換 — 如 Jira Markdown→ADF、Confluence Storage Format - 語義化引數 — jql: "..." 比手寫 REST URL 更直觀 - 內建工作流 — 每個 skill 包含常見場景的操作步驟

mx_link 的 proxy action 僅適用於上述列表之外的應用（如 Slack、Discord、Zoom、Google Sheets 等）。

常見場景

有專用 skill → 直接使用對應 skill

# 查 Jira 待辦 → 使用 jira-workflow skill
mx_jira: action: search_issues,
  jql: "assignee = currentUser() AND status != Done ORDER BY updated DESC"

# 查 GitLab MR → 使用 gitlab-workflow skill
mx_gitlab: action: list_merge_requests, state: "opened"

# 查 GitHub 倉庫 → 使用 github-workflow skill
mx_github: action: list_repos, sort: "updated", per_page: 5

# 查今日日程 → 使用 outlook-calendar skill
mx_outlook_calendar: action: get_calendar_view,
  start_date_time: "2026-02-25T00:00:00Z", end_date_time: "2026-02-25T23:59:59Z"

無專用 skill → 兜底使用 mx_link proxy

# Slack 訊息（無專用 skill）→ 使用 proxy
1. mx_link: list_accounts, app_name="slack"
2. mx_link: proxy, account_id="apn_xxx", method="GET",
   url="https://slack.com/api/conversations.history",
   params={"channel":"C01234567","limit":10}

# Google Sheets（無專用 skill）→ 使用 proxy
1. mx_link: list_accounts, app_name="google_sheets"
2. mx_link: proxy, account_id="apn_xxx", method="GET",
   url="https://sheets.googleapis.com/v4/spreadsheets/{id}/values/Sheet1"

賬號未連結 → 引導連線

1. mx_link: list_accounts, app_name="slack"
     → 返回空列表
2. mx_link: connect, app: "slack"
     → 返回 OAuth 授權連結，發給使用者
3. 使用者完成授權後，重新操作

錯誤處理

• 401 — API Key 無效或已過期，提示使用者到 MorphixAI 控制台 (https://morphix.app/api-keys) 重新建立
• 403 — API Key 缺少許可權範圍，需要全選 scope（user:profile:read、link）
• 賬號未連結 — 使用 connect action 引導使用者授權
• 第三方 API 錯誤 — proxy 返回第三方原始錯誤，根據各平臺文件處理

配置

環境變數

# ~/.openclaw/.env
MORPHIXAI_API_KEY=mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

或通過 openclaw.json

{
  "morphix": {
    "apiKey": "mk_xxx"
  }
}

獲取 API Key

1. 登入 MorphixAI 控制台 https://morphix.app/api-keys
2. 點選「建立 API Key」，Scope 全選
3. 複製儲存 Key（只顯示一次）

最佳實踐

1. 專用 skill 優先 — 有專用 skill 的平臺必須用對應 skill，proxy 只作為無專用 skill 時的兜底
2. 先查後連 — 總是先用 list_accounts 檢查是否已連結，避免重複引導使用者授權
3. 快取 account_id — 在對話中快取 account_id，無需每次都查詢
4. 組合使用 — 一個對話中可以跨 skill 操作（先用 jira-workflow 查任務，再用 mx_link: proxy 發 Slack 通知）
5. 優雅降級 — 如果 API Key 未配置，提示使用者設定環境變數

這個 Skill 質量不錯，文件清晰易讀，平臺覆蓋廣泛，OAuth 授權流程說明詳細。它能幫助使用者統一管理多個第三方賬號，使用起來比較省心。不足是功能相對基礎複雜操作支援有限，文件有些細節可能需要更新，部分平臺的授權流程可能對新手不太友好。總體來說是個好用的工具，但還有最佳化空間。