OpenClaw 完全上手指南：从安装到第一个 AI 辅助项目

什么是 OpenClaw？

OpenClaw 是一款基于 AI 的开源智能编程助手，运行在终端环境中，类似于 Claude Code，旨在为开发者提供强大的 AI 辅助编程体验。与基于 GUI 的 IDE 插件不同，OpenClaw 以终端为家，能够深度集成到你的命令行工作流中。

OpenClaw 的核心特点：

• 完全开源，支持本地部署
• 支持连接多种 AI 后端（OpenAI、Anthropic、本地模型）
• 深度理解项目上下文，支持多文件编辑
• 内置 Git 集成，智能生成提交消息
• 跨平台支持：macOS、Windows、Linux

系统要求

在安装之前，请确保你的系统满足以下要求：

• Node.js：18.0 或更高版本
• npm / pnpm / yarn：任意一种包管理器
• Git：2.x 或更高版本
• 操作系统：macOS 12+、Windows 10+、Ubuntu 20.04+

macOS 安装步骤

方式一：通过 npm 全局安装（推荐）

# 安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

方式二：通过 Homebrew 安装（macOS 专属）

# 添加 OpenClaw tap
brew tap mbluostudio/openclaw

# 安装
brew install openclaw

# 验证
openclaw --version

Windows 安装步骤

方式一：通过 npm 安装

在 PowerShell（管理员模式）中运行：

# 安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

方式二：通过 winget 安装

winget install MbluoStudio.OpenClaw

Linux 安装步骤

# Ubuntu/Debian
curl -fsSL https://openclaw.dev/install.sh | bash

# 或通过 npm
npm install -g openclaw

# 验证安装
openclaw --version

基本配置

安装完成后，首次运行需要进行初始化配置：

openclaw init

你将看到如下交互式配置界面：

🐾 Welcome to OpenClaw v2.3.0

? Select AI provider:
  ❯ Anthropic (Claude)
    OpenAI (GPT)
    Local Model (Ollama)
    Custom API

? Enter your API key: sk-ant-...

? Select default model:
  ❯ claude-sonnet-4-5
    claude-opus-4
    claude-haiku-3-5

✅ Configuration saved to ~/.openclaw/config.json

配置文件详解

配置文件位于 ~/.openclaw/config.json，你也可以手动编辑：

{
  "provider": "anthropic",
  "apiKey": "sk-ant-...",
  "model": "claude-sonnet-4-5",
  "maxTokens": 8192,
  "temperature": 0.7,
  "systemPrompt": "",
  "gitIntegration": true,
  "autoCommit": false,
  "language": "zh-CN"
}

项目级配置

在项目根目录创建 .openclaw 文件，可以设置项目特定的配置，覆盖全局设置：

{
  "model": "claude-opus-4",
  "systemPrompt": "你是一位 React 专家，请用 TypeScript 编写代码，遵循项目的 ESLint 规范。",
  "context": ["src/**/*.ts", "src/**/*.tsx", "package.json"]
}

第一次使用：Hello OpenClaw

配置完成后，让我们用一个简单的示例来体验 OpenClaw 的威力。

创建测试项目

mkdir my-first-openclaw-project
cd my-first-openclaw-project
git init
npm init -y

启动 OpenClaw

openclaw

你将进入 OpenClaw 的交互式终端界面：

🐾 OpenClaw v2.3.0
📁 Project: my-first-openclaw-project
🤖 Model: claude-sonnet-4-5
💬 Type your request or /help for commands

>

你的第一个 AI 请求

> 帮我创建一个简单的 Node.js HTTP 服务器，监听3000端口，返回 "Hello, OpenClaw!"

OpenClaw 会分析你的请求，并生成代码文件：

🤔 Thinking...

📝 Creating server.js

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
  res.end('Hello, OpenClaw!');
});

server.listen(3000, () => {
  console.log('Server running at http://localhost:3000');
});

✅ Created server.js
💡 Run with: node server.js

运行并测试

node server.js
# Server running at http://localhost:3000

# 新开一个终端测试
curl http://localhost:3000
# Hello, OpenClaw!

常用快捷键与命令

在 OpenClaw 交互界面中，你可以使用以下命令：

常见安装问题排查

问题1：command not found: openclaw

# 检查 npm 全局安装路径
npm config get prefix
# 将输出路径添加到 PATH
export PATH="$(npm config get prefix)/bin:$PATH"

问题2：API Key 验证失败

# 重新配置
openclaw config --reset
openclaw init

问题3：Node.js 版本不兼容

# 推荐使用 nvm 管理 Node.js 版本
nvm install 20
nvm use 20
npm install -g openclaw

下一步

恭喜你完成了 OpenClaw 的安装和初次体验！接下来，你可以：

1. 阅读 [OpenClaw 核心功能详解] 了解代码生成、重构和调试的高级用法
2. 查看 [OpenClaw 与 Git 集成指南] 学习如何将 AI 融入 Git 工作流
3. 尝试 [30分钟搭建 Next.js 应用] 的实战教程，体验 OpenClaw 的完整能力

OpenClaw 的官方文档和社区论坛也是很好的学习资源，遇到问题欢迎在 GitHub Issues 提交反馈。