AI 助理
文档备案控制台
开发者社区 安全 文章 正文

本地私有RAG落地：阿里云/本地部署 OpenClaw 及私有化知识库技能搭建+千问/Coding Plan配置与问题全解

2026-03-31 922
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 在政企内网、涉密环境、个人隐私场景下，使用外部大模型与在线知识库存在数据泄露、合规风险、网络限制等问题。OpenClaw提供了完全本地化的RAG（检索增强生成）能力，可在**不联网、不付费、数据不出本地**的前提下，让AI读取你的PDF、Markdown、TXT等文档，基于真实资料给出准确回答，杜绝幻觉与编造。

一、前言

在政企内网、涉密环境、个人隐私场景下，使用外部大模型与在线知识库存在数据泄露、合规风险、网络限制等问题。OpenClaw提供了完全本地化的RAG（检索增强生成）能力，可在不联网、不付费、数据不出本地的前提下，让AI读取你的PDF、Markdown、TXT等文档，基于真实资料给出准确回答，杜绝幻觉与编造。
OpenClawo.png

本文完整保留本地私有知识库RAG技能开发、向量检索、文档读取、本地模型调用等核心内容，同时新增2026年4月阿里云轻量服务器部署OpenClaw、本地MacOS/Linux/Windows11全平台安装、阿里云千问大模型API配置、免费Coding Plan模型接入、可直接复制的代码命令、新手避坑指南与常见问题解答，适合个人、政企内网、涉密环境快速落地。阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

二、私有RAG技能核心价值与整体架构

（一）核心能力

  • 完全私有化：数据不联网、不上传、不泄露
  • 多格式支持：PDF、MD、TXT、Word等文档统一读取
  • 向量检索：基于nomic-embed-text实现精准语义匹配
  • 本地大模型：对接Ollama运行qwen2.5:7b，不依赖外部API
  • 可信回答：基于本地资料作答，不编造、不胡说

（二）整体架构

  • 知识库：本地文件夹（存放所有文档）
  • 向量模型：nomic-embed-text（Ollama运行）
  • 检索模块：OpenClaw自定义RAG技能
  • 大模型：qwen2.5:7b（本地Ollama）
  • 执行引擎：OpenClaw 2026.4稳定版

三、2026年4月阿里云轻量服务器部署OpenClaw（最新版）

步骤1：创建实例（官方镜像一键部署）

  1. 登录阿里云控制台，进入轻量应用服务器
  2. 镜像选择：应用镜像 → OpenClaw（Clawdbot）2026.4稳定版
  3. 推荐配置：2核4GB、40GB ESSD、5Mbps带宽
  4. 地域选择：中国香港、新加坡、美国弗吉尼亚
  5. 设置root密码，购买并等待实例运行

    零基础部署 OpenClaw 喂饭级步骤流程

    第一步：点击打开访问阿里云OpenClaw一键部署专题页面。
    openclaw666.png
    OpenClaw2.png
    OpenClaw02.png
    OpenClaw03.png
    OpenClaw04.png

第二步：打开选择阿里云轻量应用服务器，配置参考如下：

  • 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
  • 实例：内存必须2GiB及以上。
  • 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
  • 时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png
bailian1.png
bailian2.png

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

  • 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
  • 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
  • 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
  • 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！
CodingPlan.png

  • 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
    image.png
  • 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
    image.png
  • 在服务器概览页面单击应用详情页签，进入服务器详情页面。
    image.png
  • 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
    image.png
  • 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
    image.png
  • 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
    image.png
    image.png

步骤2：一键放行端口（必做）

firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
firewall-cmd --list-ports | grep 18789

步骤3：初始化与启动服务

openclaw onboard --aliyun
openclaw gateway install
openclaw gateway start

步骤4：验证运行状态

openclaw gateway status

显示 running 即为成功，访问：

http://你的公网IP:18789

四、本地全平台部署OpenClaw（MacOS/Linux/Windows11）

（一）MacOS部署

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node@22
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway start

（二）Linux（Ubuntu/Debian）部署

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
openclaw onboard --install-daemon
sudo ufw allow 18789/tcp
openclaw gateway start

（三）Windows11部署（WSL2）

wsl --install
wsl --set-default-version 2

进入Ubuntu终端：

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway start

五、大模型API配置（阿里云千问 + 免费Coding Plan）

（一）阿里云千问Qwen3-Max配置

cd ~/.openclaw
nano openclaw.json

写入配置：

"models": {
   
  "default": "bailian/qwen3-max-2026-01-23",
  "providers": {
   
    "bailian": {
   
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "sk-你的千问APIKey",
      "models": [
        {
   "id":"qwen3-max-2026-01-23","maxTokens":65536},
        {
   "id":"qwen3.5-plus","maxTokens":16384}
      ]
    }
  }
}

重启生效：

openclaw gateway restart

（二）免费Coding Plan配置

"models": {
   
  "default": "coding-plan/coding-free",
  "providers": {
   
    "coding-plan": {
   
      "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
      "apiKey": "sk-sp-你的免费APIKey",
      "models": [{
   "id":"coding-free","maxTokens":4096}]
    }
  }
}

六、Ollama与向量模型安装（私有RAG必需）

1. 安装Ollama

# Mac/Linux
curl -fsSL https://ollama.com/install.sh | bash

# Windows
winget install Ollama.Ollama

2. 拉取向量模型与大模型

ollama pull nomic-embed-text
ollama pull qwen2.5:7b

3. 验证运行

ollama list

七、创建本地私有知识库RAG技能

1. 创建技能目录

mkdir -p ~/.openclaw/skills/rag_knowledge
cd ~/.openclaw/skills/rag_knowledge

2. 创建config.json（技能配置）

{
   
  "name": "rag_knowledge",
  "description": "本地私有知识库检索问答，基于RAG机制准确回答",
  "version": "1.0.0",
  "triggerKeywords": ["知识库", "查文档", "笔记", "资料", "手册", "总结文档"]
}

3. 创建index.js（核心RAG逻辑）

const fs = require('fs');
const path = require('path');
const os = require('os');
const {
    execSync } = require('child_process');

// ===================== 配置区 =====================
const KNOWLEDGE_DIR = path.join(os.homedir(), 'AI_KnowledgeBase');
// Windows可改为：'D:\\AI_KnowledgeBase'
const VECTOR_MODEL = 'nomic-embed-text';
const LLM_MODEL = 'qwen2.5:7b';
// ==================================================

// 读取所有知识库文档
function loadAllDocuments() {
   
  let docs = [];
  try {
   
    const files = fs.readdirSync(KNOWLEDGE_DIR);
    files.forEach(file => {
   
      const fp = path.join(KNOWLEDGE_DIR, file);
      if (fs.statSync(fp).isFile()) {
   
        const txt = fs.readFileSync(fp, 'utf8', (err) => {
   });
        if (txt.length > 50) docs.push({
    file, content: txt.slice(0, 20000) });
      }
    });
  } catch (e) {
   }
  return docs;
}

// 关键词检索
function simpleSearch(query, docs) {
   
  const q = query.toLowerCase();
  return docs.filter(d =>
    d.file.toLowerCase().includes(q) ||
    d.content.toLowerCase().includes(q)
  );
}

// 调用本地模型生成回答
function llmAnswer(query, context) {
   
  const prompt = `
你是一名专业的知识助理，基于下面提供的本地文档内容回答问题，不要编造。
问题：${
     query}
参考文档：
${
     context}
请给出清晰、准确、专业的回答。
`;
  try {
   
    return execSync(`ollama run ${
     LLM_MODEL} "${
     prompt.replace(/"/g, '\\"')}"`, {
   
      timeout: 120000
    }).toString();
  } catch (e) {
   
    return '模型处理超时或出错，请检查Ollama是否正常运行。';
  }
}

// 技能入口
module.exports = async (query) => {
   
  if (!query) return "请输入你要查询的问题，例如：什么是双到位制度？";
  const docs = loadAllDocuments();
  if (docs.length === 0) return "知识库文件夹为空，请先放入文档。";
  const hits = simpleSearch(query, docs);
  if (hits.length === 0) return "未在本地知识库中找到相关内容。";
  const context = hits.map(d => `【文档：${
     d.file}】\n${
     d.content.slice(0, 8000)}`).join('\n\n');
  const ans = llmAnswer(query, context);
  return `=== 本地知识库RAG回答 ===\n\n${
     ans}\n\n共检索到相关文档：${
     hits.length}份`;
};

4. 创建知识库目录

mkdir -p ~/AI_KnowledgeBase
# 放入MD、TXT、PDF文档

八、启用RAG技能并测试

1. 重启OpenClaw

openclaw gateway restart

2. 测试指令

  • 帮我查一下银河麒麟系统的加固步骤
  • 这份网络规范里VLAN划分规则是什么
  • 从我的笔记里总结一下服务器运维要点
  • 解释一下电力安全双到位制度，并引用我本地文档

3. 查看结果

AI会自动检索本地文档并给出带依据的回答，不编造、不泄露。

九、进阶优化方向

  1. PDF解析支持：引入pdf-parse库实现PDF文本提取
  2. 向量检索升级：接入Chroma/Milvus实现真正语义搜索
  3. 大文档分片：自动切块避免上下文溢出
  4. 多格式支持：Word、Excel、代码统一读取
  5. 内网安全加固：关闭外网、权限白名单、日志留存

十、OpenClaw常用运维命令

openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status
openclaw logs -f
openclaw model test
openclaw skills list
openclaw doctor

十一、阿里云+本地部署避坑指南

1. 地域选择错误

  • 必须选择中国香港/新加坡/弗吉尼亚，内地地域易受限
  • 影响模型API与外部访问

2. 端口未放行

  • 18789端口必须在阿里云防火墙+系统防火墙双重放行

3. 内存不足

  • 最低2GB，推荐4GB以上，否则服务易崩溃

4. Ollama未启动

  • 执行ollama list验证，未启动则执行ollama serve

5. 技能不生效

  • 修改后必须openclaw gateway restart
  • 检查目录路径与文件权限

6. 模型API Key错误

  • 千问：sk-开头
  • Coding Plan：sk-sp-开头
  • 不要混用，不要带空格换行

十二、常见问题解答（FAQ）

1. 本地RAG是否需要联网？

不需要，全程本地运行，适合内网、涉密环境。

2. 支持哪些文档格式？

默认支持MD、TXT，可扩展支持PDF、Word、Excel等。

3. 如何更换本地大模型？

修改index.js中的LLM_MODEL为其他Ollama模型即可。

4. 知识库文档放在哪里？

默认：~/AI_KnowledgeBase，Windows可自定义路径。

5. 能否同时使用云端模型？

可以，通过配置文件切换千问/Coding Plan与本地模型。

6. 如何备份知识库？

直接复制AI_KnowledgeBase文件夹即可。

十三、总结

OpenClaw本地私有RAG技能真正实现了数据私有化、运行本地化、回答可信化，完美解决政企内网、涉密环境、个人隐私场景下的AI使用需求。搭配2026年4月最新阿里云轻量服务器部署与本地全平台安装方案，再加上阿里云千问与免费Coding Plan双模型支撑，用户可快速搭建一套安全、可控、可扩展的私有AI知识系统。

文章标签：
API
人工智能
安全
Linux
网络安全
一条云
目录
相关文章
一条云
|
3月前
|
人工智能 Linux API
OpenClaw 知识库搭建攻略：QMD/向量库/知识图谱三方案+阿里云+本地部署+千问/Coding Plan配置
随着OpenClaw V2026.3.22模块化框架正式成熟，本地知识库与RAG能力已经成为AI智能体从“简单对话”走向“专业可靠”的关键分水岭。单纯依靠大模型上下文已经无法满足长期使用、专业问答、资料检索、低Token消耗的需求。
一条云
3314 1
Clawdbot
|
3月前
|
Linux API 网络安全
OpenClaw(Clawdbot)本地+阿里云部署实操：知识库搭建与大模型API对接全流程
在2026年的AI办公实践中，将本地分散的PDF、Markdown、Word等文档转化为可检索、可问答的智能知识库，成为提升工作效率的核心需求。但实际操作中，开发者常面临资料检索效率低、向量库搭建环境依赖复杂、大模型对接流程不清晰等问题。OpenClaw（原Clawdbot）作为轻量级的RAG（检索增强生成）框架，可实现本地文档的快速向量化、检索与问答闭环，同时支持本地多系统（MacOS/Linux/Windows11）与阿里云服务器部署，还能灵活对接阿里云千问系列大模型及免费的Coding Plan API，兼顾数据隐私性与AI问答能力。本文将详细拆解2026年OpenClaw的全平台部署步
Clawdbot
2796 13
问号云
|
3月前
|
人工智能 安全 API
5分钟搭建专属AI知识库！OpenClaw阿里云/本地部署+飞书智能知识库实战+百炼API配置指南
在2026年的AI生态中，单纯的对话模型早已无法满足深度使用需求，AI+私有知识库才是真正能落地、能复用、能持续进化的核心形态。无论是个人沉淀经验、团队共享文档、企业管理技术资料，还是把OpenClaw训练成专属智能助手，一套可问答、可检索、可溯源的AI知识库，都能让效率呈指数级提升。
问号云
3304 5
Clawdbot
|
3月前
|
存储 人工智能 API
部署 OpenClaw 双层记忆系统实战：Mem0+Qdrant向量检索+Markdown持久化搭建教程
在AI智能体实际使用中，**记忆能力**直接决定体验上限。传统上下文窗口有限、历史对话易丢失、关键信息无法长期留存，导致每次交互都要重复说明需求。OpenClaw结合Mem0与Qdrant构建的**双层记忆体系**，完美解决这一问题：上层基于向量数据库实现语义检索与长期记忆，下层通过Markdown文件做关键数据持久化备份，兼顾检索效率与数据安全。
Clawdbot
1125 5
OpenClaw
|
3月前
|
存储 人工智能 自然语言处理
OpenClaw从阿里云+本地部署到使用：连接Obsidian、Notion驱动的个人知识库搭建手册
在信息爆炸的时代，零散的资料收藏、重复的学习成本、低效的检索体验，让很多人陷入“知识焦虑”。而个人知识库的核心价值，正是将碎片化信息转化为结构化知识，实现高效存储、精准检索与灵活复用。2026年，开源AI智能体OpenClaw（曾用名Clawdbot）凭借强大的文件读写、语义理解与自动化能力，成为搭建个人知识库的核心工具——它可作为检索层的“智能大脑”，连接Obsidian、Notion等存储工具，通过自然语言交互实现知识的快速录入、关联与查询。
OpenClaw
1043 2
HaoU
|
3月前
|
人工智能 Cloud Native API
从零到一：如何通过 OpenClaw 快速构建企业级专属 AI Agent 指南
阿里云OpenClaw是云原生大模型应用开发平台，提供低代码编排、强大RAG引擎、弹性架构与丰富插件，助企业快速构建深度耦合业务数据的专属AI Agent，降低大模型应用开发门槛。
HaoU
609 0
公有云小学生
|
2月前
|
存储 缓存 自然语言处理
从零搭建企业私有知识库：RAG + 大模型实战（附完整代码）
本文详解如何用RAG技术构建企业私有知识库：支持PDF/TXT/DOCX等文档上传、向量化存储与智能问答，让大模型精准理解业务数据，兼顾数据隐私、领域专业性与实时性，附完整代码与部署方案。
公有云小学生
4209 1
问号云
|
1月前
|
人工智能 Linux API
Hermes Agent/OpenClaw（阿里云/Win11/Mac/Linux）部署+集成公众号 API /小红书 Skill 实战喂饭级指南
“运营一个自媒体账号已经够累，还要兼顾公众号、小红书多个平台，每天写内容、发笔记、回评论，根本忙不过来”——这是无数自媒体人的日常困境。2026年，OpenClaw（昵称“小龙虾”）的自动化能力彻底改变了这一现状：通过对接公众号官方API与小红书浏览器自动化Skill，搭建起一套“选题→创作→发布→互动”全流程自动化系统，实现24小时内容生产与多平台矩阵运营，人只需负责定方向、调策略，执行层全由AI完成。
问号云
542 2
OpenClaw
|
3月前
|
存储 Linux API
OpenClaw 个人智能知识库完全指南：second-brain 搭建、全平台部署与大模型API配置教程
在信息爆炸的日常工作与学习中，绝大多数人都会遇到知识碎片化、存储分散、检索困难、难以复用的问题。读书笔记、会议纪要、灵感碎片、文档资料散落在备忘录、电脑文件夹、笔记软件、纸质记录中，想要调取某条信息时往往需要花费大量时间翻找，甚至彻底遗忘。OpenClaw 生态中的 **second-brain（第二大脑）** 插件，正是为解决这一问题而生的轻量化知识管理工具。它可以将所有类型的信息统一收纳、语义理解、自动关联、智能检索，无需手动分类，依靠AI实现“所想即所得”。本文基于 2026 年最新使用流程，完整讲解 second-brain 的安装、配置、使用方法，同时补充阿里云云端部署、MacOS/
OpenClaw
2909 0

热门文章

最新文章

  • 1
    .NET Core多平台开发体验[4]: Docker
  • 2
    如何在 Ubuntu 24.04 LTS 上安装 SSH 服务器？
  • 3
    浅谈GPU虚拟化技术（五）：GPU图形渲染虚拟化的业界难题-VDI的用户体验
  • 4
    【项目笔记】：elementui下拉框数据太多造成页面卡顿怎么解决？
  • 5
    鲲鹏开发重点––ARM CPU的推测执行
  • 6
    Index alias — Elastic Stack 实战手册
  • 7
    IIS发生意外错误0x8ffe2740
  • 8
    手动注入PHP
  • 9
    环境搭建、部署备忘
  • 10
    sns研究 初步研究.粗看.
  • 1
    2026年阿里云618年中大促全攻略：AI加速季，年度低价云服务器推荐指南
    80
  • 2
    零基础入门教程：阿里云 Hermes Agent 一键部署完整流程详解（图文版）
    52
  • 3
    LLM增强的网易云API部署用于鸿蒙原生音乐app: Melotopia
    45
  • 4
    多智能体集群审计机制设计：免疫、熔断与信誉治理
    44
  • 5
    面试官问：什么是 Harness 工程？AI Agent 时代，测试人必须补上的新能力
    61
  • 6
    我如何用Skills-RAG构建企业级测试知识库，新人上手自动化只需1天
    40
  • 7
    保姆级教学！阿里云服务器从零搭建Hermes Agent AI智能体配置Token Plan流程
    37
  • 8
    超详细实操指南：阿里云ECS服务器从零部署 OpenClaw 配置APIKEY、运维一站式教程
    44
  • 9
    高校第三方外包平台数据泄露风险与防御体系研究
    33
  • 10
    语音钓鱼结合无文件攻击的 M365 数据勒索防御研究
    37

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    阿里云正式发布 Agentic 代码安全：AI驱动的双Agent协同引擎