Claude新手入门指南——以新Mac mini配置和OpenClaw安装为例

Claude新手入门指南——以新Mac mini配置和OpenClaw安装为例

引言：为什么选择Claude和OpenClaw

Claude是Anthropic公司开发的AI助手，以其准确、安全、多功能的特点而闻名。无论是日常对话、代码编写、文本分析还是创意写作，Claude都能提供高质量的帮助。

OpenClaw是一个开源的Claude代理系统，允许你在本地部署和运行Claude。相比网页版，本地部署有三大优势：隐私保护（数据不会上传到云端）、成本可控（避免按token计费）、功能扩展（支持自定义工具和Agent）。

Mac mini作为一款性价比极高的苹果电脑，是部署OpenClaw的理想平台。它体积小巧、性能强劲、价格合理，配合OpenClaw，可以搭建一个功能强大的个人AI助手系统。

本文将以新Mac mini为例，带你从零开始配置硬件、安装OpenClaw，并完成首次使用。即使你没有技术背景，也能跟着一步步完成。

准备工作：Mac mini硬件配置

硬件选择建议

在购买Mac mini时，硬件配置的选择会直接影响OpenClaw的运行效果。以下是建议：

芯片选择

  • 推荐：M4芯片（最新一代，性能最强，AI加速最佳）
  • 可选：M3或M2芯片（性能略逊，但价格更便宜，也能满足基本需求）
  • 不推荐：Intel芯片（性能较差，AI推理速度慢）

内存（RAM）

  • 最低要求：16GB（可以运行，但可能卡顿）
  • 推荐配置：32GB（运行流畅，适合多任务）
  • 预算充足：64GB（重度使用，多个Agent同时运行）

存储

  • 最低要求：512GB（仅安装系统+OpenClaw，不存大量数据）
  • 推荐配置：1TB（有足够空间存放模型、日志、聊天记录）
  • 预算充足：2TB（长期使用，数据量大）

价格参考（2026年市场价）

  • 入门配置（M2+16GB+512GB）：约6000元
  • 推荐配置（M4+32GB+1TB）：约9000元
  • 高级配置（M4+64GB+2TB）：约15000元

💡 小贴士：如果预算有限，内存比存储更重要。AI运行需要大量内存，而存储空间不足时可以外接硬盘。

开箱即用配置

收到Mac mini后，首次开机需要完成以下设置：

  1. 系统初始化：按照屏幕提示选择语言、时区、连接Wi-Fi
  2. Apple ID登录：如果没有Apple ID，需要注册一个
  3. 系统更新：打开"系统设置" → “通用” → “软件更新”，更新到最新版本
  4. 安装浏览器：如果还没有，下载并安装Chrome或Firefox
  5. 打开终端：按 Command + 空格，输入"终端"，按回车打开

⚠️ 注意：OpenClaw需要macOS 12.0或更高版本，请确保系统已更新。

Claude快速上手：网页版使用

在安装OpenClaw之前，建议先体验Claude的网页版，了解它的基本功能和能力。

注册Claude账号

  1. 访问官网：打开浏览器，访问 claude.ai
  2. 注册账号：
    • 点击"Sign up"按钮
    • 可以使用邮箱注册，或直接使用Google/Apple账号登录
    • 如果使用邮箱注册，需要验证邮箱
  3. 登录成功：登录后，你会看到Claude的对话界面

基础使用

让我们尝试第一个对话：

在输入框中输入：

1

你好，我是新用户，请介绍一下你自己

点击发送，Claude会回复一段介绍。你可以尝试：

  • 写代码：“写一个Python的Hello World程序”
  • 分析文本：“分析这段话的情感：今天天气真好！”
  • 创意写作：“写一首关于春天的短诗”
  • 知识问答：“什么是量子计算？”

了解Claude的能力后，你会对本地部署更有信心。

订阅方案

Claude提供免费版和Pro版：

免费版限制：

  • 每天有对话次数限制
  • 不能使用某些高级模型（如Claude 3.5 Sonnet）
  • 不能上传大文件

Claude Pro订阅：

  • 每月$20（约合人民币145元）
  • 无对话次数限制
  • 可以使用所有模型
  • 支持上传大文件

💡 建议：新手可以先使用免费版熟悉功能，确定需要本地部署后再考虑订阅。本地部署后，如果需要使用Anthropic的模型API，才需要订阅Pro版。

OpenClaw简介：本地部署的Claude

什么是OpenClaw

OpenClaw是一个开源的Claude代理系统，它允许你在本地运行Claude，而不是依赖云端服务。简单来说，它就像你在本地搭建了一个"个人版的Claude"。

OpenClaw不是Claude的官方产品，而是一个由社区开发的开源项目。它通过调用Claude的API或使用本地模型，实现类似Claude的功能。

为什么要用OpenClaw

隐私保护

  • 对话数据在本地存储，不会上传到云端
  • 适合处理敏感信息（如代码、个人文档、商业数据）
  • 你完全掌控自己的数据

成本可控

  • 网页版按token计费，用得多就贵
  • 本地部署可以使用开源模型（免费）
  • 即使使用Claude API，也比网页版便宜

功能扩展

  • 可以自定义工具（如文件搜索、代码执行、网页爬取）
  • 可以配置多个专门的Agents（如写作Agent、编程Agent）
  • 可以与其他软件集成（如Obsidian、VS Code）

速度优势

  • 本地推理几乎没有网络延迟
  • 即使使用云端API，OpenClaw的缓存机制也能提升速度

适用人群

OpenClaw适合以下用户：

  • 隐私敏感的用户：不想让对话数据上传到云端
  • 开发者和技术人员：需要自动化工作流和自定义工具
  • 重度AI用户：每天使用AI工作，成本高
  • 企业用户：需要部署私有AI助手

⚠️ 注意：如果你只是偶尔使用Claude，网页版可能更简单方便。OpenClaw需要一定的配置和学习成本。

OpenClaw安装步骤

前置条件检查

在安装OpenClaw之前，需要确保你的Mac mini满足以下条件：

  1. macOS版本：macOS 12.0 Monterey或更高版本
  2. Homebrew：macOS的包管理器，用于安装软件
  3. Node.js：OpenClaw需要Node.js环境（推荐v18或更高）
  4. 网络连接：稳定的互联网连接（用于下载和更新）

检查macOS版本：

1

sw_vers

你应该看到类似这样的输出：

1
2
3

ProductName:	macOS
ProductVersion:	13.6
BuildVersion:	22G120

如果ProductVersion小于12，需要更新系统。

安装Homebrew

Homebrew是macOS上最流行的包管理器，它让安装软件变得非常简单。PATH是系统中的一个环境变量，告诉系统在哪里查找可执行程序。安装Homebrew后，需要把它添加到PATH中，这样系统才能找到Homebrew命令。

在终端中，输入以下命令：

1

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

这个命令会下载Homebrew的安装脚本并执行。安装过程可能需要几分钟，请耐心等待。

安装完成后，你需要将Homebrew添加到系统PATH中。在终端中输入：

1
2

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

第一行命令是将Homebrew的配置写入你的shell配置文件，这样每次打开终端都会自动加载。第二行命令是立即加载Homebrew的配置，不用重启终端。

验证Homebrew是否安装成功：

1

brew --version

如果看到版本号（如 Homebrew 4.3.0），说明安装成功！✅

💡 小贴士：如果Homebrew安装失败，可能是网络问题。你可以尝试使用代理，或者从Homebrew官网下载安装脚本。

安装Node.js

OpenClaw需要Node.js环境，我们可以使用Homebrew安装。

在终端中输入：

1

brew install node

这个命令会安装Node.js和npm（Node.js的包管理器）。安装可能需要几分钟。

验证Node.js是否安装成功：

1
2

node --version
npm --version

你应该看到类似这样的输出：

1
2

v20.10.0
10.2.3

版本号不重要，只要能看到版本号就说明安装成功！✅

⚠️ 注意：Node.js版本需要v18或更高。如果显示的版本低于v18，运行 brew upgrade node 更新。

安装OpenClaw

现在可以安装OpenClaw了。OpenClaw有多种安装方式，新手推荐使用npm安装。

方式一：npm安装（推荐新手）

这是最简单的方式，适合大多数人。

在终端中输入：

1

npm install -g openclaw

这个命令会从npm仓库下载OpenClaw并全局安装。-g参数表示全局安装，这样你可以在任何目录使用OpenClaw。

方式二：Homebrew安装（如果你熟悉Homebrew）

如果你已经安装了Homebrew，也可以用它来安装OpenClaw。

在终端中输入：

1
2

brew tap openclaw/openclaw
brew install openclaw

方式三：源码安装（开发者）

如果你想从源码编译安装，适合开发者。

在终端中输入：

1
2
3
4

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm link

💡 小贴士：如果你在中国大陆，npm的下载速度可能较慢。可以使用淘宝镜像加速：

1

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

验证安装

安装完成后，验证OpenClaw是否安装成功：

在终端中输入：

1

openclaw --version

如果看到版本号（如 OpenClaw v1.2.3），说明安装成功！✅

查看OpenClaw的帮助信息：

1

openclaw --help

你会看到所有可用的命令和参数说明。

快速测试

完成安装后，让我们做一个快速测试，确保OpenClaw能正常工作：

在终端中输入：

1

openclaw version

你应该看到类似这样的输出：

1
2
3

OpenClaw v1.2.3
Node.js v20.10.0
System: macOS 13.6 (arm64)

如果看到这些信息，说明OpenClaw安装成功，可以开始配置了！✅

如果看到错误信息，请查看下面的"常见问题和解决方案"部分。

OpenClaw配置和首次使用

最简配置：快速上手

对于新手，建议先用最简配置让OpenClaw跑起来，然后再逐步探索高级功能。

最简配置只需要两步：

  1. 初始化配置
1

openclaw init

按照提示操作：

  • 配置文件位置：直接按回车（使用默认 ~/.openclaw）
  • 默认模型：选择 claude-3-5-sonnet（Anthropic的最新模型）
  • API密钥：输入你的Claude API密钥（如果没有，暂时跳过，稍后配置）

获取Claude API密钥的方法：

  1. 访问 console.anthropic.com
  2. 注册或登录账号
  3. 点击"API Keys"
  4. 点击"Create API Key"
  5. 复制密钥（格式如：sk-ant-xxxxx）

⚠️ 安全提示：API密钥相当于你的账号密码，请妥善保管，不要分享给他人。

  1. 验证配置
1

openclaw chat "你好，请测试一下"

如果收到Claude的回复，说明配置成功！✅

完整配置文件详解

当OpenClaw正常运行后，你可以查看和修改完整的配置文件。

打开配置文件：

1

open ~/.openclaw/config.yaml

你会看到类似这样的内容（简化版）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# 默认模型
models:
  default: claude-3-5-sonnet

# 模型提供商
providers:
  anthropic:
    apiKey: sk-ant-xxxxx  # 你的API密钥
    baseUrl: https://api.anthropic.com

# 上下文配置
context:
  maxTokens: 4096          # 最大token数
  temperature: 0.7          # 随机性（0-1，越高越随机）
  topP: 0.9                # 采样参数

# 工具配置
tools:
  enabled:
    - file:read           # 文件读取
    - file:write          # 文件写入
    - web:search          # 网页搜索
    - code:run            # 代码执行

# Agent配置
agents:
  enabled: true           # 启用Agents
  workspace: ~/.openclaw/workspace  # Agents工作目录

# 日志配置
logging:
  level: info             # 日志级别：debug, info, warn, error
  path: ~/.openclaw/logs   # 日志文件路径

重要配置项说明

context.temperature：控制AI回复的随机性

  • 0：非常确定性，适合事实性回答
  • 0.7：平衡，适合大多数场景（默认）
  • 1.0：非常随机，适合创意写作

context.maxTokens：限制回复的最大长度

  • 1024：简短回答
  • 4096：中等长度（默认）
  • 8192：长篇回答

tools.enabled：启用哪些工具

  • file:read：允许AI读取文件
  • file:write：允许AI写入文件
  • web:search：允许AI搜索网页
  • code:run：允许AI执行代码

⚠️ 安全提示：启用 file:write 和 code:run 可能会有安全风险，请确保你信任AI的回复。

首次对话

配置完成后，让我们尝试第一次对话：

在终端中输入：

1

openclaw chat "你好，我是OpenClaw的新用户，请介绍一下你自己"

你应该会看到OpenClaw的回复。如果使用的是API模型，回复会很快；如果使用的是本地模型，可能需要等待几秒钟（取决于你的硬件性能）。

持续对话 你可以继续输入，保持对话上下文：

1

openclaw chat "你会写Python代码吗？"

OpenClaw会记得之前的对话，给出相关的回答。

退出对话 输入 exit 或按 Ctrl + C 退出对话。

配置本地模型

如果你不想使用API密钥，可以使用本地模型。这需要安装Ollama，一个本地模型运行工具。

安装Ollama

在终端中输入：

1

brew install ollama

验证Ollama是否安装成功：

1

ollama --version

如果看到版本号（如 ollama version is 0.1.25），说明安装成功！✅

常用本地模型

以下是几个常用的本地模型，你可以根据自己的需求选择：

Llama 2

  • 大小：约4GB（7B参数版本）
  • 用途：通用对话、文本生成
  • 下载命令：
1

ollama pull llama2

Mistral

  • 大小：约4GB（7B参数版本）
  • 用途：对话、推理
  • 特点：性能优秀，速度快
  • 下载命令：
1

ollama pull mistral

CodeLlama

  • 大小：约4GB（7B参数版本）
  • 用途：代码生成、编程助手
  • 下载命令：
1

ollama pull codellama

Phi-2

  • 大小：约1.8GB（2.7B参数版本）
  • 用途：轻量级模型，适合低配置设备
  • 特点：体积小，速度快
  • 下载命令：
1

ollama pull phi

💡 小贴士：如果你的Mac mini内存只有16GB，建议使用Phi-2。如果有32GB或更多，可以使用Llama 2或Mistral。

配置OpenClaw使用本地模型

下载模型后，配置OpenClaw使用本地模型。

编辑 ~/.openclaw/config.yaml，修改或添加：

1
2
3
4
5
6

models:
  default: ollama/llama2  # 改为本地模型

providers:
  ollama:
    baseUrl: http://localhost:11434

然后测试一下：

1

openclaw chat "你好"

如果收到回复，说明本地模型配置成功！✅

常见问题和解决方案

安装失败

问题1：Homebrew安装失败

1
2

fatal: not in a git directory
Command failed with exit 128

解决方案：

  1. 删除 /opt/homebrew 文件夹（如果存在）
  2. 重新运行安装命令
  3. 如果仍然失败，从Homebrew官网下载安装脚本

问题2：npm安装失败（网络问题）

1

npm ERR! network timeout

解决方案：

  1. 使用淘宝镜像：
1

npm config set registry https://registry.npmmirror.com
  1. 或者使用代理：
1

npm config set proxy http://127.0.0.1:7890

问题3：Node.js版本过低

1

Error: OpenClaw requires Node.js version 18 or higher

解决方案：

1

brew upgrade node

问题4：命令找不到（PATH问题）

1

command not found: openclaw

解决方案：

  1. 检查npm全局安装路径：
1

npm config get prefix
  1. 确保这个路径在PATH中
  2. 尝试重启终端，或者手动添加到PATH

运行错误

问题1：API密钥错误

1

Error: Invalid API key

解决方案：

  1. 检查 ~/.openclaw/config.yaml 中的API密钥是否正确
  2. 重新获取API密钥（可能已过期）
  3. 检查API密钥的权限是否正确

问题2：模型加载失败

1

Error: Model not found: ollama/llama2

解决方案：

  1. 确认Ollama已安装：ollama --version
  2. 确认模型已下载：ollama list
  3. 如果没有，下载模型：ollama pull llama2

问题3：内存不足

1

Error: Out of memory

解决方案：

  1. 关闭其他占用内存的应用
  2. 降低 context.maxTokens 的值
  3. 使用更小的模型（如 ollama/phi）
  4. 升级Mac mini的内存

性能优化

提高响应速度

  1. 使用API模型：比本地模型快
  2. 降低maxTokens：减少AI回复的长度
  3. 使用更快的模型：如 claude-3-haiku
  4. 启用缓存：在配置中设置 cache.enabled: true

降低内存占用

  1. 关闭其他应用：释放内存
  2. 使用更小的模型：如 ollama/phi（更小）
  3. 降低maxTokens：减少内存占用
  4. 限制并发对话数：不要同时运行多个Agent

进阶使用建议

自定义工具

OpenClaw支持创建自定义工具，让AI能够执行特定的任务。

创建工具脚本 在 ~/.openclaw/tools/ 目录下创建一个JavaScript文件，例如 weather.js：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

module.exports = {
  name: 'getWeather',
  description: '获取指定城市的天气',
  parameters: {
    city: {
      type: 'string',
      description: '城市名称',
      required: true
    }
  },
  async execute({ city }) {
    // 调用天气API
    const response = await fetch(`https://api.weather.com/v1/current?city=${city}`);
    const data = await response.json();
    return JSON.stringify(data);
  }
};

在配置中启用工具 编辑 ~/.openclaw/config.yaml：

1
2
3

tools:
  enabled:
    - custom:weather

在对话中使用工具

1

openclaw chat "北京今天的天气怎么样？"

AI会自动调用 getWeather 工具，获取天气信息。

多Agent系统

OpenClaw支持配置多个专门的Agents，每个Agent有自己的角色和任务。

创建Agent配置 在 ~/.openclaw/agents/ 目录下创建配置文件，例如 writer.yaml：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

name: writer
role: 写作助手
systemPrompt: |
  你是一个专业的写作助手，擅长撰写各种类型的文章。
  你的风格简洁明快，逻辑清晰，适合大众阅读。
model: claude-3-5-sonnet
tools:
  enabled:
    - web:search
    - file:read

在对话中使用Agent

1

openclaw chat --agent writer "帮我写一篇关于人工智能的文章"

AI会以"writer" Agent的身份回复。

与其他软件集成

VS Code插件 安装OpenClaw的VS Code插件，可以在编辑器中直接使用AI助手。

Obsidian插件 OpenClaw有Obsidian插件，可以在笔记软件中使用AI进行知识管理。

Discord/Telegram机器人 OpenClaw可以集成到Discord或Telegram，让你的AI助手成为聊天机器人。

结语：从新手到熟练

恭喜你完成了OpenClaw的安装和首次使用！现在你已经拥有了一个功能强大的本地AI助手系统。

关键步骤回顾

  1. ✅ 准备Mac mini硬件（建议M4+32GB+1TB）
  2. ✅ 安装Homebrew和Node.js
  3. ✅ 安装OpenClaw并配置
  4. ✅ 完成首次对话

学习资源

下一步建议

  1. 尝试不同的模型，找到最适合你的
  2. 配置自定义工具，扩展AI的能力
  3. 创建多个Agents，分工合作
  4. 集成到你常用的软件中

记住，技术学习是一个循序渐进的过程。遇到问题不要气馁，查阅文档、搜索社区、提问求助，总能找到解决方案。

祝你使用愉快！

本文约3000字

创作时间：2026-02-06

Licensed under CC BY-NC-SA 4.0
comments powered by Disqus