OpenClaw 学习小组：初识

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

核心架构

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

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

典型场景

1. 在 飞书、钉钉里让 AI 直接修项目 bug。

2. 上传数据文件后自动生成分析结果。

3. 通过浏览器自动化完成网页查询与回传截图。

4. 定时抓取信息并推送到群聊。

一、安装前环境配置

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 版本：

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

# 使用 nvm 安装（推荐）
curl -o-  | bash
nvm install 20
nvm use 20

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

1.2 Docker 安装（windows推荐）

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

 # macOS 和 Windows: 下载 Docker Desktop#  Linux (Ubuntu) 安装
curl -fsSL  -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

 # 安装 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 本地模型（可选）

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

 # 安装 Ollama
curl -fsSL  | sh

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

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

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

1.5 消息平台账号

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

T@elegrimm Bot (需科穴上网)

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

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

飞书(推荐)

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

1. 创建机器人，设置基本信息

2. 开通权限

3. 配置长链接

二、安装部署

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

Windows 用户

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

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

Mac / Linux 用户

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

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

⏳ 等待安装完成

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

安装后第一步：配置向导

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

1️⃣ 选择语言

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

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

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

3️⃣ 输入 API Key

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

4️⃣ 选择聊天工具

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

5️⃣ 完成！

• 看到成功提示后，在浏览器打开：
• 如果能打开，说明安装成功！

常见问题汇总

Q1: 安装命令找不到？

解决方法：

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

# Windows 重新打开 PowerShell

Q2: 安装过程卡住了？

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

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

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

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

Q4: 提示端口被占用？

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

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

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

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

补充说明

什么是 API Key？

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

后续如何使用？

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

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

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

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

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

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

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

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

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

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

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

常见问题

命令找不到

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

sharp 编译失败（macOS 常见）

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

端口冲突

lsof -i :18789
openclaw gateway --port 19000

网关无法启动

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

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

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

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

终身专属服务

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

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

• 每周实操，案例分享

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

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

仅需 299 元/人

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

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