1. 项目概述
OpenClaw(小龙虾)是当前最热门的开源AI助手项目之一。作为一个完全开源的解决方案,它允许用户在本地部署一个功能强大的AI助手,实现对话交互、系统命令执行、文件管理、代码编写等一系列功能。与闭源的商业产品不同,OpenClaw让用户完全掌控自己的数据隐私,同时提供了丰富的定制化选项。
这个项目最大的优势在于其轻量级的特性——即使是一台配备M4芯片的Mac Mini或普通的MacBook,也能流畅运行。对于开发者和技术爱好者来说,OpenClaw提供了一个绝佳的机会,可以在本地环境中体验和定制AI助手的功能。
2. 环境准备
2.1 系统要求
在开始安装OpenClaw之前,确保你的Mac设备满足以下基本要求:
- macOS 10.15 (Catalina) 或更高版本
- 至少8GB内存(推荐16GB)
- 至少20GB可用存储空间
- 稳定的网络连接
2.2 Node.js安装
OpenClaw是基于Node.js开发的,因此需要先安装Node.js环境。以下是详细的安装步骤:
-
打开终端应用(可以在Spotlight中搜索"终端"找到)
-
检查是否已安装Node.js:
bash复制
node -v如果显示类似
v22.22.0的版本号,说明已安装且版本符合要求。 -
如果未安装或版本低于22.x,需要先安装Homebrew(Mac上的包管理器):
bash复制/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
通过Homebrew安装Node.js:
bash复制
brew install node -
安装完成后,再次验证版本:
bash复制
node -v npm -v
提示:如果遇到权限问题,可以在命令前加上
sudo,但建议先尝试不使用sudo的安装方式。
3. OpenClaw安装与配置
3.1 一键安装脚本
OpenClaw提供了便捷的安装脚本,可以自动完成大部分安装工作:
-
在终端中执行以下命令:
bash复制
curl -fsSL https://openclaw.ai/install.sh | bash -
安装过程中会显示如下信息:
code复制🦞 OpenClaw Installer Type the command with confidence—nature will provide the stack trace if needed. ✓ Detected: macos Install plan OS: macos Install method: npm Requested version: latest [1/3] Preparing environment ✓ Homebrew already installed ✓ Node.js v22.22.0 found · Active Node.js: v22.22.0 (/Users/nickbai/.nvm/versions/node/v22.22.0/bin/node) · Active npm: 10.9.4 (/Users/nickbai/.nvm/versions/node/v22.22.0/bin/npm)
3.2 初始配置向导
安装完成后会自动进入配置向导,以下是关键配置步骤:
-
安全协议确认:
code复制◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? │ ● Yes / ○ No选择"Yes"并按Enter继续。
-
启动模式选择:
code复制◆ Onboarding mode │ ● QuickStart (Configure details later via openclaw configure.) │ ○ Manual推荐选择"QuickStart"简化初始配置。
-
模型提供商选择:
code复制
◆ Model/auth provider │ ● OpenAI (Codex OAuth + API key) │ ○ Anthropic │ ○ Qwen使用方向键选择"Qwen"(通义千问),这是国产优质模型,提供免费额度。
-
Qwen授权:
选择Qwen后,会自动打开浏览器进行OAuth授权。登录你的Qwen账号并完成授权流程。
4. 飞书集成配置
4.1 创建飞书应用
- 访问飞书开放平台
- 点击右上角"开发者后台"
- 选择"创建企业应用"
- 填写应用名称和描述,然后点击"确定"
4.2 获取应用凭证
- 在应用管理页面,点击"凭证与基础信息"
- 记录下"App ID"和"App Secret"这两个关键信息
4.3 配置机器人能力
- 在应用管理页面,点击"添加应用能力"
- 选择"机器人"并点击"添加"
- 为机器人设置一个名称
- 在"事件与回调"中配置长连接
- 添加"im.message"事件,勾选"接收消息"选项
4.4 设置权限
在"权限管理"页面,确保勾选了以下权限:
- contact:user.base:readonly(获取用户基础信息)
- im:message(发送和接收消息)
注意:某些权限需要审核,如果只是测试使用,可以暂时不申请这些权限。
4.5 发布应用
- 点击"创建版本"
- 输入版本号(如1.0.0)
- 点击"保存"并发布应用
5. OpenClaw与飞书对接
5.1 在OpenClaw中配置飞书插件
- 在OpenClaw配置向导中选择"Feishu/Lark (飞书)"作为通信渠道
- 选择"Use local plugin path"安装飞书插件
- 输入之前记录的App ID和App Secret
5.2 配置连接参数
- 选择"WebSocket"作为连接方式
- 选择"feishu.cn"作为域名
- 设置群组策略为"open"
- 跳过web搜索和技能配置(可后续添加)
5.3 启动Web UI
在配置向导最后,选择"Open the Web UI"启动网页管理界面。
6. 常见问题排查
6.1 飞书消息无响应
如果机器人没有回应消息,可能需要修改配置文件:
-
打开配置文件:
bash复制
open ~/.openclaw/openclaw.json -
在feishu配置部分添加:
json复制"dmPolicy": "open", "allowFrom": ["*"] -
重启OpenClaw服务:
bash复制
openclaw gateway restart
6.2 服务启动失败
如果服务无法启动,可以尝试以下步骤:
-
检查端口冲突:
bash复制
lsof -i :18789 -
查看日志:
bash复制
openclaw logs -
重置配置:
bash复制
openclaw onboard
7. 日常使用与管理
7.1 常用命令
| 命令 | 功能 |
|---|---|
openclaw status |
查看运行状态 |
openclaw gateway start |
启动服务 |
openclaw gateway stop |
停止服务 |
openclaw gateway restart |
重启服务 |
openclaw update |
更新到最新版本 |
openclaw dashboard |
获取Web UI链接 |
openclaw uninstall |
卸载OpenClaw |
7.2 性能优化建议
- 对于资源有限的设备,可以在配置中限制并发请求数
- 定期清理对话历史记录以节省存储空间
- 考虑使用更轻量级的模型(如果Qwen运行缓慢)
8. 安全注意事项
- 不要将App Secret分享给他人
- 定期检查并更新OpenClaw到最新版本
- 运行安全审计:
bash复制
openclaw security audit --deep - 如果不再使用,及时在飞书开放平台停用应用
通过以上步骤,你应该已经成功在Mac上部署了OpenClaw并完成了与飞书的集成。这个组合可以让你通过熟悉的飞书界面,随时随地与你的个人AI助手交互,完成各种任务。随着使用的深入,你可以进一步探索OpenClaw的高级功能,如自定义技能、工作流自动化等,让这个AI助手更好地服务于你的个人需求。