三分钟搭建你的第一个 OpenClaw Agent:从零到＂龙虾上线＂保姆级教程

> 📌 导读

> OpenClaw 登顶 GitHub 全球热榜第一，26万+星标。但很多人卡在了"怎么装"这一步。本文手把手教你用最简单的方式，3分钟搭建你的第一个 AI Agent。零编程基础也能搞定。截图+命令，一步一图，包教包会。

一、准备工作：你需要什么？

在开始之前，确保你手上有这三样东西：

序号	准备项	说明
1️⃣	Node.js ≥ 22	OpenClaw 的运行基础
2️⃣	一个 AI 模型 API Key	推荐 Claude/GPT/DeepSeek/通义千问
3️⃣	一台电脑	macOS / Windows / Linux 都行

1.1 检查 Node.js 版本

打开终端，输入：

node -v

如果显示 v22.x.x 或更高，你可以直接跳到第二步。

如果版本太低或没装，继续看：

macOS / Linux 推荐用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bashnvm install 22nvm use 22

Windows 推荐去官网下载安装包：

> https://nodejs.org/zh-cn/

下载 LTS 版本（22.x），双击安装即可。

1.2 获取 AI 模型 API Key

OpenClaw 本身不带模型，需要你自备"大脑"。

推荐选择：

模型	获取地址	特点
DeepSeek V3	platform.deepseek.com	国内最快、最便宜
Claude 3.5	console.anthropic.com	推理能力最强
通义千问	dashscope.console.aliyun.com	国内稳定、中文友好
GPT-4o	platform.openai.com	全球标杆

拿到 Key 后先存好，下面要用。

二、正式安装：两条命令搞定

2.1 macOS / Linux 安装

打开终端，依次输入：# 第一步：运行官方一键安装脚本curl -fsSL https://openclaw.ai/install.sh | sh# 第二步：验证安装成功openclaw --version如果看到 🦞 OpenClaw 2026.x.x，恭喜你，安装成功！

2.2 Windows 安装

以管理员身份打开 PowerShell：

# 设置执行策略（允许运行脚本）Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser# 运行一键安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex# 验证安装成功openclaw --version

看到龙虾图标和版本号，就说明装好了。

三、快速初始化：5分钟配置完成

3.1 一键初始化

openclaw init

这个命令会：

创建配置文件目录（~/.openclaw/）
生成默认配置文件
安装后台服务

3.2 配置 API Key

用你喜欢的编辑器打开配置文件：

# macOS / Linuxnano ~/.openclaw/config.yaml# Windowsnotepad %USERPROFILE%\.openclaw\config.yaml

找到 providers 部分，填入你的 API Key：

providers:  anthropic:    apiKey: "你的Claude API Key"  openai:    apiKey: "你的OpenAI API Key"  deepseek:    apiKey: "你的DeepSeek API Key"models:  default: "claude-3-5-sonnet"

💡 小贴士： 推荐设置 DeepSeek 为默认，性价比最高。

3.3 启动网关服务

openclaw gateway start

看到 Gateway 在线 字样，就说明服务启动成功。

四、连接聊天平台：让 Agent 随叫随到

OpenClaw 的强大之处在于：它能接入你常用的聊天软件。

目前支持的平台：

平台	状态	说明
✅ Telegram	完全支持	最稳定，推荐优先用
✅ Discord	完全支持	开发者最爱
✅ 微信	已支持	需额外配置
✅ 飞书	已支持	企业用户友好
✅ WhatsApp	已支持	海外用户首选
✅ Slack	已支持	团队协作首选

4.1 以 Telegram 为例（最简单）

第一步：创建 Telegram Bot

在 Telegram 搜索 @BotFather
发送 /newbot
按提示命名你的 Bot
获得 Bot Token（类似 123456789:ABCdefGHI...）

第二步：配置 OpenClaw

编辑配置文件：

channels:  telegram:    enabled: true    token: "你的Bot Token"

第三步：重启服务

openclaw gateway restart

现在，打开 Telegram，给你的 Bot 发一条消息，它就会回复你！

五、安装第一个 Skill：让你的 Agent 会干活

光会聊天还不够，我们要让它真正帮你做事。

5.1 什么是 Skill？

Skill = OpenClaw 的能力插件。

就像 iPhone 需要 App，OpenClaw 需要 Skill 才能干活。

5.2 安装一个实用的 Skill

# 安装浏览器操控 Skillopenclaw skill install browser# 安装文件处理 Skill  openclaw skill install filesystem# 安装日程管理 Skillopenclaw skill install calendar

5.3 试试效果

在 Telegram 里给你的 Bot 发：

> "帮我搜索一下今天 AI 领域有什么大新闻"

它会自动打开浏览器 → 搜索 → 整理结果 → 发送给你。

这就是 AI Agent 的威力！

六、进阶：打造你的专属 Agent

6.1 创建自定义 Agent

openclaw agent create my-assistant

6.2 编辑 Agent 配置

agents:  my-assistant:    name: "我的小助手"    model: "claude-3-5-sonnet"    skills:      - browser      - filesystem      - calendar    systemPrompt: |      你是我的私人助手，帮我处理日常事务。      遇到不确定的事情先问我，不要自作主张。

6.3 指定 Agent 对话

在 Telegram 中发送：

@my-assistant 帮我整理一下这周的待办事项

七、常见问题 FAQ

Q1：安装过程中报错怎么办？

90% 的问题都是网络问题。 尝试：

# 切换国内镜像源npm config set registry https://registry.npmmirror.com# 清除缓存重试npm cache clean --forceopenclaw init

Q2：API Key 填了但不生效？

检查格式，确保：

Key 用引号包裹
YAML 缩进正确
没有多余的空格

Q3：Telegram Bot 没反应？

检查 Token 是否正确
确认 Gateway 在运行：openclaw status
查看 Gateway 日志：openclaw gateway logs

Q4：Windows 上 PowerShell 报权限错误？

确保以管理员身份运行 PowerShell，然后执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

八、下一步推荐

恭喜你，已经拥有了自己的 AI Agent！

接下来可以：

方向	建议资源
深入理解架构	官方文档：docs.openclaw.ai
学习 Skill 开发	GitHub：github.com/openclaw/skill-examples
加入社区讨论	Discord：discord.gg/openclaw
看更多教程	搜索"OpenClaw 教程"持续更新中

> 📌 本文要点（3秒速览）

> 1. 准备工作：Node.js ≥ 22 + 一个 AI 模型 API Key

> 2. 安装只需两条命令（macOS/Linux 或 Windows）

> 3. 初始化用 openclaw init，配置 API Key

> 4. 连接 Telegram/飞书等平台，让 Agent 随叫随到

> 5. 安装 Skill 让 Agent 真正干活

> 6. 遇到问题先检查网络和配置格式

💬 互动话题：

你搭建成功了吗？遇到了什么问题？评论区留言，我来帮你解决！