메뉴
開物 Kaiwu CLI（kw）的安裝、認證與設定參考，以及 search/extract/credits 的完整工作流程。設定環境、遇到 kw 找不到或認證問題時的參考。Install, auth, and configure the Kaiwu CLI (kw).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
用開物 Kaiwu 建構正式整合的最佳實踐 — 額度管理、查詢技巧、繁簡策略、錯誤處理、何時用 search vs extract。要把開物接進 agent / 應用前先讀這個。Reference for production-ready Kaiwu integrations.
查詢開物 Kaiwu API 帳戶的剩餘額度、已用量與重置時間。在大量搜尋/抓取前或遇到額度不足錯誤時使用。Check remaining Kaiwu API credits, usage, and reset time.
用開物 Kaiwu 從一個或多個 URL 抓取乾淨的 markdown/純文字內容，去除導覽列、廣告等雜訊。已經有特定網址、想讀全文時使用。Extract clean markdown/text from URLs, with optional query-based filtering.
用開物 Kaiwu 搜尋中文世界的網路 — 繁簡雙語、無審查、回傳 LLM-ready 結果。需要找資訊、查最新消息、還沒有特定 URL 時使用。Search the Chinese-language web (Traditional + Simplified) with agent-optimized results.
| name | kaiwu-cli |
| description | 開物 Kaiwu CLI（kw）的安裝、認證與設定參考，以及 search/extract/credits 的完整工作流程。設定環境、遇到 kw 找不到或認證問題時的參考。Install, auth, and configure the Kaiwu CLI (kw). |
開物 Kaiwu CLI（kw）的安裝、認證與設定總覽。中文世界的 AI 搜尋 API，專為 AI agent 打造 — 對標 Tavily，繁簡雙語、無審查、台灣部署。
curl -fsSL https://kaiwu.dev/install.sh | bash
npm install -g @kaiwu/cli
npx @kaiwu/cli search "你的查詢" --json
安裝後執行 kw --version 確認。
kw_ + 32 字元）。kw login # 互動式輸入金鑰
kw login kw_xxxxx # 直接給
金鑰會存在 ~/.kaiwu/config.json（權限 600）。
export KAIWU_API_KEY="kw_xxxxx"
環境變數優先於設定檔。
export KAIWU_API_URL="https://your-kaiwu-instance.dev"
# 或
kw config set base_url https://your-kaiwu-instance.dev
開物的能力呈線性管線，按需要組合：
search → extract → (research)
找 URL 抓全文 多源彙整（規劃中）
CLI 是 https://kaiwu.dev REST API 的薄封裝。直接打 API：
# search
curl -s https://kaiwu.dev/v1/search \
-H "Authorization: Bearer $KAIWU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"台灣 AI 政策","search_depth":"advanced","include_answer":true}'
# extract
curl -s https://kaiwu.dev/v1/extract \
-H "Authorization: Bearer $KAIWU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://example.com/article"],"format":"markdown"}'
# credits
curl -s https://kaiwu.dev/v1/credits \
-H "Authorization: Bearer $KAIWU_API_KEY"
也可用 MCP server（Streamable HTTP）：https://kaiwu.dev/mcp。
| 症狀 | 解法 |
|---|---|
kw: command not found | 重新執行安裝指令；npm 全域安裝需確認 PATH 含 npm bin |
需要 API 金鑰 / 401 | 執行 kw login 或設定 KAIWU_API_KEY |
額度不足 / 429 | kw credits 查餘額；等月初重置或升級方案 |
| 連線失敗 | 確認 kw config 的 base_url 正確 |