（一）OpenClaw 安装配置指南（详细图文版）

文档目的

本文档旨在帮助新人从零开始安装和配置 OpenClaw，包含详细的步骤说明和实际截图，按照文档操作即可完成完整部署。

1. 准备工作

1.1 系统要求

• 操作系统：macOS Sonoma 或更新版本

• 硬件：Apple Silicon M1 及以上芯片（推荐）

• 网络：稳定的网络连接

• 权限：管理员权限（用于安装软件）

1.2 工具准备

• 终端：macOS 自带的终端应用

• Node.js：版本 18.0 或更高

• npm：版本 9.0 或更高

2. 安装 Node.js

2.1 下载 Node.js

1. 访问 Node.js 官网

2. 点击 “macOS 安装程序（.pkg）” 下载

Node.js 官网下载页面

3. 打开下载的安装包，按照提示完成安装

2.2 验证 Node.js 安装

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

# 检查 npm 版本
npm --version

实际输出：

v22.22.0
10.9.4

3. 安装 OpenClaw

3.1 方法一：npm 全局安装（推荐）

打开「终端」，在终端内输入：

# 全局安装 OpenClaw
sudo npm i -g openclaw

然后回车，输入开机密码后再回车；

注意：如果出现 Git 下载错误，执行以下命令后重新安装：

git config --global url."https://github.com/".insteadOf ssh://git@github.com/

3.2 方法二：一键安装脚本

# 使用 curl 执行一键安装脚本

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

3.3 完全卸载现有安装

1. 完全卸载现有安装

# 停止服务
openclaw gateway stop

# 备份重要数据（如果需要）
cp -r /Users/用户名/.openclaw /Users/用户名/.openclaw.backup.$(date +%Y%m%d_%H%M%S)

# 删除所有配置和数据
rm -rf /Users/用户名/.openclaw
rm -rf /Users/用户名/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw

# 先强制卸载现有的
sudo npm uninstall -g openclaw

# 清理缓存
sudo npm cache clean --force

# 重新安装
git config --global url."https://github.com/".insteadOf ssh://git@github.com/

sudo npm install -g openclaw@latest

2. 重新安装OpenClaw

# 使用curl安装（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash

# 或者使用npm安装
sudo npm install -g openclaw@latest

3. 安装完成
   

3.4 验证安装

# 检查 OpenClaw 版本
openclaw --version

实际输出：

2026.3.2

4. 初始化配置（openclaw init）

4.1 运行初始化向导

# 启动初始化向导

openclaw onboard

配置步骤：

1. 风险提示：按向左方向键 ← 选择 Yes，按 Enter 确认
   

2. 模式选择：选择 QuickStart（快速开始），按 Enter 确认
   

3. 模型提供商：选择 Custom（手动配置），按 Enter 确认
   

4. 配置自定义提供商：输入供应商API Key后按 Enter 确认

• Provider name: custom-dashscope-coding-lite

• Base URL: https://coding.dashscope.aliyuncs.com/v1

• API Key: 输入你的 API Key

• API type: openai-completions

5. 配置模型：

• Default model ID: qwen-max

• Model display name: Qwen Max

• Context window: 32000

• Max tokens: 8000

也可以先跳过，后续再配置

这里供应商选择：custom-dashscope-coding-lite

6. 默认模型：直接按 Enter 使用默认值
   

7. 配置 channel,这里可先跳过，后续单独配置
   

8. Skills配置也可以先跳过或按需选择
   

9. 选择Hooks模式，可以全选或后续配置
   

10. 网关服务安装与配置
    

11. 选择以Web UI方式打开（也可以选择TUI以终端方式打开）
    

12. 安装完成，浏览器自动打开 Web UI 界面

5. 配置网关

5.1 启动网关

# 启动网关
openclaw gateway start

# 查看网关状态
openclaw gateway status

### 5.2 安装网关为系统服务（可选）
```bash
# 安装网关为系统服务
openclaw gateway install

5.3 网关访问信息

• 本地地址：http://127.0.0.1:18789/

6. 参考资源

如果在安装配置过程中遇到问题，可以参考：

• 官方文档：https://docs.openclaw.ai/
• 项目地址：https://openclaw.ai/
• GitHub：https://github.com/openclaw/openclaw
• 技能市场：https://clawdhub.com
• 社区：https://discord.com/invite/clawd