Mac电脑安装使用OpenClaw完全指南：从零搭建你的专属AI智能体

## 前言什么是OpenClawOpenClaw曾用名Clawdbot、Moltbot是一款近期爆火的开源AI智能体平台因其图标形似龙虾被用户亲切地称为“养龙虾”。与传统聊天式AI不同OpenClaw不仅“能说会道”更能“能干会做”——它能够通过自然语言指令直接操作你的电脑系统自动完成文件处理、浏览器控制、代码生成、定时任务等一系列复杂操作。本文将详细介绍在Mac电脑上安装和使用OpenClaw的全流程帮助你在30分钟内完成部署开始“养龙虾”之旅。## 一、环境准备### 1.1 系统要求- **操作系统**macOS Ventura 13.0 或更高版本推荐Sonoma 14.0- **硬件配置**- 最低Apple Silicon M1 或 Intel Core i520188GB内存5GB可用存储空间- 推荐Apple Silicon M2/M3/M416GB以上内存### 1.2 软件依赖OpenClaw基于Node.js运行首先需要安装Node.js环境。**检查是否已安装Node.js**bashnode --version如果输出版本号且为v22.0.0或更高可直接进入下一步。否则按以下方式安装**方式一Homebrew安装推荐**bash# 如果未安装Homebrew先执行此命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装Node.jsbrew install node**方式二官方安装包**访问 nodejs.org下载LTS版本安装包双击安装即可。安装完成后验证bashnode --versionnpm --version### 1.3 国内用户加速配置可选由于npm官方源在国内访问较慢建议配置国内镜像源bashnpm config set registry https://registry.npmmirror.com## 二、安装OpenClaw### 2.1 方式一使用官方脚本安装最简单在终端中执行以下命令bashcurl -fsSL https://openclaw.ai/install.sh | bash首次安装时间较长请耐心等待。### 2.2 方式二使用npm全局安装bashnpm install -g openclaw安装完成后验证bashopenclaw --version如果提示command not found需要将npm全局bin目录添加到PATH中bashecho export PATH$PATH:$(npm config get prefix)/bin ~/.zshrcsource ~/.zshrc### 2.3 方式三DMG安装包适合不熟悉命令行的用户访问OpenClaw官网下载页选择macOS版本下载将应用拖入Applications文件夹即可。## 三、初始化配置### 3.1 运行配置向导bashopenclaw onboard --install-daemon向导会引导你完成以下配置**步骤1确认风险提示**首次安装会出现风险提示选择yes继续。**步骤2选择配置方式**选择QuickStart快速开始。**步骤3选择LLM模型服务商**可选选项包括- Anthropic (Claude) - 推荐效果最佳- OpenAI (GPT-4) - 需要API密钥- 阿里云百炼千问模型- 国内用户推荐免费额度充足- Local Model (Ollama) - 本地运行隐私性最强选择后按提示输入对应的API密钥。**步骤4选择消息平台**- WhatsApp推荐- Telegram- Discord- 钉钉/飞书- 暂时跳过后续可配置**步骤5配置存储路径**建议使用默认路径~/.openclaw。**步骤6启用工具权限**根据需要选择建议至少开启read、write、web_search和memory。### 3.2 连接消息平台如果选择使用WhatsApp向导完成后终端会显示二维码1. 打开手机WhatsApp2. 点击右上角菜单 → “已关联设备”3. 点击“关联设备”4. 扫描终端中的二维码连接成功后会显示✓ WhatsApp connected successfully。### 3.3 使用钉钉通道国内用户推荐由于国内网络环境钉钉是更稳定的选择。安装钉钉插件bashopenclaw plugins install openclaw/dingtalk然后在配置文件~/.openclaw/openclaw.json中添加钉钉配置json{channels: {dingtalk: {clientId: 你的钉钉应用Client ID,clientSecret: 你的钉钉应用Client Secret}}}## 四、启动与验证### 4.1 启动Gateway服务bashopenclaw gateway start成功启动后会显示类似输出 OpenClaw Gateway is running Connected to WhatsApp Using Claude Sonnet 4.6 Data stored in ~/.openclaw### 4.2 查看服务状态bashopenclaw gateway status### 4.3 访问Web控制面板在浏览器中打开http://127.0.0.1:18789/首次访问需要获取访问令牌bashopenclaw dashboard复制终端输出的URL到浏览器即可。### 4.4 发送第一条消息在WhatsApp或钉钉中找到OpenClaw聊天窗口发送你好请介绍一下你自己如果收到回复说明安装配置成功## 五、核心功能介绍### 5.1 基础对话与任务执行OpenClaw能够理解自然语言并执行实际操作。尝试以下指令帮我创建一个名为test.txt的文件内容为Hello OpenClaw搜索今天的科技新闻总结成3条要点### 5.2 Skills技能系统Skills是OpenClaw的功能扩展模块类似“插件”。安装技能管理工具bashnpm install -g clawhub常用技能安装示例bash# 联网搜索增强clawhub install tavily-search# 浏览器自动化clawhub install agent-browser# 文本摘要clawhub install summarize查看已安装技能bashopenclaw skill list### 5.3 多智能体协同OpenClaw支持同时运行多个智能体处理不同任务bash# 创建不同用途的智能体openclaw agent create work-assistant --workspace ~/workopenclaw agent create personal-assistant --workspace ~/personal## 六、配置优化### 6.1 配置文件位置主配置文件~/.openclaw/openclaw.json### 6.2 常用配置项json{// 模型配置model: {provider: anthropic,model: claude-sonnet-4-6,temperature: 0.7,max_tokens: 2048},// 工作区配置workspace: {defaultPath: /Users/你的用户名/projects},// 安全配置channels: {whatsapp: {allowFrom: [861234567890], // 仅允许特定用户groups: {*: { requireMention: true }}}}}### 6.3 配置阿里云百炼模型国内用户推荐阿里云百炼提供免费额度的Coding Plan适合入门1. 登录阿里云百炼控制台创建API-Key2. 编辑配置文件~/.openclaw/config.jsonjson{model: {type: aliyun-bailian,api_key: 你的APIKey,secret: 你的AccessKeySecret,model_name: qwen-7b-chat}}3. 重启服务openclaw gateway restart## 七、常见问题解决### 7.1 命令未找到openclaw: command not found**原因**npm全局bin目录未加入PATH**解决**bashecho export PATH$PATH:$(npm config get prefix)/bin ~/.zshrcsource ~/.zshrc### 7.2 端口18789已被占用**解决**找到并终止占用进程bashlsof -i :18789kill -9 [PID]### 7.3 WhatsApp二维码不显示**原因**终端不支持QR码渲染**解决**使用Web控制面板连接或更换终端推荐iTerm2### 7.4 服务启动后自动退出**原因**内存不足或配置错误**解决**bash# 查看日志openclaw logs# 重启服务openclaw gateway restart### 7.5 国内网络环境安装失败**解决**1. 配置npm镜像源2. 使用代理3. 通过阿里云等云服务商的镜像部署## 八、安全使用建议OpenClaw拥有强大的系统操作能力务必注意以下安全事项### 8.1 权限最小化原则仅在配置中开放必要的工具权限避免授予exec等高危权限。### 8.2 用户白名单在配置文件中设置允许访问的用户列表json{channels: {whatsapp: {allowFrom: [861234567890]}}}### 8.3 定期更新bashnpm update -g openclaw### 8.4 谨慎安装第三方Skills只从官方或可信来源安装Skills避免安装来源不明的技能模块。### 8.5 监控审计定期查看日志文件/tmp/openclaw/## 九、总结通过本文的指引你应该已经在Mac电脑上成功安装并运行了OpenClaw。这只“龙虾”能够成为你的得力助手自动完成各类重复性工作。从基础对话到复杂的自动化任务OpenClaw的潜力等待你去探索。记住OpenClaw虽然强大但使用时务必注意安全遵循最小权限原则。建议先从简单的文件操作和搜索功能开始逐步解锁更多高级功能。祝你的“养龙虾”之旅愉快---**参考资料**- OpenClaw官方文档[https://docs.openclaw.ai/](https://docs.openclaw.ai/)- 阿里云OpenClaw部署专题- 钉钉开放平台OpenClaw集成指南