1. OpenClaw是什么?它能为你做什么?
如果你正在寻找一个能在Mac上24小时待命的AI助手,不仅能聊天还能真正帮你干活,那么OpenClaw就是你要找的解决方案。与普通聊天机器人不同,OpenClaw是一个拥有"手脚"的智能体(Agent),它可以直接操作你的macOS系统,执行实际任务。
想象一下这样的场景:你在外出差时,突然需要家里电脑上的某个文件;或者凌晨三点灵感迸发,想让AI帮你把创意变成代码;又或是想让AI自动整理你杂乱无章的下载文件夹。这些OpenClaw都能做到,而且所有操作都在你的Mac本地完成,确保了隐私安全。
OpenClaw最核心的三个能力是:
- 本地任务执行:可以直接读写文件、运行命令、控制应用
- 多平台接入:可以通过飞书等通讯工具远程控制
- 工具链整合:能够调用各种开发工具和云服务API
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装前的准备工作
2.1 检查系统要求
在开始安装前,请确保你的Mac满足以下要求:
- macOS Monterey (12.0)或更高版本
- Intel或Apple Silicon处理器
- 至少8GB内存(推荐16GB以上)
- 至少20GB可用存储空间
提示:虽然OpenClaw本身不大,但运行AI模型和处理任务需要一定资源。如果你的Mac较旧,可能体验会打折扣。
2.2 必备工具安装
OpenClaw依赖几个基础工具,我们需要先安装它们:
Homebrew安装
Homebrew是Mac上的包管理器,相当于Linux的apt或yum。安装命令如下:
bash复制/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,按照终端提示将Homebrew添加到PATH中。通常需要执行类似下面的命令:
bash复制echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"
验证安装是否成功:
bash复制brew --version
Node.js安装
OpenClaw是用Node.js开发的,我们需要安装Node.js 22或更高版本:
bash复制brew install node@22
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
验证安装:
bash复制node -v
npm -v
Git安装(可选)
虽然Mac自带Git,但建议更新到最新版:
bash复制brew install git
git --version
3. OpenClaw的安装与基础配置
3.1 一键安装OpenClaw
现在可以安装OpenClaw本体了:
bash复制curl -fsSL https://openclaw.ai/install.sh | bash
这个命令会:
- 下载最新版OpenClaw
- 安装到/usr/local/bin目录
- 创建必要的配置文件和目录结构
安装完成后,你会看到类似下面的输出:
code复制🎉 OpenClaw installed successfully!
Run 'openclaw --help' to get started.
3.2 初始配置向导
首次运行OpenClaw会启动配置向导:
bash复制openclaw onboard --install-daemon
在向导中,你需要:
- 接受安全声明(选择YES)
- 选择QuickStart快速开始
- 配置AI模型提供商(下一节详细介绍)
如果不小心跳过了向导,可以随时重新运行上述命令。
4. 连接AI大模型
OpenClaw本身不包含AI模型,需要连接外部API。以下是几种常见选择:
4.1 硅基流动配置示例
- 访问硅基流动官网注册账号
- 在API密钥页面创建新密钥并复制
- 在OpenClaw配置中选择"Custom Provider"
- 填写API Base URL:
https://api.siliconflow.cn/v1 - 选择"Paste API key now"并粘贴你的密钥
- 模型ID填写你想要的模型,如"Pro/MiniMaxAI/MiniMax-M2.5"
- 验证成功后,为模型设置一个别名(任意名称)
4.2 其他模型提供商
类似的,你也可以配置:
- OpenAI: API Base URL为
https://api.openai.com/v1 - 阿里云通义千问
- 百度文心一言
- 讯飞星火
注意:不同提供商的价格、速率限制和模型能力差异较大,建议先使用免费额度测试。
5. 接入飞书机器人
5.1 创建飞书应用
- 访问飞书开放平台(open.feishu.cn)并登录
- 进入开发者后台,创建企业自建应用
- 填写应用名称、描述和图标
- 在"机器人"菜单中添加机器人能力
5.2 配置权限
在"权限管理"页面,点击"批量导入"并粘贴以下JSON:
json复制{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}
然后申请开通这些权限。
5.3 获取凭证信息
在"凭证与基础信息"页面,复制:
- App ID
- App Secret
5.4 完成飞书插件配置
回到OpenClaw配置:
- 在"Select channel"选择Feishu/飞书
- 选择"Download from npm"下载飞书插件
- 输入之前复制的App Secret和App ID
- 选择WebSocket连接方式
- 地区选择"Feishu - China"
- 访问控制选择"Allowlist"
5.5 发布飞书应用
- 在"版本管理与发布"创建新版本
- 填写版本号和更新说明
- 提交审核并发布
5.6 配对用户
- 在飞书中找到你的机器人并发送消息
- 机器人会回复包含配对码的消息
- 在终端执行配对命令:
bash复制openclaw pairing approve feishu 你的配对码
配对成功后,你就可以通过飞书与OpenClaw交互了。
6. 工具权限配置
OpenClaw通过tools.profile控制权限级别:
bash复制# 查看当前权限配置
openclaw config get tools.profile
# 设置为full权限(谨慎使用)
openclaw config set tools.profile full
# 重启网关使配置生效
openclaw gateway restart
权限级别说明:
- minimal: 仅基础会话功能
- coding: 文件读写和执行命令(默认)
- messaging: 消息发送相关功能
- full: 全部权限(包括浏览器控制等)
重要:full权限下OpenClaw可以执行任意命令,请确保只在受信任的环境中使用。
7. 实际使用案例
7.1 文件管理
你可以让OpenClaw:
- 整理下载文件夹
- 批量重命名文件
- 查找并删除重复文件
示例指令:
"请帮我整理~/Downloads文件夹,将图片、文档和压缩包分别放到对应的子文件夹中"
7.2 自动化办公
OpenClaw可以:
- 生成并编辑PPT
- 处理Excel表格
- 撰写和格式化文档
示例指令:
"帮我创建一个关于季度销售报告的PPT,10页左右,使用公司模板"
7.3 开发辅助
对开发者特别有用:
- 编写和测试代码片段
- 运行和调试脚本
- 管理开发环境
示例指令:
"请用Python写一个Flask API,实现用户登录功能,并添加Swagger文档"
7.4 网页生成与发布
结合cpolar内网穿透,可以:
- 创建个人简历网页
- 搭建临时演示环境
- 分享本地开发中的项目
示例指令:
"用HTML写一个响应式个人简历页面,美观专业一些,然后通过cpolar分享出来"
8. 高级功能配置
8.1 安装cpolar内网穿透
bash复制brew tap probezy/core && brew install cpolar
sudo cpolar service install
sudo cpolar service start
注册账号后,你可以:
- 将本地服务暴露到公网
- 获取固定子域名
- 管理多个隧道
8.2 自定义技能(Skills)
OpenClaw支持通过skills扩展能力。创建一个skill只需要:
- 在~/.openclaw/skills目录下新建文件夹
- 创建skill.json定义元数据
- 编写JavaScript或Python实现功能
示例skill结构:
code复制my-skill/
├── skill.json
└── index.js
8.3 定时任务
通过cron表达式可以让OpenClaw定期执行任务:
bash复制openclaw task create "0 9 * * *" "提醒我每天9点站会"
9. 安全注意事项
- 保管好你的API密钥和飞书App Secret
- 谨慎使用full权限模式
- 不要将机器人开放给不受信任的用户
- 定期检查OpenClaw的日志文件
- 考虑设置IP白名单限制访问
日志文件位置:~/.openclaw/logs/
10. 性能优化建议
- 为常用命令创建别名:
bash复制alias ocl="openclaw"
- 使用更高效的模型(如GPT-4-turbo)
- 对复杂任务拆分成多个简单指令
- 定期清理~/.openclaw/workspace/tmp_files/
- 监控资源使用情况:
bash复制openclaw status
11. 常见问题解决
11.1 安装问题
Homebrew安装慢:
使用国内镜像:
bash复制export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
Node.js版本问题:
如果遇到版本冲突,可以使用nvm管理多版本:
bash复制brew install nvm
nvm install 22
nvm use 22
11.2 连接问题
飞书机器人无响应:
- 检查OpenClaw网关是否运行:
bash复制openclaw gateway status
- 确认飞书应用已发布
- 检查长连接配置是否正确
模型API调用失败:
- 检查API密钥是否有效
- 确认账号有足够额度
- 尝试更换API Base URL
11.3 权限问题
文件操作被拒绝:
- 检查tools.profile设置
- 确认文件路径正确
- 检查文件权限:
bash复制ls -l 文件路径
12. 最佳实践分享
经过几个月的实际使用,我总结出这些经验:
-
指令要具体:与其说"帮我整理文件",不如说"请按扩展名将~/Downloads中的文件分类到对应的子文件夹中"
-
分步验证:对于重要操作,先让AI告诉你它将做什么,确认后再执行
-
善用MEMORY:让AI把常用解决方案写入~/.openclaw/workspace/MEMORY.md,方便以后查阅
-
组合使用:将多个简单指令组合成工作流,比如:
- 生成报告文档
- 转换为PDF
- 通过飞书发送给指定联系人
-
定期维护:每月检查一次:
- 清理临时文件
- 更新OpenClaw和依赖
- 审核任务历史
13. 扩展思路
OpenClaw的潜力远不止于此,你可以尝试:
- 家庭自动化:结合Homebridge控制智能家居
- 个人知识管理:自动整理笔记和书签
- 投资分析:处理财经数据并生成报告
- 创意工作:辅助写作、设计和音乐创作
- 教育辅助:创建个性化学习计划和测验
关键是根据你的需求,找到AI能真正带来效率提升的场景,而不是为了用AI而用AI。
