القائمة
開物 Kaiwu CLI（kw）的安裝、認證與設定參考，以及 search/extract/credits 的完整工作流程。設定環境、遇到 kw 找不到或認證問題時的參考。Install, auth, and configure the Kaiwu CLI (kw).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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 正確 |
用開物 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.