OpenClaw 学习小组：初识

OpenClaw 是一个开源、自托管的 AI Agent 网关。你可以直接在聊天软件中给 AI 发任务,让它完成代码、检索、浏览器操作与自动化流程。

核心架构

rust 复制代码

聊天渠道 -> Gateway -> Agent -> LLM API

Gateway ：统一连接渠道、管理会话、路由任务。
Agent： 执行任务的 AI 实体,可读写文件、执行命令、调用工具。
Skill： 能力扩展模块,可按业务场景组合。
LLM ****API ：大模型 API 调用

典型场景

在飞书、钉钉里让 AI 直接修项目 bug。
上传数据文件后自动生成分析结果。
通过浏览器自动化完成网页查询与回传截图。
定时抓取信息并推送到群聊。

一、安装前环境配置

OpenClaw 主流操作系统都支持，但对硬件和软件环境有一定要求：

最低配置：

CPU: 2核心
内存: 4GB RAM
存储: 10GB 可用空间
操作系统: Linux (Ubuntu 20.04+), macOS (12+), Windows 10/11 (with WSL2)

推荐配置：

CPU: 4核心或更多
内存: 8GB RAM 或更多
存储: 20GB SSD
稳定的网络连接（用于 API 调用）

对于生产环境部署，建议使用至少 8GB 内存和 4 核 CPU，以确保多 Agent 并发执行时的稳定性。如果你计划使用浏览器自动化功能，内存需求会更高（建议 16GB）。

1.1 Node.js 环境

可以从 Node.js 官网下载安装包，或使用 nvm-windows。Claw 需要 Node.js 18 或更高版本。推荐使用 LTS 版本：

bash 复制代码

 # 检查当前 Node.js 版本
node --version

# 使用 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

# 验证安装
node --version  # 应显示 v20.x.x
npm --version   # 应显示 10.x.x

1.2 Docker 安装（windows推荐）

Docker 是运行 OpenClaw 最简单的方式，避免了复杂的依赖配置：

shell 复制代码

 # macOS 和 Windows: 下载 Docker Desktop# https://www.docker.com/products/docker-desktop# Linux (Ubuntu) 安装
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 验证安装
docker --version
docker compose version

# 配置用户权限（Linux） sudo usermod -aG docker $USER # 需要重新登录以生效

对于生产环境，建议使用 Docker Compose 进行部署，这样可以更方便地管理配置和数据持久化。

1.3 安装 Git

csharp 复制代码

 # 安装 Git（如果尚未安装）# macOS
brew install git

# Ubuntu/Debiansudo apt-get update
sudo apt-get install git

# 验证安装
git --version

1.4 LLM API 密钥准备

Claw 的核心功能依赖于大语言模型 API。你需要至少准备一个 LLM 提供商的 API 密钥。

1.4.1 加入我们（推荐）

只需 199/人，加入开源实验室 OpenClaw 小组 ，可享终身服务：指导安装 + 使用教学 + 问题解答 + 赠送一个月使用 token 不限量。

1.4.2 国产模型提供商

大部分模型都有免费额度可以使用，比如字节火山引擎、kimi、minimax 等等，可以注册以后薅免费额度。但注意别用超了，OpenClaw 比较费 token。

1.4.3 本地模型（可选）

如果你担心成本或隐私问题，可以使用本地模型：

bash 复制代码

 # 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取模型
ollama pull llama3.1:8b
ollama pull qwen2.5-coder:7b

# 验证运行
ollama run llama3.1:8b "Hello!"

本地模型的优势是零 API 成本和完全的数据隐私，但需要更强的硬件配置（至少 16GB RAM 用于 7B 模型）。

1.5 消息平台账号

根据你的需求，准备以下平台的机器人账号：

Telegram Bot (需科学上网)

在 Telegram 中找到 @BotFather
发送 /newbot 创建新机器人
按提示设置机器人名称和用户名
保存 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

bash 复制代码

 # 测试 Bot Token
curl "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe"

飞书(推荐)

使用飞书开放平台，搭建自己的机器人open.feishu.cn

创建机器人，设置基本信息
开通权限
配置长链接

二、安装部署

🚀 最简单的方式：一行命令安装

Windows 用户

打开 PowerShell（右键开始菜单 → 选择"Windows PowerShell"）
复制下面这行命令，粘贴进去，按回车：

arduino 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

Mac / Linux 用户

打开终端（Mac 按 Cmd+空格，输入 terminal）
复制下面这行命令，粘贴进去，按回车：

arduino 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

⏳ 等待安装完成

首次安装可能需要 3-5 分钟
耐心等待，不要关闭窗口
看到 Done! 或类似提示就是成功了

📋 安装后第一步：配置向导

安装完成后，终端会提示你进行配置，按照步骤来：

1️⃣ 选择语言

输入 1 或直接回车，选择 English

2️⃣ 选择模型（最重要的一步！）

这里选一个免费的模型开始：

模型	特点	推荐
MiniMax	🇨🇳 中文免费额度多	✅ 新手推荐
Kimi	🇨🇳 中文好用	✅ 新手推荐
OpenAI	🌐 英文更好	进阶用户

💡 新手建议 ：选 MiniMax 或 Kimi，国内访问快，有免费额度

3️⃣ 输入 API Key

如果选 MiniMax：去 platform.minimaxi.com 注册账号 → 创建 API Key → 粘贴进来
如果选 Kimi：去 kimi.com 注册 → 获取 API Key

4️⃣ 选择聊天工具

暂时不选，跳过这一步（输入 4 或选择 Skip）

5️⃣ 完成！

看到成功提示后，在浏览器打开：http://127.0.0.1:18789
如果能打开，说明安装成功！🎉

❓ 常见问题汇总

Q1: 安装命令找不到？

解决方法：

bash 复制代码

# Mac/Linux 打开终端，输入：
source ~/.bashrc

# Windows 重新打开 PowerShell

Q2: 安装过程卡住了？

检查网络是否稳定
尝试切换手机热点
可能是 npm 官方源慢，配置国内源：

arduino 复制代码

npm config set registry https://registry.npmmirror.com

Q3: 安装完成打不开网页？

确保电脑和手机在同一 WiFi 下
检查防火墙是否阻止
尝试换个浏览器（Chrome/Edge）

Q4: 提示端口被占用？

bash 复制代码

# 查看哪个程序占用了端口
lsof -i :18789

# 如果不确定，直接换端口：
openclaw gateway --port 19000

Q5: 收到报错信息看不懂？

复制错误信息
在群里问 or 百度/Google 搜索
或者直接截图发到群里求助

💡 补充说明

什么是 API Key？

就像进入游乐园的门票
每个 AI 服务商（MiniMax/Kimi/OpenAI）都需要单独申请
免费额度一般够用几个月

后续如何使用？

保持终端运行（或者设置开机自启）
在飞书/Telegram/微信里发消息给机器人
它就会帮你干活了！

arduino 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

arduino 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

如果只想安装、不立即进入向导：

perl 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

perl 复制代码

 # 确保 Node.js 22+
node --version

# 全局安装 OpenClaw
npm install -g openclaw@latest

# 运行配置向导（同时安装守护进程）
openclaw onboard --install-daemon

bash 复制代码

docker pull openclaw/openclaw:latest

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=sk-ant-xxx \
  openclaw/openclaw:latest

lua 复制代码

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

如果 openclaw dashboard 能正常打开，说明网关已可用。

常见问题

命令找不到

bash 复制代码

npm prefix -g
export PATH="$(npm prefix -g)/bin:$PATH"

sharp 编译失败（macOS 常见）

ini 复制代码

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

端口冲突

css 复制代码

lsof -i :18789
openclaw gateway --port 19000

网关无法启动

css 复制代码

openclaw doctor
openclaw doctor --fix
openclaw logs --follow

🔥 OpenClaw 学习小组｜终身学习·一次加入·永久服务

想轻松玩转 OpenClaw，却被安装、使用、问题难住？

现在无需摸索、不用踩坑，299 元终身加入，全程一站式护航！

👑 终身专属服务

• ✅ 一对一指导安装，零基础也能轻松上手

• ✅ 全套使用教学，从入门到精通

• ✅ 每周实操，案例分享

• ✅ 永久问题解答，随问随答不等待

• ✅ 赠送1 个月使用 token 不限量，畅快体验无压力

💰 仅需 299 元/人

一次付费，终身受益，省去反复摸索时间，高效掌握 OpenClaw 全技能！

为保证体验，名额仅限 15 人，先到先得，即刻开启高效学习之旅～