让知识在 Agent 间流动 —— 表格存储知识库 Skills 实践指南

你有没有算过，同样的项目文档，你在多少个工具里重复上传过？

办公电脑上，QoderWork 里存着全套产品文档，用起来很顺手。但你同时也在用 OpenClaw、用 Hermes、用 Claude Code——能不能让这些 Agent 也读到同一份知识？

不是没有知识，而是被锁在了一座座围墙里。

每个 Agent 框架都有自己的知识管理方式，你在 A 工具里熬夜整理好的文档，B 工具里根本用不了。要么每个平台都配一遍，要么干脆放弃，回到「手动复制粘贴」的原始状态。

为突破这道围墙，表格存储知识库服务提供了 tablestore-agent-cli 命令行工具和配套的 Agent Skills（tablestore-agent-knowledge），任何支持执行命令行的 Agent，都可以通过这套 Skill 接入同一个知识库。

本文介绍这套方案的安装、配置，以及如何在 OpenClaw 和 Hermes 上实现跨 Agent 的知识共享。

Tablestore 知识库服务：不只存文档，更让你的知识“活”起来

在介绍怎么打通 Agent 之前，先快速了解一下这套知识库服务到底强在哪。它不是简单的文件柜，而是一套全托管的 RAG 方案，是表格存储原生提供的全托管 RAG 知识库方案。此处列出与本文相关的核心特性：

• 全托管文档处理 — 文档上传后，系统自动完成解析、切块、Embedding 向量化和索引构建，当前支持 PDF、Word、PPT、Excel、纯文本、Markdown 等主流格式，更多格式持续扩展中。
  
• 混合检索 — 同时支持向量检索和全文检索，提供 RRF、加权融合、模型 Rerank 三种排序策略，检索延迟在 200ms 级别。
  
• Subspace 多租户隔离 — 在同一个知识库内为不同租户划分独立的数据空间，隔离在服务端保证。
  
• 数据自持 — 所有数据存储在用户自己的 OSS 和 Tablestore 账户内，服务不持有任何用户数据。
  

CLI 与 Dashboard

CLI：Agent-first 的命令行工具

tablestore-agent-cli 是知识库的命令行管理工具，所有命令默认输出结构化 JSON，支持自动分页，Agent 可以直接解析。全局参数 -q 去掉响应中的外层信封（code、message、requestId），只返回业务数据，节省 token 开销。其他常用全局参数包括 -y（跳过确认提示，适用于脚本和 CI 场景）、--instance（指定实例名称）、--timeout（设置超时时间）。

安装与配置

CLI 运行依赖以下配置项：

只需手动配置 Region、AK 和 SK，其余配置项在首次使用时由 CLI 自动完成。

安装方式（基于 Node.js >= 18）：

npm install -g @tablestore/tablestore-agent-cli --registry=https://registry.npmjs.org/

安装完成后，通过 configure set 命令配置凭证：

tablestore-agent-cli configure set region cn-beijing
tablestore-agent-cli configure set access_key_id <your-ak>
tablestore-agent-cli configure set access_key_secret <your-sk>

除手动安装外，也可以直接让 Agent 完成安装和配置。安装好 Skill 后，在对话中告诉 Agent 即可：

图 1：Agent 安装技能和 CLI 工具

之后就可以通过 CLI 完成知识库的创建、文档上传、检索等操作：

# 创建知识库
tablestore-agent-cli -q kb create --name product_docs
# 批量上传目录下的文档
tablestore-agent-cli -q kb doc-add --kb product_docs --dir ./docs --include "*.pdf,*.md"
# 检索
tablestore-agent-cli -q kb retrieve --kb product_docs --query "如何配置 SSL 证书"

CLI 覆盖知识库管理、文档管理、检索、多租户（Subspace）、连通性诊断（doctor）等全部场景。

Dashboard

CLI 内置了一个可视化的 Dashboard 前端，一条命令启动：

tablestore-agent-cli dashboard start

Dashboard 是知识库使用和调试的主要界面。它提供了完整的可视化操作能力，同时涵盖知识库和记忆库的管理。对于知识库场景，核心工作包括：调整检索参数和索引配置（searchType、TopK、Rerank 策略等），验证端到端的检索效果，以及挂载和切换多个知识库进行对比测试。在调试过程中，可以直接与 LLM 对话，观察检索结果注入后的实际问答表现。

图 2：DashBoard 调试示例

通过 Skill 接入 Agent 框架

在 OpenClaw 上接入，知识从此不再搬家

在 OpenClaw 中安装 tablestore-agent-knowledge Skill 后，Agent 即可通过 CLI 管理和检索知识库。

安装

一句话完成技能安装：

请你学习 https://tablestore-doc.oss-cn-hangzhou.aliyuncs.com/aliyun-tablestore-ai/agent-storage/tablestore-agent-knowledge.zip 这个技能，并完成CLI的安装

配置

虽然 Agent 帮你配置很方便，但仍建议 AK、SK 等敏感凭证自行手动配置

tablestore-agent-cli configure set region cn-beijing
tablestore-agent-cli configure set access_key_id <your-ak>
tablestore-agent-cli configure set access_key_secret <your-sk>

配置好 Region、AK 和 SK 后，CLI 在首次使用时会自动完成 OSS Bucket 配置和 Tablestore 实例创建，无需额外操作。

配置完成后，就可以在对话中直接操作知识库了：

"帮我创建一个叫 project_wiki 的知识库，然后把 ./docs 目录下的文档上传进去。"

"在 project_wiki 中检索一下关于部署流程的内容。"

Agent 会将这些自然语言指令转化为对应的 CLI 命令，执行后返回结果。整个过程围绕知识文档的管理和检索展开——创建知识库、上传文档、查询文档状态、执行检索、管理切片，这些都是 Skill 覆盖的能力。

图 3：OpenClaw 创建知识库

图 4：OpenClaw 导入文档

在 Hermes 上接入

Hermes 的接入方式与 OpenClaw 完全一致：安装同一个 Skill，配置同一套凭证，Agent 就能通过 CLI 操作知识库。

图 5：Hermes 一键安装

如果你已经在 OpenClaw 上完成了配置，切换到 Hermes 时不需要重新手动输入凭证。可以在 OpenClaw 中先导出 Token（也可以让你的 Agent 帮你导出）：

tablestore-agent-cli configure export

输出类似：

instance=my-instance token=tablestore_agent_storage://eyJ2IjoyLC...

然后在 Hermes 中，只需一行导入即可：

tablestore-agent-cli configure import tablestore_agent_storage://eyJ2IjoyLC...

图 6：Hermes 导入知识库配置

甚至可以直接告诉 Hermes Agent："我的 Token 是 tablestore_agent_storage://eyJ2IjoyLC...，请帮我导入。"一句话完成配置。之后 Hermes 就接入了和 OpenClaw 完全相同的知识库，检索到的是同一份数据。

图 7：Hermes 共享到 OpenClaw 总结的知识

在其他 Agent 上接入

同样的方式也适用于 QoderWork、CherryStudio、Claude Code 等任何支持 Skill 或能执行命令行的 Agent。CLI 是统一的入口，Skill 是统一的说明书，Token 是统一的钥匙——只要拿到 Token，任何 Agent 都可以接入同一个知识库。

需要注意的是，Token 中编码了 AccessKey 等凭证信息，应当通过安全渠道传递（如面对面分享、密码管理工具等），不要在公开场合或不安全的渠道中传播。CLI 的 configure show 命令在显示配置时会自动遮蔽 Secret，但 configure export 导出的 Token 包含完整凭证，需妥善保管。

场景一：办公电脑与开发机之间的知识共享

工作中跨设备的知识共享是很多开发者面临的实际问题。日常工作往往是这样的：办公电脑上处理文档、开会、写方案，用 QoderWork；开发机上写代码、调试、部署，用 Claude Code。两台机器上的 Agent 各管各的，你在办公电脑上整理好的内容，开发机上的 Agent 一无所知。

举个具体的例子。你在负责一个微服务项目，相关的文档不少：API 接口规范、架构设计文档、部署手册、几次技术方案评审的纪要。这些文档平时在办公电脑上用 QoderWork 整理和查阅，很方便。但切到开发机上用 Claude Code 写代码时，想确认一下某个接口的入参格式、查一下上次评审中关于缓存策略的结论，Agent 答不上来——它没有这些上下文。

用知识库可以把两边打通。在办公电脑上，通过 QoderWork 创建知识库并上传项目文档：

tablestore-agent-cli -q kb create --name my_project
tablestore-agent-cli -q kb doc-add --kb my_project --dir ./project-docs --include "*.md,*.pdf"

然后导出 Token：

tablestore-agent-cli configure export

在开发机上，让 Claude Code 导入这个 Token——你可以直接在对话中说："我的 Token 是 tablestore_agent_storage://eyJ2IjoyLC...，请帮我导入知识库配置。"一句话完成。

之后在开发机上写代码时，就可以直接问 Claude Code：

"订单服务的创建接口需要哪些必填字段？"

"上次评审确定的缓存失效策略是什么？Redis TTL 设了多少？"

Claude Code 从知识库中检索到对应的接口文档和评审纪要，给出回答。和办公电脑上 QoderWork 检索到的是同一份数据——因为背后连的就是同一个知识库。

文档有更新时，在任意一端重新上传即可。比如你在办公电脑上改了接口规范，上传后开发机上的 Claude Code 下次检索时自动拿到最新版本，不需要手动同步。

场景二：游戏攻略在手机和电脑间共享

除了工作场景，日常生活中的知识共享同样适用。

假设你是一个《杀戮尖塔 2》的玩家。这款游戏的卡牌、遗物、事件组合极其复杂，社区维护了一份内容丰富的 Wiki。你想在不同场景下随时查阅这份攻略知识，但查阅的方式和设备各不相同。

首先，你把 Wiki 导出为 Markdown 文件，通过 CLI 上传到知识库：

tablestore-agent-cli -q kb create --name sts2_wiki
tablestore-agent-cli -q kb doc-add --kb sts2_wiki --dir ./sts2-wiki --include "*.md"

在手机上查阅 — 你在云端部署了一个 OpenClaw 实例并连接了微信。通勤路上、排队时，直接在微信里问："新版本的门扉到底怎么过？"Agent 从知识库中检索相关内容，给出回答。

图 8：Agent 上查看攻略

在电脑上查阅 — 你在电脑上边打游戏边用 CherryStudio（或者 Claude Code）。突然想尝试一个没接触过的流派，直接问："机器人的核心遗物有哪些？前期怎么过渡？"CherryStudio 配置了同一个知识库的 Token，检索到的是和微信里完全相同的 Wiki 内容。

配置过程也不复杂。手机端的 OpenClaw 配好之后，导出 Token，在电脑端的 CherryStudio 中导入——一行命令的事。之后不管你在哪个设备上提问，访问的都是同一份攻略库。Wiki 内容更新了，重新上传一次即可，两端同时生效。

联系我们

如果你在使用 tablestore-agent-cli 或通过 Skill 接入 Agent 框架的过程中遇到问题，欢迎加入表格存储技术交流钉钉群：36165029092。