yawan
f7fc992f57
Anydoc / anydoc parser engine (push) Canceled after 0s
App / Format, vet, test, and build (push) Canceled after 0s
CLI / test (macos-latest / go 1.26) (push) Canceled after 0s
CLI / test (ubuntu-latest / go 1.26) (push) Canceled after 0s
CLI / test (windows-latest / go 1.26) (push) Canceled after 0s
Build and Push Docker Image / build-ui (push) Canceled after 0s
Build and Push Docker Image / build-docreader (push) Canceled after 0s
Build and Push Docker Image / build-sandbox (push) Canceled after 0s
Build and Push Docker Image / build-app (amd64, linux/amd64, ubuntu-latest) (push) Canceled after 0s
Build and Push Docker Image / build-app (arm64, linux/arm64, ubuntu-24.04-arm) (push) Canceled after 0s
DocReader / Python tests and Go client tests (push) Canceled after 0s
Build & Publish (dsh-weknora) / Typecheck, test, pack (push) Canceled after 0s
Build & Publish (dsh-weknora) / End-to-end inside dsh (pinned) (push) Canceled after 0s
Build & Publish (dsh-weknora) / End-to-end inside dsh (latest, advisory) (push) Canceled after 0s
Frontend / Test, type-check, and build (push) Canceled after 0s
Go Lint Cache / warm lint cache (.) (push) Canceled after 0s
Go Lint Cache / warm lint cache (cli) (push) Canceled after 0s
Go Lint Cache / warm lint cache (client) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.10) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.11) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.12) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.13) (push) Canceled after 0s
Build and Push Docker Image / merge (push) Canceled after 0s
Build & Publish (dsh-weknora) / Publish to npm (push) Canceled after 0s
Build & Publish (mcp-server) / Build sdist + wheel (push) Canceled after 0s
Build & Publish (mcp-server) / Publish to PyPI (push) Canceled after 0s
51 lines
2.5 KiB
Markdown
51 lines
2.5 KiB
Markdown
# Claw Skill
|
|
|
|
Claw Skill 是把 WeKnora 挂给 AI Agent 用的一种方式：安装之后，OpenClaw 生态里的 Agent 就能通过 WeKnora 的 REST API 往知识库里写内容、跨库检索。
|
|
|
|
Skill 托管在 ClawHub，包名 [`@lyingbug/weknora`](https://clawhub.ai/lyingbug/weknora)（MIT-0）。它是一层薄封装，实际能力就是 WeKnora 的 REST 接口。
|
|
|
|
## 能做什么
|
|
|
|
| 能力 | 对应接口 |
|
|
| --- | --- |
|
|
| 上传文件 | 把 PDF / Word / Excel 等文档送进知识库并自动解析向量化 |
|
|
| 导入网页 | 按 URL 抓取正文写入知识库，支持轮询解析状态 |
|
|
| 写入 Markdown | 以 Markdown 创建或编辑知识条目，适合会议记录、结构化笔记 |
|
|
| 混合检索 | 单库 `hybrid-search` 与跨库 `knowledge-search`，向量 + 关键词召回 |
|
|
| 浏览知识库 | 列出知识库与条目、查看详情 |
|
|
|
|
## 怎么配
|
|
|
|
WeKnora 界面里有引导页：「设置 → 集成 → Claw Skill」，会带上当前实例的 API 地址与可复制的环境变量示例、安装命令。步骤：
|
|
|
|
1. **拿 API 凭证**：「设置 → API 信息」里复制 API Key 与 API 地址；
|
|
2. **配环境变量**：在终端或 `~/.zshrc` / `~/.bashrc` 里设置
|
|
|
|
```bash
|
|
export WEKNORA_BASE_URL=https://your-weknora.example.com/api/v1
|
|
export WEKNORA_API_KEY=sk-xxxxx
|
|
```
|
|
|
|
3. **安装 Skill**：在装好 OpenClaw CLI 的环境里执行引导页给出的安装命令，或到 ClawHub 页面按指引安装；
|
|
4. **验证**：让 Agent 列一次知识库或跑一次检索，确认凭证与网络可达。
|
|
|
|
## 和 MCP 的关系
|
|
|
|
两者都是「把 WeKnora 给外部 Agent 用」，选哪个取决于对方生态：
|
|
|
|
| | Claw Skill | MCP Server |
|
|
| --- | --- | --- |
|
|
| 面向 | OpenClaw / ClawHub 生态的 Agent | 支持 MCP 协议的客户端（Claude Desktop、VS Code Copilot 等） |
|
|
| 安装 | ClawHub 安装 Skill | `pip install tencent-weknora-mcp` 或 `uvx` 运行 |
|
|
| 传输 | 直接调 REST | stdio / SSE / Streamable HTTP |
|
|
| 能力范围 | 导入、检索、浏览（5 类） | 29 个工具，另含租户、模型、会话、Agent 问答、Wiki |
|
|
| 文档 | 本篇 | [MCP 集成](../03-features/08-mcp.md) |
|
|
|
|
需要更完整的能力（跑 Agent 对话、管模型、读 Wiki）时用 MCP Server；只是想让 Agent 存取资料，Skill 更轻。
|
|
|
|
## 相关
|
|
|
|
- 凭证与能力收窄：[租户、用户与认证授权](../03-features/01-tenant-auth.md)
|
|
- 底层接口：[API 总览](../04-api/01-api-overview.md)
|
|
- 其它集成方式：[Chrome 插件](06-chrome-extension.md)、[MCP 集成](../03-features/08-mcp.md)
|