Skip to main content

为 OpenClaw Agent 配置企业知识库检索

OpenClaw Agent 默认只能基于通用知识回答问题，无法访问您的企业文档。通过安装阿里云百炼知识库检索 Skill，Agent 可以自动检索阿里云百炼知识库中的内容，并基于企业文档生成准确回答。

阿里云百炼知识库检索 Skill（alibabacloud-bailian-rag-knowledgebase）是阿里云官方提供的 Skill，让 Agent 具备以下能力： 智能检索企业知识：自动从阿里云百炼知识库中查找与用户问题最相关的内容，无需手动指定知识库。 精准回答专业问题：基于企业文档生成准确回答，而非通用的模糊回复。

工作流程

根据提问，Agent 自动获取阿里云百炼业务空间列表 遍历各业务空间，获取知识库列表 根据问题语义，智能选择 1～3 个最相关的知识库 在选定知识库中执行语义检索，返回最匹配的文档片段（含相似度分数） 整合多个文档片段，生成带来源标注的回答

前提条件

已安装 OpenClaw，且 Gateway 处于运行状态。可通过 openclaw health 命令确认。 已在阿里云百炼控制台开通知识库服务，创建知识库并完成文档上传和向量化。详情请参见阿里云百炼知识库控制台。 已准备好阿里云账号的 AccessKey ID 和 AccessKey Secret（AK/SK）。如需创建，请登录AccessKey 管理页面。 本地已安装 Node.js 16 及以上版本。 本地已安装阿里云 CLI（aliyun）。如尚未安装，请参见阿里云 CLI 安装指南完成安装。

步骤一：安装 Skill

在终端执行以下命令，将阿里云百炼知识库检索 Skill 安装到 OpenClaw： npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-bailian-rag-knowledgebase 安装完成后，进入 Skill 目录，安装 npm 依赖包。 说明：若您处于阿里内网环境，需指定公网 npm 源，否则会报 404 找不到包。 cd ~/.openclaw/skills/alibabacloud-bailian-rag-knowledgebase npm install --registry https://registry.npmjs.org 安装成功后，输出类似以下内容： added 36 packages in 22s 验证 Skill 是否被 OpenClaw 识别： openclaw skills list 在输出列表中找到 alibabacloud-bailian-rag-knowledgebase，且状态为 ✓ ready，表示 Skill 安装成功。

步骤二：授权 RAM 权限

Skill 通过 AK/SK 调用阿里云百炼 API，需要完成以下两步授权，缺少任一步都会导致调用时报 403 权限错误。
  1. 授予 RAM 策略权限
登录阿里云 RAM 控制台，在用户列表中找到 AK 所属的 RAM 用户，点击用户名进入详情页。 在权限管理标签页点击新增授权，搜索并添加以下两个权限策略： AliyunBailianFullAccess：阿里云百炼服务完全访问权限（用于调用知识库检索 API） AliyunModelStudioReadOnlyAccess：ModelStudio 只读权限（用于获取业务空间列表）
  1. 授予阿里云百炼工作空间权限
登录阿里云百炼控制台，进入权限管理页面。 若列表中没有该 RAM 用户，点击右上角添加用户，选择对应的 RAM 用户并确认添加。 点击该用户右侧的权限管理，点击编辑，授予知识库相关权限后保存。 配置完成后约 30 秒生效，请稍等片刻再进行下一步操作。

步骤三：配置访问凭证

Skill 使用阿里云凭证链读取 AK/SK。推荐使用阿里云官方 CLI 工具 aliyun configure 完成配置，配置一次，永久生效。 方式一：使用阿里云 CLI 配置（推荐） 在终端执行以下命令，按提示填入 AccessKey ID、AccessKey Secret 和 Region： aliyun configure 命令会依次提示： Configuring profile 'default' in 'AK' authenticate mode... Access Key Id []: 您的AccessKeyId Access Key Secret []: 您的AccessKeySecret Default Region Id []: cn-hangzhou Default Output Format [json]: json Default Language [zh]: zh 方式二：环境变量（仅当前终端会话生效） 
# macOS / Linux
export ALIBABA_CLOUD_ACCESS_KEY_ID=您的AccessKeyId
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=您的AccessKeySecret

# Windows PowerShell
$env:ALIBABA_CLOUD_ACCESS_KEY_ID="您的AccessKeyId"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET="您的AccessKeySecret"

使用方法

完成以上配置后，直接在 OpenClaw 对话框中用自然语言提问即可。Agent 会自动完成知识库的发现、选择和检索，无需手动指定知识库 ID。 示例一：查询产品功能 在 OpenClaw 对话框中输入： 我们的产品支持哪些身份认证方式？ Agent 回答示例： 根据产品文档，我们的产品支持以下三种身份认证方式：
  1. OAuth 2.0：适用于第三方应用授权场景，支持授权码模式和客户端凭证模式。
  2. API Key：适用于服务端调用，在控制台创建后写入请求头 Authorization 字段。
  3. RAM 子账号：适用于企业内部权限管控，通过 AccessKey ID 和 Secret 进行认证。
来源：产品文档知识库 / 开发者指南 / 身份认证与授权（相似度：0.89） 示例二：跨知识库检索 在 OpenClaw 对话框中输入： 最新的 API 限流规则是什么？ Agent 会自动在多个知识库中检索，优先返回相似度最高的内容，并标注来源文档名称和章节，方便您核实原始信息。

常见问题

问题解决方法
npm install 报 404 找不到包内网 npm 源不含阿里云 SDK 包，需指定公网源：npm install --registry https://registry.npmjs.org
check_env.js 报凭证未配置确认 ~/.aliyun/config.json 文件存在且 AK/SK 正确，或已设置环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
调用报错 403 Index.NoWorkspacePermissions有两种可能：（1）业务空间不存在；（2）RAM 用户未完成步骤二中的两步授权。请重新检查 RAM 权限和阿里云百炼工作空间成员权限，配置完成后等待约 30 秒再重试。
openclaw skills list 中看不到该 Skill确认 Skill 目录已复制到 ~/.openclaw/skills/ 下，且目录中包含 SKILL.md 文件，然后重启 OpenClaw Gateway：openclaw gateway stop && openclaw gateway start。

相关文档

文档说明
阿里云百炼知识库控制台创建知识库、上传文档、管理向量索引
RAM 访问控制创建 RAM 用户、管理 AK/SK 和授权策略
阿里云百炼知识库检索 Skill 门户Skill 源码、更新日志和安装说明