\---

name: Claw\_OpenWebUI\_API

slug: claw-openwebui-api

author: kuanlin.huang

version: 1.0.3

description: |

整合 Open WebUI RAG 知識庫 API，讓 OpenClaw 能自動上傳文件和查詢知識庫。

triggers:

• "openwebui"
• "rag"
• "知識庫"
• "上傳文件"
• "搜尋知識庫"

metadata:

openclaw:

emoji: "🦞"

requires:

env: \["OPENWEBUI\_URL", "OPENWEBUI\_API\_KEY"]

bins: \["python3", "requests"]

install:

• id: pip

kind: pip

package: requests

label: Install requests library

\---

Claw\_OpenWebUI\_API

讓 OpenClaw 調用 Open WebUI 的 RAG 知識庫 API。

功能

• 📤 上傳文件到知識庫
• 🔍 搜尋知識庫
• 💬 對話時自動引用知識庫
• 📊 列出知識庫內容

前置需求

1. Open WebUI 已安裝並運行
2. 已建立知識庫
3. 取得 API Token

安裝

# 安裝技能
git clone https://github.com/你的帳號/Claw\\\_OpenWebUI\\\_API.git \\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API

設定

環境變數（必須設定）

# 必需設定環境變數
export OPENWEBUI\\\_URL="http://你的伺服器IP:3000"
export OPENWEBUI\\\_API\\\_KEY="你的API\\\_Token"

取得 API Token

1. 登入 Open WebUI
2. 進入設定 → 帳號
3. 產生 API Token

或設定檔

編輯 \\\~/.openclaw/openclaw.json：

{
  "skills": {
    "Claw\\\_OpenWebUI\\\_API": {
      "url": "http://192.168.0.176:3000",
      "api\\\_key": "your\\\_api\\\_token"
    }
  }
}

使用方式

🚀 OpenClaw 指令（自然語法）

安裝技能後，可以直接用自然語法呼叫：

# 設定環境變數（只需設定一次）
小蝦，設定 OPENWEBUI\\\_URL 為 http://127.0.0.1:3000
小蝦，設定 OPENWEBUI\\\_API\\\_KEY 為 your-jwt-token

# 上傳檔案到知識庫
小蝦，上傳 note.txt 到知識庫 test3
小蝦，把 report.pdf 上傳到知識庫 mydocs

# 列出知識庫
小蝦，列出所有知識庫
小蝦，有哪些知識庫？

# 查詢檔案
小蝦，查詢上傳的檔案列表

# 對話（自動引用知識庫）
小蝦，用 Qwen3-4B 問關於 test3 的內容

📝 Bash 指令（直接執行）

# 設定環境變數
export OPENWEBUI\\\_URL="http://127.0.0.1:3000"
export OPENWEBUI\\\_API\\\_KEY="your-jwt-token"

# 列出知識庫
\\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/claw-openwebui.sh list-knowledge

# 上傳檔案到知識庫（需指定知識庫名稱）
\\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/claw-openwebui.sh upload-rag /path/to/file.txt test3

# 發送聊天
\\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/claw-openwebui.sh chat "Qwen3-4B-Instruct-2507-4bit" "你好"

📜 Python 指令（可選）

# 上傳 PDF 文件
python3 \\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/scripts/upload.py --file /path/to/document.pdf

# 上傳多個文件
python3 \\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/scripts/upload.py --file file1.pdf --file file2.docx

搜尋知識庫

python3 \\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/scripts/search.py --query "關於 OpenClaw 的設定"

對話（知識庫增強）

python3 \\\~/.openclaw/workspace/skills/Claw\\\_OpenWebUI\\\_API/scripts/chat.py --message "如何安裝 OpenClaw?"

API 端點

架構

Claw\\\_OpenWebUI\\\_API/
├── SKILL.md
├── scripts/
│   ├── upload.py      # 上傳文件
│   ├── search.py      # 搜尋知識庫
│   ├── chat.py        # 對話+知識庫
│   └── list\\\_files.py  # 列出檔案
└── README.md

範例

Python 程式碼

import requests

OPENWEBUI\\\_URL = "http://192.168.0.176:3000"
API\\\_KEY = "your\\\_token"

headers = {
    "Authorization": f"Bearer {API\\\_KEY}"
}

# 搜尋知識庫
def search\\\_knowledge(query):
    response = requests.post(
        f"{OPENWEBUI\\\_URL}/api/v1/rag",
        headers=headers,
        json={"query": query}
    )
    return response.json()

# 上傳檔案
def upload\\\_file(file\\\_path):
    with open(file\\\_path, 'rb') as f:
        files = {'file': f}
        response = requests.post(
            f"{OPENWEBUI\\\_URL}/api/v1/files/upload",
            headers=headers,
            files=files
        )
    return response.json()

常見問題

Q: 需要認證嗎？

A: 是的，需要從 Open WebUI 取得 API Token

Q: 支援哪些檔案格式？

A: PDF、Word、Excel、PPT、TXT、Markdown 等

Q: 如何取得 API Token？

A: 登入 Open WebUI → 設定 → 帳號 → API Token

授權

MIT License

\---

Author: kuanlin.huang

Version: 1.0.3