从零开始学 Agent

写给国内小白的完整教程。从挂 VPN、装环境、到跑起你的第一个 Agent， 每一步都有详细解释。每个命令都告诉你用 cmd 还是 PowerShell。

以 OpenClaw 为例 · 阅读约 15 分钟
① 先装好 Agent ▸ 💻 本地部署 或 ☁️ 云部署 ▸ ② 再装本站技能 & MCP
先在这俩部署方式里选一个装好 Agent，再去学习第三个安装本站技能。

本地部署就是把 OpenClaw 装在你的个人电脑上。优点是 免费、数据安全， 缺点是电脑关机 Agent 就停了。适合先体验、试用的用户。

💡 你需要准备什么？ 一台 Windows 10/11 电脑 + 能上网 + 愿意花 20 分钟跟着做。

第一步：网络环境

国内访问 GitHub 和部分 AI 服务需要网络工具。安装全过程需要能正常访问外网。

准备一个 VPN / 加速器

如果你已经有能用的梯子，跳过这一步。如果没有：

  • 搜索"代理加速器"、"VPN"（推荐有免费试用期的）
  • 或者用 WATT (Watt Toolkit，原名 Steam++)，免费开源，能加速 GitHub
  • 装好后，确认能打开 github.com
⚠️ 注意 本文不会推荐具体哪家 VPN。你需要一个能稳定访问外网的工具，这是所有后续操作的前提。

第二步：安装 Node.js

OpenClaw 是一个 Node.js 应用，所以先装 Node.js 这个"底层运行环境"。

下载 Node.js 安装包

  1. 打开浏览器，访问 https://nodejs.org
  2. 页面会自动推荐适合你系统的版本，点击绿色的 LTS 按钮下载
  3. 下载完成后，双击安装包（.msi 文件）

安装 Node.js

  1. 启动安装程序后，一直点 Next（下一步）
  2. 到 License Agreement 页面，勾上 I accept，点 Next
  3. 安装路径保持默认（C:\Program Files\nodejs\），点 Next
  4. 最后点 Install，等待安装完成（大概 1~2 分钟）
PowerShell cmd —— 两种都可以，选一个你喜欢的
✅ 验证是否装成功 打开任意命令行工具（推荐按 Win+R → 输入 powershell → 回车），输入： 
node --version
如果看到类似 v20.x.x 这样的输出，说明 Node.js 安装成功。
→ 如果提示"node 不是内部或外部命令"，重新启动电脑再试。

第三步：安装 OpenClaw

打开命令行终端

下面所有命令都需要在命令行里输入。不知道怎么打开？看页面左边「常用工具」区域。

推荐用 PowerShell（比传统 cmd 功能更多）：

  • 按键盘 Win + R → 输入 powershell → 回车
  • 或者右键开始菜单 → 选择"Windows PowerShell"

一行命令安装 OpenClaw

PowerShell —— 请用 PowerShell，别用 cmd

在 PowerShell 中输入下面这行，然后按回车：

npm install -g openclaw

这条命令是什么意思？

  • npm — Node.js 自带的"包管理器"，就像手机里的应用商店
  • install — 意思是"安装"
  • -g — 全局安装（装完后在任何目录下都能用）
  • openclaw — 要装的东西的名字

安装过程需要 1~3 分钟，取决于你的���速。装的时候会有一些提示文字滚动，不用管，等它结束就行。

⚠️ 常见问题 如果安装过程中出现红色的错误（比如 ERR!、ETIMEDOUT），
最常见的原因是 网络问题——检查你的 VPN / 加速器是否已打开，确保能访问 github.com。

验证是否安装成功

PowerShell cmd 
openclaw --version

如果看到版本号（例如 2026.5.28），恭喜，OpenClaw 安装成功！

如果提示openclaw 不是内部或外部命令，说明安装没成功，回到上一步重新运行安装命令。

配置 AI 模型（最关键的一步）

OpenClaw 本身只是一个"壳"，它需要连接一个 AI 模型才能工作。配置方法：

PowerShell 
openclaw config set model gpt-4o-mini
openclaw config set provider openai
openclaw config set api-key 你的API密钥

这三条命令分别做什么？

  • model — 要用的 AI 模型的名字（如 GPT-4o、Claude、DeepSeek 等）
  • provider — 模型来自谁家（如 openai、anthropic、deepseek）
  • api-key — 你的"钥匙"，去对应官网申请（下面会教）
⚠️ API Key 去哪里拿？ 1. 打开浏览器去 platform.openai.com
2. 注册账号（可能需要国外手机号）
3. 右上角点 API keys → Create new secret key
4. 把生成的那一串字符复制下来，粘贴到上面命令的位置

国内用户推荐 DeepSeek（便宜、速度快、不需要 VPN）：
去 platform.deepseek.com 注册 → API keys → 创建 → 复制密钥，然后把上面的命令改成： 
openclaw config set model deepseek-chat
openclaw config set provider deepseek
openclaw config set api-key 你的DeepSeek密钥

第四步：启动并使用

启动 OpenClaw

PowerShell cmd 
openclaw

输入上面命令回车后，OpenClaw 会启动一个漂亮的聊天界面（TUI）。

你现在可以直接在终端里和 AI Agent 对话了！试试问它：

💬 试试看 输入：帮我搜索一下有什么好用的翻译工具

安装更多技能（扩展 Agent 的能力）

PowerShell cmd

OpenClaw 的能力来自"技能包"。安装新技能的命令：

openclaw skill install 技能名称

比如：

openclaw skill install translate
openclaw skill install pdf-reader
openclaw skill install web-search

也可以去 技能市场 浏览所有技能，找到想要的，复制安装命令即可。

第五步：用 OpenClaw 安装更多 Agent 工具

到这里，你已经装好了 Node.js 和 npm（包管理器）——这两个东西就像手机里的"应用商店"。有了它们，你能安装的不只是 OpenClaw，还有 Hermes Agent、Claude Code 等一整套 AI Agent 工具。

方法完全一样：打开 PowerShell（或 cmd），输入 npm install -g 工具名，回车。

下面是三种最流行的 Agent 工具的安装步骤——选你感兴趣的装：

🤖 Hermes Agent 推荐

功能最全的全能 Agent，支持 Telegram/QQ 聊天、定时任务、技能市场、多 Agent 协作。可以理解为 OpenClaw 的"进阶版"。

安装步骤：

① 打开 PowerShell

② 粘贴下面这行，按回车：

npm install -g hermes-agent

③ 验证安装：

hermes --version

④ 配置 AI 模型：

hermes config set model gpt-4o-mini hermes config set provider openai hermes config set api-key 你的API密钥

⑤ 启动：

hermes
💡 Hermes 和 OpenClaw 可以同时存在，互不干扰。你甚至可以让 Hermes 调用 OpenClaw 的技能。

🟣 Claude Code

Anthropic（Claude 的母公司）出品的代码 Agent。特别擅长写代码、改代码、调试 Bug。适合程序员。

安装步骤：

① 打开 PowerShell

② 安装：

npm install -g @anthropic/claude-code

③ 验证：

claude --version

④ 配置 API Key：

claude config set api-key 你的Anthropic密钥

⑤ 使用（在某个项目目录下运行）：

claude
💡 需要去 console.anthropic.com 注册获取 API Key。Claude Code 默认在项目里工作，帮你看代码、改代码。

��� Codex CLI

OpenAI 出品的代码 Agent，类似 Claude Code 但用的是 GPT 模型。也适合写代码。

安装步骤：

① 打开 PowerShell

② 安装：

npm install -g @openai/codex

③ 验证：

codex --version

④ 使用（在项目目录下运行）：

codex
💡 需要 OpenAI API Key。如果你已经有 ChatGPT 的账号，可以直接用同一个 Key。
📖 核心逻辑 以上所有工具的安装方式 一模一样：
① 确保 Node.js 已安装（你刚才已经装了）→ ② 打开 PowerShell → ③ 输入 npm install -g 工具名 → ④ 配 API Key → ⑤ 启动。
学会了装 OpenClaw，就等于学会了装所有 Agent 工具。区别只在于工具名不同、API Key 去不同网站申请。

常见问题

Q: 安装时出现 ERR! code EPERM 错误

原因：Windows 权限不够。
解决：右键点击 PowerShell 图标 → 选择"以管理员身份运行" → 重新输入刚才的命令。

Q: openclaw 命令找不到

原因：全局安装没成功。
解决：先检查 Node.js 是否装好（node --version），然后重新运行 npm install -g openclaw。

Q: API Key 是什么？在哪里拿？

API Key 就是一把"钥匙"，AI 公司用它来确认你是谁、扣你的使用费。
去 OpenAI / DeepSeek / 通义千问 等平台的官网注册，在后台找到"API Keys"页面创建。
国内用户推荐：DeepSeek（便宜、速度快、不用梯子）。

Q: 换了电脑，已安装的技能还需要重新装吗？

是的。技能包装在本地电脑上，换电脑需要重新安装。所以如果你需要长期稳定使用，推荐用云部署方案，任何电脑都能连上去用。

Q: OpenClaw 和 Hermes Agent 有什么区别？我该用哪个？

OpenClaw 轻量、简单，适合刚入门的用户。
Hermes Agent 功能更多，支持 Telegram 聊天、定时任务、多 Agent 协作，适合进阶用户。
建议都试试，选自己顺手的。它们可以同时安装，互不影响。

🎉 教程结束了，但你才刚刚开始。
去 技能市场 逛逛，看看有哪些技能能帮到你。 有任何问题，直接在社区提问。

云部署是把 OpenClaw 运行在一台云服务器上。优点是可以 24 小时在线、 随时用手机远程连接。适合长期使用的用户。

💡 你需要准备什么？ 一台云服务器（最低 2 核 2G） + 每月几十块预算 + 一点耐心。

第一步：选购云服务器

🏠 国内云厂商（推荐新手）

  • 阿里云 / 腾讯云 / 华为云
  • 2 核 2G 轻量服务器 ≈ 40~60 元/月
  • 无需 VPN，国内直接访问
  • 选 Ubuntu 22.04 系统

🌍 国外云厂商

  • DigitalOcean / Vultr / AWS Lightsail
  • $6~12/月，需外币信用卡
  • 可能需要 VPN 才能访问
  • Ubuntu 22.04 LTS 最省心

购买流程大致是这样的：

  • 注册云厂商账号 → 实名认证 → 选择"轻量应用服务器" → 选 Ubuntu 系统 → 付款
  • 购买成功后，你会得到一个 IP 地址（一串数字，像 123.123.123.123）和 root 密码
  • 把这两样东西记下来，下一步要用

第二步：连接服务器

连接服务器需要用 SSH 工具。不知道怎么连？看页面左边「常用工具」的 SSH 说明。

下载 SSH 工具（选一个）

  • Termius — 推荐！图形界面，好看又好用，去官网下载免费版
  • PuTTY — 老牌工具，轻量但界面比较 old school
  • 直接用 PowerShell — 不用装任何东西，Windows 自带

登录服务器

SSH 终端 PowerShell

打开你的终端工具（推荐直接用 PowerShell），输入：

ssh root@你的服务器IP

比如你买的服务器 IP 是 123.123.123.123，就输入：

ssh root@123.123.123.123

然后：

  • 第一次连接会提示确认密钥，输入 yes 按回车
  • 然后输入你在云厂商控制台设置的 服务器密码（输入时屏幕上不显示字符是正常的，尽管输入完按回车）
✅ 登录成功标志 看到类似 root@服务器名:~# 的提示符，说明你成功连上服务器了。后面你就可以在服务器上输命令了。
⚠️ 如果连不上 检查：① IP 是否输对 ② 服务器是否已开机 ③ 云厂商后台有没有设置"放行 22 号端口"（一般默认开放）

第三步：安装基础环境

更新系统包

SSH 终端

把服务器上的软件包更新到最新版本：

apt update && apt upgrade -y

解释：

  • apt update — 更新软件列表（检查有哪些新版软件）
  • apt upgrade -y — 升级所有已安装的包（-y 表示自动确认，不用你手动输 yes）

这个过程可能需要 1~3 分钟。

安装 Node.js

SSH 终端 
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs

装完验证：

node --version

看到 v20.x.x 即成功。

第四步：安装并配置 OpenClaw

全局安装 OpenClaw

SSH 终端 
npm install -g openclaw

安装完后验证：

openclaw --version

配置 AI 模型

SSH 终端 
openclaw config set model gpt-4o-mini
openclaw config set provider openai
openclaw config set api-key sk-你的密钥

（国内用户推荐用 DeepSeek：model=deepseek-chat, provider=deepseek）

启动 OpenClaw（保持长期运行）

SSH 终端

这里和本地部署不一样——服务器上没有界面给你看，所以需要让程序在后台静默运行：

nohup openclaw > openclaw.log 2>&1 &

这条命令是什么意思？

  • nohup — "no hang up"的缩写，意思是退出 SSH 后程序继续在后台跑
  • > openclaw.log — 把程序的日志信息保存到文件里，方便以后查看
  • 2>&1 — 错误信息也写到同一个日志文件
  • & — 放到后台运行（这样你能继续输其他命令）

查看运行状态

SSH 终端

检查 OpenClaw 是否在跑：

ps aux | grep openclaw

如果输出里有一行带 openclaw 的（不是 grep 那一行），说明它在正常运行。

查看日志（看看有没有报错）：

tail -f openclaw.log

按 Ctrl + C 退出日志查看。按 Ctrl + D 退出 SSH 连接。

第五步：用 OpenClaw 安装更多 Agent 工具

既然你在服务器上已经有了 Node.js 和 npm，安装其他 Agent 工具和在本地电脑上完全一样。区别只在于：你现在是在 SSH 终端里输命令。

通用步骤（所有 Agent 都是同一套流程）：

  • ① 确定你已经连上了服务器（看到 root@服务器:~# 提示符）
  • ② 输入 npm install -g 工具名 回车
  • ③ 配置 API Key
  • ④ 用 nohup 让它在后台跑

🤖 云上安装 Hermes Agent

SSH 终端

步骤 1 — 安装：

npm install -g hermes-agent

步骤 2 — 验证：

hermes --version

步骤 3 — 配置：

hermes config set model gpt-4o-mini hermes config set provider openai hermes config set api-key 你的API密钥

步骤 4 — 后台运行：

nohup hermes > hermes.log 2>&1 &
💡 想看日志：tail -f hermes.log（Ctrl+C 退出）

🟣 云上安装 Claude Code

SSH 终端

步骤 1 — 安装：

npm install -g @anthropic/claude-code

步骤 2 — 验证：

claude --version

步骤 3 — 配置：

claude config set api-key 你的Anthropic密钥

步骤 4 — 在项目里用它：

cd /root/my-project claude
💡 Claude Code 适合在代码项目里用，不是一直后台跑的。需要交互时 SSH 连上去启动它。

🔶 云上安装 Codex CLI

SSH 终端

步骤 1 — 安装：

npm install -g @openai/codex

步骤 2 — 验证：

codex --version

步骤 3 — 使用：

cd /root/my-project codex
💡 和 Claude Code 类似，适合在项目目录下交互使用。
📖 一句话总结云上装 Agent 和本地安装唯一的区别是：本地用 PowerShell，云上用 SSH 终端。
其他完全一样——npm install -g 工具名 是世界上所有 Agent 工具的通用安装方式。

安装更多技能

OpenClaw 装完后，你可以安装各种技能来扩展它的功能。技能就是一个个"插件"，让 Agent 能做翻译、搜网页、读 PDF 等等。

在 Agent Hub 市场找到想要的技能

PowerShell cmd SSH

去 Agent Hub 技能市场，有 5,000+ 个技能。找到你感兴趣的，点击进入详情页，复制安装命令。

粘贴安装命令到终端

在 PowerShell（本地部署）或 SSH 终端（云部署）中粘贴并回车：

openclaw skill install 技能名称

比如装 PDF 阅读器：

openclaw skill install pdf-reader

查看已安装的技能

openclaw skill list

搜索技能（不用去市场）

openclaw skill search 翻译

直接在命令行搜索你想要的技能。

学会了这些命令，你就能随意扩展你的 Agent 了。想装什么装什么。

🎉 云部署完成！
现在你的 Agent 是 24 小时在线的。关掉电脑、关掉手机，它仍然在云服务器上跑着。 任何时候想用它，SSH 连上去就行，或者通过 Telegram / QQ 等平台远程交互。

前两节你已经装好了 OpenClaw（或 Hermes Agent）。现在来学最重要的一步： 如何从 Agent Hub 市场安装 Skills 和 MCPs，让你的 Agent 真正有用。

✅ 在开始之前 请确保你已按照前面「本地部署」或「云部署」的教程，成功安装并验证了 OpenClaw。
如果你还没装，先去上面两个选项卡完成安装，再回来看这节。

第一步：确认你的 Agent 能正常工作

在装技能之前，先确认 Agent 本体是好的。打开你的终端（PowerShell / SSH），输入：

确认 OpenClaw 已安装

PowerShell cmd SSH 
openclaw --version

看到版本号（如 2026.5.28），说明安装成功。

如果提示openclaw: command not found，说明没装好，请回到「本地部署」或「云部署」选项卡重新安装。

确认能正常启动

PowerShell SSH

输入以下命令启动 OpenClaw（如果是云服务器，启动后按 Ctrl+C 退出，用 nohup 保持后台运行）：

openclaw

你应该能看到一个带颜色的聊天界面，最下面有个输入框，可以在里面打字。

✅ 到这里，你的 Agent 已经准备好了 按 Ctrl+C 退出聊天界面（如果是本地部署），我们接下来装技能。
云部署用户退出后记得用 nohup openclaw > openclaw.log 2>&1 & 让它后台跑。

第二步：打开 Agent Hub 市场

打开浏览器，访问你的 Agent Hub 网站。如果你是本地搭建的：

http://localhost:3016/

然后点击 「探索技能市场」，或者直接点右下角的导航点翻到第三页。

你会看到这样的页面：

📖 市场上的内容 市场里目前有 5,445 个技能，分为两大类型：
· Skill（技能包）— 让你的 Agent 能做特定事情（翻译、写小说、查股票等）
· MCP（模型上下文协议工具）— 让 Agent 能连接外部工具（GitHub、数据库、浏览器等）
两者区别：Skill 是"能力"，MCP 是"工具连接器"。一般先装 Skill，需要时再装 MCP。

第三步：找到你想安装的技能

在市场页面，有几种方式找到你想要的技能：

方式一：分类浏览

翻到第四页（分类排行页），左边有技能分类列表：

  • 小说创作 — 写网文、爽文、剧本
  • 公众号运营 — 写公众号文章、排版、配图
  • 交易策略 — 加密货币分析、自动交易
  • 高考志愿 — 填志愿、查学校分数线
  • 数据科学 — 数据分析、可视化
  • 创意设计 — 生图、设计、视频
  • ……以及更多

方式二：搜索

在市场页面的顶部有搜索框，输入关键词就能搜。比如：

  • 搜 翻译 — 找到翻译技能
  • 搜 GitHub — 找到 GitHub MCP
  • 搜 小说 — 找到小说创作技能

支持中文、英文、拼音混合搜索，不用担心输入法问题。

方式三：排行榜

在分类排行页右侧，有下载量排行榜、好评排行榜、今日推荐，可以直接选热门的装。

第四步：安装技能

找到你想要的技能后，点击它的名字进入详情页。

在详情页找到安装命令

每个技能的详情页右上角都有一个 安装命令 区域，会显示类似这样的命令：

openclaw skill install 技能名称

比如安装翻译技能，会显示：

openclaw skill install translate

旁边有个 复制 按钮，点击就能复制到剪贴板。

打开终端，粘贴并执行

PowerShell SSH

打开你的终端工具：

  • 本地部署用户 — 打开 PowerShell
  • 云部署用户 — 通过 SSH 连上服务器

在终端中粘贴刚才复制的命令，按回车：

openclaw skill install translate

安装过程会显示进度，通常几秒钟就装好了。

验证安装成功

PowerShell cmd SSH

查看已安装的技能列表：

openclaw skill list

如果列表中出现了你刚装的技能，说明安装成功 ✅

💬 试试看 启动 OpenClaw（openclaw），然后对它说：帮我把这段话翻译成英文

第五步：安装 MCP（工具连接器）

MCP 的安装方式跟 Skill 不太一样。MCP 需要配一下配置文件，但不用担心，每一步都有说明。

📖 什么是 MCP？ MCP（Model Context Protocol）是让 Agent 能连接外部服务的"桥梁"。 装了 MCP 后，你的 Agent 就能操作 GitHub、查数据库、浏览网页、控制浏览器等。 可以把 MCP 理解为 Agent 的"USB 接口"。

找到想要的 MCP

在市场页面的分类中，找到 MCP/工具 分类，点击进去能看到所有可用的 MCP。比如：

  • Web Search MCP — 让 Agent 能上网搜索
  • GitHub MCP — 让 Agent 操作 GitHub
  • Filesystem MCP — 让 Agent 读写本地文件
  • 浏览器自动化 MCP — 让 Agent 控制浏览器

用 openclaw 命令安装 MCP

PowerShell SSH

在详情页复制安装命令，在终端中执行：

openclaw mcp install web-search

这条命令会自动下载 MCP 并配置好。

验证 MCP 是否装上

PowerShell cmd SSH 
openclaw mcp list

如果列表中出现了你装的 MCP，说明安装成功。重新启动 OpenClaw 后就能用新 MCP 的功能了。

第六步：用 Agent 自动安装技能

如果你觉得手动复制粘贴太麻烦，也可以直接让 Agent 帮你安装。在 OpenClaw 的聊天界面里，直接对它说：

💬 直接对你的 Agent 说：
帮我安装一个翻译技能
帮我装一个 GitHub MCP
搜索一下有哪些好用的写作技能

Agent 会自动去市场搜索、安装、并告诉你结果。整个过程不需要你手动输命令。

比如你第一次启动 OpenClaw 后，可以直接在聊天界面输入：

你：帮我安装翻译技能
Agent：正在搜索"翻译"相关技能……
      找到：translate（★★★★☆ 翻译技能）
      正在安装……
      安装成功！✅ 现在你可以对我说"帮我把这句话翻译成英文"
💡 小技巧 如果你不知道有什么技能好用，直接问 Agent：
帮我在市场里搜索一下热门技能
推荐几个适合新手的 MCP

第七步：动手试试——安装几个热门技能

按照上面学到的步骤，试着装几个最常用的技能：

🌐 Web Search MCP

让 Agent 能上网搜索信息。装了之后，你的 Agent 就不再只是个"聊天机器人"，而是能查实时信息。

openclaw mcp install web-search
装完后重启 OpenClaw，试试问它"今天比特币多少钱"

📄 PDF 阅读器 Skill

让 Agent 能读取 PDF 文件的内容。适合需要分析文档的用户。

openclaw skill install pdf-reader
装完后给 Agent 发一个 PDF 文件，让它帮你总结

💹 股票查询 Skill

查股票行情、历史数据、公司信息。适合关注投资的人。

openclaw skill install stocks
装完后问 Agent "茅台今天多少钱"

📝 小说创作 Skill

写网文、小说、剧本的全套工具。适合写作者。

openclaw skill install novel-writing
装完后说"帮我写一个重生题材的开头"

常见问题

Q: 安装技能时报错"not found"

原因：技能名称拼错了，或者这个技能不存在于当前市场。
解决：去市场用搜索功能确认技能名称，复制粘贴最准确。

Q: 安装 MCP 后 Agent 还是不能用

原因：MCP 装完后需要重启 Agent 才能加载。
解决：退出 OpenClaw（Ctrl+C），重新运行 openclaw 启动。

Q: Skill 和 MCP 有什么区别？到底装哪个？

Skill（技能包） = 给 Agent 增加"新能力"（翻译、写小说、查股票）
MCP（工具连接器） = 让 Agent 能连接"外部工具"（浏览器、数据库、GitHub）
简单判断：想做一件事（如翻译）→ 装 Skill；想连一个外部服务（如 GitHub）→ 装 MCP。

Q: 装太多技能会不会卡？

不会。技能只有在用到的时候才会加载。一般装几十个都没问题。如果发现启动变慢，可以用 openclaw skill list 查看已装技能，openclaw skill uninstall 技能名 卸载不用的。

Q: 我该装哪家的 MCP？看到市场上有重复的

优先选 下载量高、评分高 的。同一功能的 MCP 可能有多家实现，选最热门的一般没错。

🎉 学会了！现在你的 Agent 已经真正"武装"起来了。
去 技能市场 逛逛，把感兴趣的一个个装上试试。 有问题直接问你的 Agent——它自己就会教你怎么用。