一、前言

这篇文章，我会手把手带你从 0 开始，完整搭建一个可用的 OpenClaw 环境。

全程不超过 30 分钟，包含：

• ✅ 环境准备（Windows/Mac/Linux）

• ✅ 安装步骤（详细截图）

• ✅ 配置文件详解

• ✅ API Key 获取教程

• ✅ 常见问题排查

建议收藏，跟着步骤一步步来。

二、环境要求

系统要求

前置依赖

必须安装：

• Node.js 18+（推荐 20+）

• npm 9+（随 Node.js 一起安装）

可选：

• Git（用于版本管理）

• VS Code（编辑配置文件）

检查环境

打开终端（Windows 用 PowerShell，Mac/Linux 用 Terminal），运行：

# 检查 Node.js 版本node-v# 检查 npm 版本npm-v

预期输出：

v22.20.010.9.2

如果版本过低，请先升级 Node.js。

三、安装步骤

步骤 1：安装 OpenClaw

打开终端，运行：

npm install -g openclaw

Windows 用户注意：

• 如果提示权限错误，用管理员身份运行 PowerShell

• 或者添加 --force 参数：npm install -g openclaw --force

预期输出：

added 150 packages in 15s25 packages are looking for funding  run `npm fund` for details

步骤 2：验证安装

openclaw --version

预期输出：

openclaw/1.x.x (node/v22.20.0)

步骤 3：初始化工作区

# 创建工作区（默认在用户目录）openclaw init# 或者指定工作区路径openclaw init -p D:\my-openclaw-workspace

执行后会创建以下结构：

~/.openclaw/├── workspace/│   ├── SOUL.md           # 人格配置│   ├── USER.md           # 用户信息│   ├── MEMORY.md         # 长期记忆│   ├── HEARTBEAT.md      # 心跳任务│   ├── TOOLS.md          # 工具配置│   └── memory/           # 每日日志目录├── config.yaml           # 主配置文件└── logs/                 # 日志目录

四、配置文件详解

4.1 配置文件位置

4.2 完整配置示例

# ==================== 模型配置 ====================models:# 默认模型（推荐用 Qwen，代码能力强）  default: qwen-portal/coder-model# Qwen（通义千问）- OAuth 认证，无需 API Key  qwen:    alias: qwen    provider: qwen-portal    model: coder-model# Groq - 超快推理速度  groq:    alias: groq    provider: groq    model: llama3-70b-8192    api_key: ${GROQ_API_KEY}# DeepSeek - 性价比之选  deepseek:    alias: deepseek    provider: deepseek    model: deepseek-chat    api_key: ${DEEPSEEK_API_KEY}# 智谱 AI - 中文场景优化  zhipu:    alias: zhipu    provider: zhipu    model: glm-4-flash    api_key: ${ZHIPU_API_KEY}# ==================== 技能配置 ====================skills:  enabled:    - weather          # 天气查询    - healthcheck      # 安全审计    - mcporter         # MCP 工具调用    - clawhub          # 技能市场    - skill-creator    # 技能开发# ==================== 会话配置 ====================sessions:  default_thinking: off      # 默认关闭推理模式  default_model: qwen-portal/coder-model# ==================== 记忆配置 ====================memory:  enabled: true              # 启用记忆系统  daily_notes: true          # 自动创建每日日志  long_term: MEMORY.md       # 长期记忆文件# ==================== 其他配置 ====================workspace:  path: C:/Users/EDY/.openclaw/workspacelogging:  level: info               # debug/info/warn/error  file: logs/openclaw.log

4.3 关键配置说明

五、API Key 获取教程

5.1 各厂商 API Key 申请地址

5.2 详细申请步骤（以 DeepSeek 为例）

步骤 1：注册账号

1. 访问 https://platform.deepseek.com

2. 点击"注册"，用手机号或邮箱注册

3. 完成实名认证（需要身份证）

步骤 2：创建 API Key

1. 登录后进入"控制台"

2. 点击左侧"API Keys"

3. 点击"创建 API Key"

4. 复制生成的 Key（只显示一次，妥善保存）

步骤 3：配置到 OpenClaw

方法 1：直接写入配置文件

models:  deepseek:    api_key: sk-xxxxxxxxxxxxxxxxxxxx

方法 2：使用环境变量（推荐）

# Windows PowerShell$env:DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"# Mac/LinuxexportDEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"# 或写入 .env 文件DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx

5.3 国内访问优化

部分厂商官网在国内访问较慢，建议：

1. 使用镜像站（如果有）

2. 配置代理（合规渠道）

3. 选择国内厂商（Qwen/智谱/DeepSeek）

六、启动与验证

6.1 启动 OpenClaw

openclaw start

预期输出：

🚀 OpenClaw 启动中...✅ 配置文件加载成功✅ 工作区初始化完成✅ 已加载 5 个技能📊 默认模型：qwen-portal/coder-model💬 准备就绪！可以通过以下方式对话：- Web: http://localhost:3000- Discord: 配置 webhook- Telegram: 配置 bot token

6.2 测试对话

启动后，访问 http://localhost:3000，发送一条消息：

你好，做个自我介绍

预期回复：

你好，我是尘风，你的 AI 助手。我可以帮助你：- 查询天气、日历、邮件- 管理文件和代码- 自动化日常任务- 更多技能可通过 clawhub 安装今天想做什么？

6.3 检查状态

openclaw status

预期输出：

📊 OpenClaw 状态版本：1.x.x工作区：C:\Users\EDY\.openclaw\workspace默认模型：qwen-portal/coder-model已加载技能：5✅ 配置正常✅ 模型连接正常✅ 工作区可写

七、常见问题排查

问题 1：npm install 失败

错误信息：

npm ERR! code EACCESnpm ERR! permission denied

解决方案：

# Windows：用管理员身份运行 PowerShell# Mac/Linux：添加 sudosudonpm install -g openclaw# 或者修改 npm 默认目录npm config set prefix ~/.npm-global

问题 2：openclaw 命令找不到

错误信息：

'openclaw' 不是内部或外部命令

解决方案：

Windows：

# 添加 npm 全局目录到 PATH$env:Path+=";C:\Users\<用户名>\AppData\Roaming\npm"# 永久添加：系统属性 → 环境变量 → Path → 新建

Mac/Linux：

# 添加到 ~/.bashrc 或 ~/.zshrcexportPATH=$PATH:~/.npm-global/bin# 使配置生效source ~/.bashrc

问题 3：模型连接失败

错误信息：

❌ 模型连接失败：qwen-portal/coder-model

排查步骤：

1. 检查网络连接

2. 检查 API Key 是否正确

3. 检查模型是否已配置

4. 查看日志：cat logs/openclaw.log

临时方案：切换到其他模型

openclaw model use groq

问题 4：工作区权限错误

错误信息：

❌ 无法写入工作区：Permission denied

解决方案：

# Windowsicacls "C:\Users\<用户名>\.openclaw\workspace" /grant <用户名>:F# Mac/Linuxchmod-R755 ~/.openclaw/workspace

问题 5：技能加载失败

错误信息：

⚠️ 技能加载失败：weather

排查步骤：

1. 检查技能是否存在：ls skills/

2. 检查 SKILL.md 是否完整

3. 重新安装技能：openclaw skill install weather

八、下一步

安装配置完成后，建议：

1️⃣ 配置你的 MEMORY.md

编辑 ~/.openclaw/workspace/MEMORY.md，添加：

• 你的基本信息

• 工作偏好

• 技术栈

• 常用工具

这样 AI 才能真正"记住"你。

2️⃣ 配置心跳任务

编辑 ~/.openclaw/workspace/HEARTBEAT.md，添加：

• 每日邮件检查

• 日历提醒

• 模型额度监控

让 AI 主动为你工作。

我们下期见！👋