跳转至

Ai基础概念

欢迎来到 AI 智能体的世界！在部署 OpenClaw 和 本地大模型（如 Ollama）的过程中，你可能会遇到许多陌生的计算机术语。 别担心，这份文档专为零基础用户设计。我们将用通俗易懂的比喻，为你梳理这些核心概念，助你轻松跨越技术门槛。

计算机概念

终端 / 命令行 (Terminal / Command Line)

  • 是什么：一个黑底白字的窗口，你通过输入文字命令来指挥电脑，而不是用鼠标点击图标。
  • 比喻：就像是对电脑下达“语音指令”的对话框。虽然看起来有点极客，但它是最直接、最强大的控制方式。
  • 在部署中：你需要在这里输入 git clone 或 docker run 等指令来下载和启动程序。

Git & GitHub

  • 是什么：
  • Git：一种版本控制工具，用来管理代码的变更。
  • GitHub：全球最大的代码托管平台（类似“代码界的百度网盘”）。
  • 比喻：
  • GitHub 是图书馆，存放着 OpenClaw 的源代码。
  • Git 是图书管理员，帮你把书（代码）从图书馆借（clone）到你的电脑上。
  • 在部署中：你用 git clone 命令从 GitHub 把 OpenClaw 的项目文件下载到本地。

Node.js & npm/pnpm

  • 是什么：
  • Node.js：让 JavaScript 语言能在电脑后台运行的环境（不仅仅是浏览器里）。
  • npm/pnpm：包管理器，用来安装项目需要的各种小零件（依赖库）。
  • 比喻：
  • Node.js 是房子的地基和电力系统，没有它，用 JS 写的程序跑不起来。
  • npm 是五金店，OpenClaw 需要螺丝、电线（依赖包），你就去店里买回来装好。
  • 在部署中：如果你选择源码部署 OpenClaw，必须先安装它们，然后运行 npm install 来安装所有必要的组件。

Docker & 容器 (Container)

  • 是什么：一种轻量级的虚拟化技术，能把软件和它运行所需的所有环境打包在一起。
  • 比喻：“集装箱”。
  • 以前装软件像搬家，容易丢三落四（缺环境、版本不对）。
  • 现在用 Docker，整个房间（系统环境+软件）被塞进一个标准集装箱里。无论你的电脑是 Mac 还是 Windows，只要有个吊车（Docker 引擎），就能-把这个集装箱原封不动地运起来运行。
  • 在部署中：强烈推荐新手使用 Docker。它能避免“在我电脑上能跑，在你那就不行”的问题，而且更安全（容器坏了不影响主机）。

环境变量 (.env 文件)

  • 是什么：一组配置信息，告诉程序如何运行（比如 API Key、端口号、允许访问的目录）。
  • 比喻：“私房钱袋子”或“设置菜单”。
  • 程序启动时会偷偷看这个袋子里的纸条，知道该连哪个服务器、密码是多少，而不需要把这些敏感信息写在代码里。
  • 在部署中：你需要复制 .env.example 为 .env，并在里面填入你的 API Key 和个人偏好设置。

API & API Key & Secret

  • 是什么：
  • API：应用程序接口，不同软件之间对话的通道。
  • API Key：一把数字钥匙，证明你有权限使用这个通道。
  • API Secret (私钥/密码)：一串绝密的字符，用来证明“我真的是我”，通常用于生成安全签名。
  • 比喻：
  • API 是餐厅的点餐窗口。你（OpenClaw）不能直接进厨房（模型服务器），必须通过窗口递单子。
  • API Key 是你的VIP 会员卡。没卡，窗口不接待你；卡泄露了，别人会刷你的额度。
  • API Secret 是你的取款密码或动态令牌。
    • 绝对机密：你永远不会把密码告诉别人，也不会把它写在明信片上。
    • 工作原理：当你需要取钱（调用接口）时，银行系统会用你的密码生成一个一次性的“动态验证码”（签名）。你把“卡号 (Key)” + “动态码”给柜员，柜员验证通过后才会让你操作。
    • 为什么需要它：如果只有卡号 (Key)，坏人捡到后可以直接冒充你。有了 Secret，即使坏人知道了卡号，因为没有密码，他也无法生成正确的动态验证码，从而无法通过验证。
  • 在部署中：如果你用云端模型（如 Claude, GPT-4），必须在 .env 文件里填入正确的 API Key，OpenClaw 才能连上大脑。

⚠️关于secret

  • 简单模式：很多简单的 AI 服务（如早期的 OpenAI 用法）只给你一个 sk-xxxx 这样的 Key，它其实融合了身份和秘密的功能，一旦泄露，别人就能直接用你的额度。
  • 高级模式：更严谨的服务（如 AWS、部分国内大模型平台）会给你一对 Access Key ID (相当于 Key) 和 Secret Access Key (相当于 Secret)。
  • ⚠️ 重要警告：在配置 OpenClaw 的 .env 文件时，无论是单纯的 API Key 还是成对的 Secret，都必须像保护银行卡密码一样保护它们！
  • ❌ 不要截图发朋友圈。
  • ❌ 不要上传到 GitHub 代码库。
  • ✅ 只保存在本地的 .env 文件中，并确保该文件不被公开。

向量数据库 (Vector Database)

  • 是什么：一种专门存储“语义信息”的数据库，能让 AI 通过意思而不是关键词来搜索内容。
  • 比喻：“按意思归档的智能书架”。
  • 传统数据库：你搜“苹果”，它只找包含“苹果”两个字的书。
  • 向量数据库：你搜“好吃的水果”，它也能把“苹果”、“香蕉”找出来，因为它懂它们的含义相似。
  • 在部署中：OpenClaw 用它来存你的历史对话和文档知识库，让 AI 拥有“长期记忆”，记得你上周说过的话。

🧠 第二部分：AI 大脑篇

LLM (Large Language Model, 大语言模型)

  • 是什么：经过海量文本训练的超级人工智能，能理解并生成人类语言。
  • 比喻：“博学的实习生”。
  • 它读过互联网上几乎所有的书，懂很多知识，能写文章、写代码、做翻译。但它有时会“一本正经地胡说八道”（幻觉）。
  • 在部署中：OpenClaw 本身只是个空壳（身体），你需要给它连接一个 LLM（大脑），它才能思考。

本地模型 (Local Model) & Ollama

  • 是什么：
  • 本地模型：把大模型文件下载到你自己电脑的硬盘上运行，不需要联网发给大公司。
  • Ollama：一个专门用来在本地轻松运行大模型的工具软件。
  • 比喻：
  • 云端模型：打电话给远方的专家咨询（要花钱，数据要传出去）。
  • 本地模型：把专家请到你家里住下（一次性下载，数据不出门，免费但吃自家粮食/硬件）。
  • Ollama：专家的管家，负责照顾专家的起居（加载模型、处理请求），你只需要跟管家说话。
  • 在部署中：为了隐私，你可以安装 Ollama，下载一个模型（如 qwen2.5），然后让 OpenClaw 连接本地的 Ollama 服务。

推理 (Inference)

  • 是什么：模型根据输入内容，计算并生成回答的过程。
  • 比喻：“思考过程”。
  • 当你问问题时，显卡（GPU）或处理器（CPU）开始高速运转，这就是在进行“推理”。
  • 在部署中：本地部署时，推理速度取决于你的电脑配置。如果电脑太旧，AI 回答一个字可能要憋半天（推理延迟高）。

上下文窗口 (Context Window)

  • 是什么：模型一次能记住的对话长度上限（包括你说的话、它说的话、以及背景资料）。
  • 比喻：“短期记忆力”。
  • 窗口小（如 4k）：聊久了它就忘了开头说了什么，像金鱼记忆。
  • 窗口大（如 128k）：它能记住整本书的内容或几个小时的聊天记录。
  • 在部署中：选择模型时要注意这个参数。如果任务很长（如分析长篇文档），需要选上下文大的模型，否则 AI 会“断片”。

🔒 第三部分：安全与运行篇（保驾护航）

沙箱 (Sandbox)

  • 是什么：一个隔离的运行环境，限制程序能访问的资源。
  • 比喻：“儿童游乐区的围栏”。
  • 孩子在围栏里（沙箱）随便玩都没事，但出不去，不能跑到马路上（系统核心区域）捣乱。
  • 在部署中：OpenClaw 默认在沙箱（如 Docker 容器或限制目录）中运行。即使 AI 发疯想删系统文件，也会被围栏挡住，只能删围栏里的玩具。

权限 (Permissions)

  • 是什么：操作系统规定谁（用户或程序）能做什么（读、写、执行）。
  • 比喻：“门禁卡”。
  • 有的卡只能进客厅（读文件），有的卡能进卧室修改布置（写文件），有的卡能开保险柜（执行命令）。
  • 在部署中：你必须小心配置 OpenClaw 的权限。千万不要给它“管理员/root”权限，只给它操作特定工作文件夹的权限。

端口 (Port)

  • 是什么：电脑上网络通信的“门牌号”。不同的服务监听不同的端口。
  • 比喻：“公寓楼的房间号”。
  • 网页服务通常住在 80 或 443 号房。
  • OpenClaw 的界面可能住在 3000 号房。
  • Ollama 住在 11434 号房。
  • 在部署中：你在浏览器输入 localhost:3000，就是敲 3000 号房门找 OpenClaw。如果两个程序抢同一个房间号（端口冲突），就会报错。