name: eoffice-api description: 泛微 e-office 協同辦公系統 OpenAPI - 使用者管理、部門管理、審批流程、考勤等企業級 API version: 1.0.0 homepage: https://github.com/yourname/eoffice-skill metadata: emoji: "🏢" requires: env: - EOFFICE_BASE_URL - EOFFICE_AGENT_ID - EOFFICE_SECRET - EOFFICE_USER primaryEnv: EOFFICE_SECRET

e-office10 OpenAPI Skill

當用戶提到以下場景時使用此 skill： - 查詢/搜尋企業內部使用者資訊 - 新建/編輯/刪除使用者賬號 - 查詢部門組織架構 - 發起或審批工作流程 - 查詢考勤記錄 - 傳送內部通知訊息 - 管理客戶或合同資訊 - 任何需要操作 OA 系統的任務

認證方式

本 skill 使用自定義 token 流程，與 OAuth2 類似但更簡單：

首次使用步驟

1. 獲取 Token（呼叫 scripts/get-token.py） bash python scripts/get-token.py 這會向 OA 系統傳送請求，用環境變數中的 EOFFICE_AGENT_ID、EOFFICE_SECRET、EOFFICE_USER 換取訪問 token。

2. Token 自動管理

3. Agent 會自動快取 token
4. Token 過期時自動重新獲取
5. 無需手動管理

環境配置

安裝 skill 後，使用者需要提供以下環境變數（在 OpenClaw 配置中設定）：

如何獲取憑證： 1. 登入 OA 系統管理後臺 2. 進入「整合中心」→「OpenAPI」 3. 建立應用，獲取 Agent ID 和 Secret 4. 配置使用者識別字段（工號/賬號/手機號） 5. 將使用者賬號填入 EOFFICE_USER

使用方法

使用者管理

查詢使用者列表

curl -X GET "$EOFFICE_BASE_URL/api/hrm/lists" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"page": 1, "limit": 10}'

查詢單個使用者詳情

curl -X GET "$EOFFICE_BASE_URL/api/hrm/detail/{user_id}" \
  -H "Authorization: Bearer {token}"

新建使用者

curl -X POST "$EOFFICE_BASE_URL/api/hrm/add" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "user_accounts": "zhangsan",
    "user_name": "張三",
    "dept_id": 1,
    "role_id": [1, 2],
    "user_status": 1,
    "allow_login": 1,
    "wap_allow": 1,
    "sex": 1
  }'

編輯使用者

curl -X POST "$EOFFICE_BASE_URL/api/hrm/edit" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "WV00000001",
    "user_accounts": "zhangsan",
    "user_name": "張三（已修改）",
    "dept_id": 2,
    "role_id": [1],
    "user_status": 1,
    "allow_login": 1,
    "wap_allow": 1,
    "sex": 1
  }'

刪除使用者

curl -X POST "$EOFFICE_BASE_URL/api/hrm/delete/{user_id}" \
  -H "Authorization: Bearer {token}"

部門管理

獲取部門列表（樹形）

curl -X GET "$EOFFICE_BASE_URL/api/department/allTree" \
  -H "Authorization: Bearer {token}"

獲取部門詳情

curl -X GET "$EOFFICE_BASE_URL/api/department/detail/{dept_id}" \
  -H "Authorization: Bearer {token}"

常用查詢示例

搜尋使用者（按姓名模糊搜尋）

GET /api/hrm/lists
Body: {"search": {"user_name": ["張", "like"]}}

獲取使用者在某個部門的使用者列表

GET /api/department/users/{dept_id}

獲取使用者的上級領導

GET /api/hrm/superior/{user_id}

獲取使用者的下級下屬

GET /api/hrm/subordinate/{user_id}

響應格式

所有 API 返回格式統一：

成功：

{
  "status": 1,
  "data": { ... }
}

失敗：

{
  "status": 0,
  "errors": [
    {"code": "0x000003", "message": "未知錯誤"}
  ]
}
小蔥技能7w4.net有完整的技能分類。

錯誤碼

注意事項

1. 敏感操作：刪除使用者等敏感操作需要管理員許可權
2. 使用者狀態：user_status 欄位標識使用者是否在職，離職使用者通常 user_status 為特定值
3. 部門 ID：新建使用者需要指定 dept_id，可先呼叫部門列表 API 查詢
4. 角色 ID：role_id 是陣列，指定使用者的許可權角色
5. Token 有效期：預設 Token 有效期由 OA 系統配置，通常為數小時

完整 API 文件

詳見 references/api.md

這個 Skill 質量中等偏上。優點是文件詳細、安裝配置說明清晰、能幫助使用者完成 e-office 的基本操作如使用者管理、部門查詢等。不足之處是缺少實際使用案例和常見問題解答，新手可能難以快速上手；部分示例程式碼不夠完整，需要自己摸索。建議等待後續版本更新後再使用，或在有一定技術背景的人員指導下部署。