2026年AI编程神器：OpenClaw完全安装指南（Mac/Windows/Linux）

“我花了3小时配置AI开发环境，同事用OpenClaw 10分钟搞定…”

这是我上周的真实经历。

作为一个全栈开发者，我试过Cursor、Windsurf、GitHub Copilot，但OpenClaw是我用过最灵活的AI编程工具。

为什么？

• 它不是一个封闭的IDE，而是AI Agent平台
• 支持多模型（GPT-4、Claude、Kimi、Gemini）
• 可以自定义工具链（MCP、Skills、Cron）
• 最重要的是：免费开源

今天这篇，手把手教你从0到1安装配置OpenClaw。

————————

01 OpenClaw是什么？

一句话定义

OpenClaw = AI Agent + 工具集成 + 自动化工作流

对比传统AI编程工具

| 工具 | 类型 | 限制 | 价格 |
| **Cursor** | 封闭IDE | 只能用内置功能 | $20/月 |
| **Windsurf** | 封闭IDE | 生态有限 | $15/月 |
| **GitHub Copilot** | 代码补全 | 只做代码补全 | $10/月 |
| **OpenClaw** | **开放平台** | **无限制** | **免费** |

核心能力

“`

AI对话

↓

工具调用（文件操作、浏览器、API）

↓

自动化（Cron定时任务）

↓

多Agent协作

“`

简单说：你告诉它要做什么，它自动帮你完成。

————————

02 安装前准备

系统要求

| 系统 | 版本 | 备注 |
| **macOS** | 11+ (Big Sur) | Intel/Apple Silicon |
| **Windows** | 10/11 | WSL2推荐 |
| **Linux** | Ubuntu 20.04+ | 其他发行版参考 |

必需依赖

1. Node.js 18+

“`bash

检查版本

node –version  # 需要 v18.0.0 或更高

如果版本低，安装nvm管理

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

nvm install 20

nvm use 20

“`

2. Git

“`bash

git –version  # 需要 2.30+

“`

3. Python 3.9+（可选，某些技能需要）

“`bash

python3 –version

“`

————————

03 Mac安装教程

步骤1：安装OpenClaw CLI

“`bash

使用npm全局安装

npm install -g openclaw

验证安装

openclaw –version

输出：openclaw/2026.2.12

“`

步骤2：初始化配置

“`bash

运行配置向导

openclaw configure

按照提示输入：

1. 选择模型提供商（OpenAI/Anthropic/Moonshot等）

2. 输入API Key

3. 选择工作区目录

“`

步骤3：启动Gateway（核心服务）

“`bash

启动本地服务

openclaw gateway start

检查状态

openclaw gateway status

输出：Gateway is running on http://localhost:18789

“`

步骤4：配置环境变量

“`bash

编辑配置文件

nano ~/.zshrc

添加以下内容

export OPENCLAW_TOKEN=”your-gateway-token”

export OPENAI_API_KEY=”sk-xxx”  # 如果使用OpenAI

export ANTHROPIC_API_KEY=”sk-ant-xxx”  # 如果使用Claude

生效

source ~/.zshrc

“`

步骤5：测试安装

“`bash

发送测试消息

openclaw send “Hello, OpenClaw!”

如果看到回复，说明安装成功！

“`

————————

04 Windows安装教程

推荐方式：WSL2（Windows Subsystem for Linux）

为什么用WSL2？

• OpenClaw在Linux环境下最稳定
• 避免Windows路径问题
• 与Mac/Linux开发体验一致

步骤1：安装WSL2

“`powershell

以管理员身份运行PowerShell

wsl –install

重启电脑

设置Ubuntu用户名密码

“`

步骤2：在WSL2中安装

“`bash

进入WSL2

wsl

接下来的步骤和Mac完全一样

sudo apt update

sudo apt install -y nodejs npm git

安装OpenClaw

npm install -g openclaw

配置

openclaw configure

“`

原生Windows安装（备选）

“`powershell

安装Node.js（官网下载安装包）

https://nodejs.org/

安装OpenClaw

npm install -g openclaw

注意：Windows需要使用PowerShell或Git Bash

“`

————————

05 Linux安装教程

Ubuntu/Debian

“`bash

安装依赖

sudo apt update

sudo apt install -y nodejs npm git

如果Node版本低，使用nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

source ~/.bashrc

nvm install 20

安装OpenClaw

npm install -g openclaw

配置

openclaw configure

openclaw gateway start

“`

CentOS/RHEL

“`bash

安装Node.js

sudo yum install -y nodejs npm

或者使用nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

nvm install 20

安装OpenClaw

npm install -g openclaw

“`

————————

06 配置模型API（关键步骤）

获取API Key

| 提供商 | 注册地址 | 免费额度 |
| **OpenAI** | platform.openai.com | $5试用 |
| **Anthropic** | console.anthropic.com | $5试用 |
| **Moonshot** | platform.moonshot.cn | 15元免费 |
| **Google** | makersuite.google.com | 免费 |

配置多模型

“`bash

编辑配置文件

openclaw config edit

添加多个模型

{

“models”: {

“openai”: {

“apiKey”: “sk-xxx”,

“default”: “gpt-4”

},

“anthropic”: {

“apiKey”: “sk-ant-xxx”,

“default”: “claude-3-opus-20240229”

},

“moonshot”: {

“apiKey”: “sk-xxx”,

“default”: “kimi-k2.5”

}

}

}

“`

测试模型

“`bash

使用特定模型

openclaw chat –model openai/gpt-4

openclaw chat –model anthropic/claude-3-opus

openclaw chat –model moonshot/kimi-k2.5

“`

————————

07 配置Skills（进阶）

什么是Skills？

Skills = OpenClaw的插件系统，让AI获得新能力。

常用Skills：

• `file`：文件操作
• `web`：网页访问
• `browser`：浏览器控制
• `mcp`：外部工具集成

安装Skills

“`bash

查看可用skills

openclaw skills list

安装file技能

openclaw skills install file

安装web技能

openclaw skills install web

安装browser技能（需要Playwright）

npx playwright install

openclaw skills install browser

“`

测试Skills

“`bash

测试文件操作

openclaw run “读取~/Documents/test.txt文件内容”

测试网页访问

openclaw run “访问https://github.com/trending并总结”

测试浏览器

openclaw run “打开浏览器，访问https://news.ycombinator.com”

“`

————————

08 配置消息通道（可选）

为什么要配置？

让AI能通过微信/飞书/Slack/Telegram与你互动。

配置飞书（示例）

“`bash

1. 在飞书开放平台创建应用

https://open.feishu.cn/

2. 获取App ID和App Secret

3. 配置OpenClaw

openclaw channel add feishu

4. 输入App ID和Secret

5. 扫描Webhook二维码绑定

“`

配置微信（需要企业微信）

“`bash

openclaw channel add wechat-work

按照提示配置企业微信应用

“`

配置Telegram（最简单）

“`bash

openclaw channel add telegram

输入Bot Token（从@BotFather获取）

“`

————————

09 常见问题解决

问题1：安装失败，权限不足

“`bash

使用sudo

sudo npm install -g openclaw

或者修改npm全局目录权限

sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules

“`

问题2：Gateway启动失败，端口被占用

“`bash

查看占用端口的进程

lsof -i :18789

杀死进程

kill -9 <PID>

或者修改端口

openclaw config set gateway.port 18888

“`

问题3：模型回复超时

“`bash

增加超时时间

openclaw config set timeout 120000  # 120秒

检查API Key是否正确

openclaw config get models.openai.apiKey

“`

问题4：Skills无法加载

“`bash

重新安装skills

openclaw skills reinstall all

检查依赖

openclaw doctor

“`

————————

10 第一个AI任务

安装完成后，测试这个完整工作流：

“`bash

1. 让AI读取本地文件

openclaw run “读取README.md，总结项目内容”

2. 让AI访问网页

openclaw run “访问https://news.ycombinator.com，找出前3个技术话题”

3. 让AI写代码

openclaw run “创建一个Python脚本，实现简单的HTTP服务器”

4. 让AI自动化

openclaw cron add “每天9点检查邮件并总结”

“`

如果以上都能正常运行，恭喜你，OpenClaw安装成功！

————————

11 进阶配置

自定义工作区

“`bash

创建工作区

mkdir ~/openclaw-workspace

cd ~/openclaw-workspace

初始化Git

git init

配置OpenClaw使用该目录

openclaw config set workspace ~/openclaw-workspace

“`

配置Sub-agents

“`bash

创建专门处理代码的agent

openclaw agent create coder –model codex/gpt-5.2-codex

创建专门处理文档的agent

openclaw agent create writer –model anthropic/claude-3-opus

使用特定agent

openclaw agent use coder

openclaw run “帮我写一个React组件”

“`

————————

12 总结

安装 checklist

• [ ] Node.js 18+ 安装完成
• [ ] OpenClaw CLI 安装完成
• [ ] Gateway 启动成功
• [ ] API Key 配置完成
• [ ] 至少一个Skill安装成功
• [ ] 第一个AI任务运行成功

下一步学习

1. 阅读官方文档：https://docs.openclaw.ai
2. 加入Discord社区：https://discord.gg/clawd
3. 探索Skills市场：https://clawhub.com
4. 自定义你的第一个Skill