真实用户实战总结,帮你避坑
前言
最近在我的主力Macbook上装了一只OpenClaw小龙虾,用来帮我管理项目。几天用下来,从“这啥玩意”到“真香”,中间踩了不少坑。今天把我的经验整理出来,都是真实踩过的坑,想养小龙虾的朋友可以看看。
一、OpenClaw是什么?能干嘛?
1.1 啥是OpenClaw?
简单说,OpenClaw就是让你在飞书、WhatsApp、Telegram、Discord等平台上直接用AI的工具。
它相当于一个“AI中枢”,把各种聊天软件和AI大脑连起来。你只需要在某个平台发消息,AI就能收到并回复,还能操作你的电脑、Mac、服务器,主动帮你干活。
1.2 普通人能干啥?
具体场景:
- 私人AI助手:在飞书/微信上直接跟AI对话,问问题、记录日常、让它帮忙干活
- 自动写文章:设置定时任务,让AI每天早上自动生成内容并发布
- 新闻简报:AI自动抓取新闻、定时推送到你的账号
- 日程提醒:让AI在特定时间提醒你做某件事
- 多平台管理:一个AI同时管理多个平台的账号
- 自动化工作流:比如自动回复、自动整理信息、自动发社交媒体
举例说明:
我设置的几个定时任务:
- 每天早上8点:自动发一条有价值的AI动态到 X / 小红书
- 每天10点:AI自动抓取新闻,生成简报发给我
- 每天14点:发一条午间资讯
- 每天21点:发一条当天热点总结
这些都不需要我手动操作,AI全自动完成。
1.3 需要技术背景吗?
安装巨简单,完全不需要技术背景。
安装就一行命令,配置有图形界面,日常使用就是在飞书/TG上发消息,就像加了个随叫随到的“全能助理”好友。
但实际用起来还是要调教。
OpenClaw虽然安装简单,但作为开源工具目前还不够稳定,版本更新特别快,一天一个版本,很多功能用起来不太人性化,前期需要调教。但如果你有耐心度过新手期,坚持用一周,你会发现这完全是个跨时代的产品!
二、安装:简单到不敢信
2.0 系统要求
- Node >=22
- macOS、Linux 或 WSL2 的 Windows
2.1 一行命令搞定
curl -fsSL https://openclaw.ai/install.sh | bash
接下来就会自动检测系统环境,执行安装计划,需要等待5-10分钟完成安装。

2.2 初始化设置
安装完成后会自动弹出提示,选择yes

进入新手引导设置选择QuickStart,接下来进入模型服务商选择页面,这里你可以选择你的模型服务商填写对应的API Key,如果你还没有准备好,可以拉到最底下选择Skip暂时跳过。

我这里用了MiniMax M2.5 和GLM-4.7,推荐MiniMax和GLM的Code Plan,比较省钱,这里要选择第三个,回车粘贴API key。
使用我的邀请链接9折。
🎁 MiniMax 跨年福利来袭!邀好友享 Coding Plan 双重好礼,助力开发体验! 好友立享 9折 专属优惠 + Builder 权益,你赢返利 + 社区特权! 👉 立即参与:https://platform.minimaxi.com/subscribe/coding-plan?code=G5jYXJg2Qh&source=link

接下来进入消息渠道选择,国内用户用飞书最方便,这篇我给大家重点说飞书如何配置,如果你还没有准备好飞书开发者后台的机器人的App ID和Key,依然可以先选择最底下的Skip跳过,后面再进行配置。

然后进入内置Skill选择界面,空格选中,如果你暂时不想选可以选择skip跳过,然后回车继续。
有可能会因为网络问题安装失败,可以跳过后面单独安装

下一步让你输入多个API key,可以先选择NO。

hooks可以都选择

这时会让你启动Gateway,稍等片刻提示,选择第一个,就进入到小龙虾命令行的交互界面,连续按几次Ctrl + C 即可退出。复制Web UI (with token)中的URL到浏览器打开即可打开网页版小龙虾。


恭喜你,此时已经完成安装。
常用命令:
# 再次启动新手引导设置
openclaw onboard
# 手动安装飞书渠道插件
openclaw plugins install @openclaw/feishu
# 手动添加飞书渠道,然后根据交互式提示选择 Feishu,输入 App ID 和 App Secret 即可。
openclaw channels add
# 重新启动 Gateway
openclaw gateway restart
# 打开网页版窗口
openclaw dashboard
就选择这么几步,一个AI助手就装好了。
2.3 快速验证,访问你的网页版OpenClaw
打开浏览器访问 http://127.0.0.1:18789/ ,或者通过命令:openclaw dashboard 即可打开网页版界面。

三、配置:飞书怎么配
3.1 配置文件在哪
~/.openclaw/openclaw.json
除了交互式命令行、网页版GUI,你还能直接编辑这个配置文件,用JSON5格式,支持注释,文本编辑器就能改。改完openclaw gateway restart重启网关就生效。
3.2 飞书配置
虽然你的小龙虾已经配好了,但最重要的是你要有消息渠道、聊天入口,随时随地指挥你的小龙虾干活。国内用户用飞书最方便,下面是重点的飞书配置方法。
第一步:创建飞书应用
1. 打开飞书开放平台
访问 飞书开放平台 https://open.feishu.cn/app 使用飞书账号登录。
**Lark(国际版)**请使用 https://open.larksuite.com/app,并在配置中设置 domain: "lark"。
2. 创建应用
- 点击 创建企业自建应用
- 填写应用名称和描述
- 选择应用图标

3. 获取应用凭证
在应用的 凭证与基础信息 页面,复制:
- App ID(格式如
cli_xxx) - App Secret
❗ 重要:请妥善保管 App Secret,不要分享给他人。

4. 配置应用权限
官方文档里的少了一个权限:contact:contact.base:readonly 我已经在下方的权限里补充了,直接复制粘贴即可。
在 权限管理 页面,点击 批量导入 按钮,粘贴以下 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:contact.base:readonly",
"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. 启用机器人能力
在 应用能力 > 机器人 页面:
- 开启机器人能力
- 配置机器人名称

第二步:配置 OpenClaw
方法一、通过向导配置(推荐,适合小白)
运行以下命令,根据提示粘贴 App ID 和 App Secret:
openclaw channels add
选择 Feishu,然后输入您在第一步获取的凭证即可。
方法二、通过配置文件配置(详细配置)
相关配置已经设置好,直接替换你的appId、appSecret、botname即可使用,编辑 ~/.openclaw/openclaw.json:
"channels": {
"feishu": {
"enabled": true,
"domain": "feishu",
"requireMention": false,
"accounts": {
"main": {
"appId": "cli_a92XXXXXX",
"appSecret": "643UrXXXXXX",
"botname": "机器人1",
"groupPolicy": "open",
"dmPolicy": "open",
"allowFrom": ["*"]
}
}
}
},
其中:
“enabled”: true 是否开启机器人
“groupPolicy”: “open” 是群组策略
"open"= 允许群组中所有人(默认)"allowlist"= 仅允许groupAllowFrom中的用户"disabled"= 禁用群组消息
“requireMention”: false 是群组访问时是否需要@提及
true= 需要 @机器人才响应(默认)false= 无需 @也响应
“dmPolicy”: “open” 私聊访问
-
默认:
dmPolicy: "pairing",陌生用户会收到配对码 -
在你的Mac终端里执行命令批准配对:
openclaw pairing list feishu # 查看待审批列表 openclaw pairing approve feishu <CODE> # 批准 -
白名单模式:通过
channels.feishu.allowFrom配置允许的用户 Open ID
dmPolicy 策略说明
| 值 | 行为 |
|---|---|
"pairing" |
默认。未知用户收到配对码,管理员批准后才能对话 |
"allowlist" |
仅 allowFrom 列表中的用户可对话,其他静默忽略 |
"open" |
允许所有人对话(需在 allowFrom 中加 "*") |
"disabled" |
完全禁止私聊 |
第三步:飞书机器人事件订阅与发布
1. 配置事件订阅
⚠️ 重要提醒:在配置事件订阅前,请务必确保已完成以下步骤:
- 运行
openclaw channels add添加了 Feishu 渠道 - 网关处于启动状态(可通过
openclaw gateway status检查状态)
在 事件订阅 页面:
- 选择 使用长连接接收事件(WebSocket 模式)
- 添加事件:
im.message.receive_v1(接收消息)
⚠️ 注意:如果网关未启动或渠道未添加,长连接设置将保存失败。**添加事件订阅这一步十分重要!**我有两个机器人忘记配置这个了,排查了好久才注意到,浪费好长时间。

2. 发布应用
- 在 版本管理与发布 页面创建版本
- 提交审核并发布
- 等待管理员审批(企业自建应用通常自动通过)
3.3 测试发送飞书消息
第一次需要复制配对命令到终端中,才可以建立与这个agent的连接


出现这样的提示则代表配对成功,后面就可以随时随地和你的小龙虾发消息啦。
3.4 定时任务
这是OpenClaw的一个杀手级功能。设置好定时任务,AI就会自动帮你干活,可以通过下面的命令。当然更直接的就是你和他说:每天10点给我发送AI新闻简报,信息来源:a16z、hackernews、36k。
# 每天早上8点发X
openclaw cron add --name "早安X" --cron "0 8 * * *" --message "发一条X"
# 每天10点新闻简报
openclaw cron add --name "AI简报" --cron "0 10 * * *" --message "抓取AI新闻"
四、踩坑实录:全是泪
坑1:飞书发消息显示成功但收不到
现象:发消息显示成功,但对方说没收到。
排查过程:查了半天才发现,Gateway被重启了!日志显示是子agent执行时触发超时,导致整个进程被系统杀掉。
解决:用openclaw status检查Gateway状态,确保服务稳定运行。定时任务别设置太长的超时时间。
坑2:定时任务写入文件失败
现象:定时任务配置了写文件到指定目录,但一直失败。
排查过程:报错显示“Path escapes workspace root”。原来是OpenClaw的write工具被限制在工作区内,无法写入~/Documents/Projects/这样的外部路径。
解决:使用exec工具执行cat命令来写入文件,或者直接问你的小龙虾怎么解决
exec 工具执行 "cat > /path/to/file.md << 'EOF'
内容
EOF"
坑3:X发帖只有tag没有正文
现象:定时任务发的X帖子只有一堆tag,正文是空的,尴尬极了。
排查过程:一看prompt才发现当初只强调了tag,完全没提正文的事。
解决:发帖prompt要明确格式:
正文内容(50-100字)
#tag1 #tag2 #tag3
坑4:定时任务投递到飞书失败
现象:任务执行成功,但飞书收不到通知。
排查过程:日志显示“No delivery target resolved”。原来是没配置收件人!
解决:配置正确的收件人,直接和你的小龙虾说即可,附上你的飞书ID:ou_xxxxx
openclaw cron edit <job-id> --channel feishu --account main --to "ou_xxxxx"
坑5:Gateway自动退出
现象:好端端的,Gateway自己就停了。
排查过程:可能是自动锁屏、断网、OOM(内存不足)、配置错误、或者系统信号。
解决:
- 用
openclaw status检查状态 - 用
openclaw logs --follow查看实时日志 - 必要时重启Gateway
- 或者直接让你的小龙虾排查日志
坑6:最严重的失忆问题!!!
现象:电脑/服务器重启,OpenClaw进程中断重新打开,或者第二天之前让AI记住的东西全忘了。
排查过程:查了半天才知道——session-memory hook只在/new命令时触发保存,不是每次会话结束或重启时自动保存!
解决方案一:别完全依赖自动保存,让你的小龙虾自己搞定:
- 重要任务开始时 → 主动记录到
memory/YYYY-MM-DD.md - 任务完成后 → 更新状态到memory
- 每天结束前 → 汇总到
MEMORY.md - 定期用Git备份整个
.openclaw目录(可以让小龙虾自己做)
cd ~/.openclaw
git init
git add memory/ MEMORY.md
git commit -m "Backup memory"
解决方案二:搭建记忆系统(推荐!让AI自动记住重要的事):
OpenClaw提供了自动化记忆功能,只需配置几个文件,AI就能在每次对话时自动加载记忆:
-
配置记忆文件(在workspace目录下):
MEMORY.md- 长期记忆(重要信息、偏好、决策)memory/YYYY-MM-DD.md- 每日工作日志AGENTS.md- 智能体身份配置
-
配置自动加载(在workspace的AGENTS.md中添加):
## Every Session Before doing anything else: 1. Read `SOUL.md` — this is who you are 2. Read `USER.md` — this is who you're helping 3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context -
养成好习惯:
- 重要任务开始时 → 主动记录到memory
- 任务完成后 → 更新状态
- 定期用Git备份整个
.openclaw目录
-
Git备份(重要!防止数据丢失)
这样每次对话时,AI会自动读取这些记忆文件,即使重启也不会失忆啦!
五、进阶技巧
5.1 开机自启
Mac用户可以用LaunchAgent,开机自动启动:
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist
5.2 Git版本管理
强烈建议把配置目录 ~/.openclaw 纳入Git管理。改配置前提交一次,出了问题随时回滚:
cd ~/.openclaw
git init
# 配置.gitignore排除敏感文件
git add .
git commit -m "Initial commit"
5.3 定时任务执行情况检查
设置每小时健康检查,自动补执行务。万一定时任务因为Gateway重启错过了,下个小时还能补上,直接和你的小龙虾说,或者执行:
openclaw cron add --name "健康检查" --cron "0 * * * *" --message "检查并执行未完成的任务"
openclaw cron add --name "健康检查" --cron "0 * * * *" --message "检查并执行未完成的任务"
六、总结
前面很多使用技巧包含的命令都可以直接让小龙虾自己完成,你只要给他提需求就行,然后你就感觉打开了新世界的大门,你也有独属于自己的打工机器人了。
OpenClaw确实是个强大的工具,但用起来有些坑需要避开。这篇文章总结的6个坑,都是我实际踩过的,希望能让你的安装使用之路顺畅些。
如果还有其他问题,欢迎评论区聊聊。
下一期讲讲怎么在飞书里用上多Agent,带大家体验一下被一群机器人包围的感觉哈哈~
