AllWorkin / Articles / 2026.03.02

养一只OpenClaw小龙虾:从安装到踩坑实录(Mac版)

最近在我的主力Macbook上装了一只OpenClaw小龙虾,用来帮我管理项目。几天用下来,从"这啥玩意"到"真香",中间踩了不少坑。今天把我的经验整理出来,都是真实踩过的坑,想养小龙虾的朋友可以看看。

2026.03.02约 11 分钟#OpenClaw#设计#快讯#Skills

真实用户实战总结,帮你避坑

前言

最近在我的主力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分钟完成安装。

![image-20260302230536232](/Users/chrislee/Library/Application Support/typora-user-images/image-20260302230536232.png)

2.2 初始化设置

安装完成后会自动弹出提示,选择yes

![image-20260302233211545](/Users/chrislee/Library/Application Support/typora-user-images/image-20260302233211545.png)

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

![image-20260302233515506](/Users/chrislee/Library/Application Support/typora-user-images/image-20260302233515506.png)

我这里用了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

![image-20260302233700214](/Users/chrislee/Library/Application Support/typora-user-images/image-20260302233700214.png)

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

![image-20260302234412818](/Users/chrislee/Library/Application Support/typora-user-images/image-20260302234412818.png)

然后进入内置Skill选择界面,空格选中,如果你暂时不想选可以选择skip跳过,然后回车继续。

有可能会因为网络问题安装失败,可以跳过后面单独安装

![image-20260303000216771](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303000216771.png)

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

![image-20260303003058421](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303003058421.png)

hooks可以都选择

![image-20260303003230044](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303003230044.png)

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

![image-20260303003823544](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303003823544.png)

![image-20260303003929926](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303003929926.png)

恭喜你,此时已经完成安装。

常用命令:

# 再次启动新手引导设置
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 即可打开网页版界面。

![image-20260303004914305](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303004914305.png)


三、配置:飞书怎么配

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. 创建应用
  1. 点击 创建企业自建应用
  2. 填写应用名称和描述
  3. 选择应用图标

![image-20260303152505777](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303152505777.png)

3. 获取应用凭证

在应用的 凭证与基础信息 页面,复制:

  • App ID(格式如 cli_xxx)
  • App Secret

❗ 重要:请妥善保管 App Secret,不要分享给他人。

![image-20260303152637417](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303152637417.png)

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"]
  }
}

![image-20260303153039425](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303153039425.png)

5. 启用机器人能力

在 应用能力 > 机器人 页面:

  1. 开启机器人能力
  2. 配置机器人名称

![image-20260303153238486](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303153238486.png)

第二步:配置 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. 配置事件订阅

⚠️ 重要提醒:在配置事件订阅前,请务必确保已完成以下步骤:

  1. 运行 openclaw channels add 添加了 Feishu 渠道
  2. 网关处于启动状态(可通过 openclaw gateway status 检查状态)

在 事件订阅 页面:

  1. 选择 使用长连接接收事件(WebSocket 模式)
  2. 添加事件:im.message.receive_v1(接收消息)

⚠️ 注意:如果网关未启动或渠道未添加,长连接设置将保存失败。**添加事件订阅这一步十分重要!**我有两个机器人忘记配置这个了,排查了好久才注意到,浪费好长时间。

![image-20260303153600385](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303153600385.png)

2. 发布应用
  1. 在 版本管理与发布 页面创建版本
  2. 提交审核并发布
  3. 等待管理员审批(企业自建应用通常自动通过)

3.3 测试发送飞书消息

第一次需要复制配对命令到终端中,才可以建立与这个agent的连接

![image-20260303162529147](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303162529147.png)

![image-20260303163144941](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303163144941.png)

出现这样的提示则代表配对成功,后面就可以随时随地和你的小龙虾发消息啦。

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命令时触发保存,不是每次会话结束或重启时自动保存!

解决方案一:别完全依赖自动保存,让你的小龙虾自己搞定:

  1. 重要任务开始时 → 主动记录到memory/YYYY-MM-DD.md
  2. 任务完成后 → 更新状态到memory
  3. 每天结束前 → 汇总到MEMORY.md
  4. 定期用Git备份整个.openclaw目录(可以让小龙虾自己做)
cd ~/.openclaw
git init
git add memory/ MEMORY.md
git commit -m "Backup memory"

解决方案二:搭建记忆系统(推荐!让AI自动记住重要的事):

OpenClaw提供了自动化记忆功能,只需配置几个文件,AI就能在每次对话时自动加载记忆:

  1. 配置记忆文件(在workspace目录下):

    • MEMORY.md - 长期记忆(重要信息、偏好、决策)
    • memory/YYYY-MM-DD.md - 每日工作日志
    • AGENTS.md - 智能体身份配置
  2. 配置自动加载(在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
  3. 养成好习惯:

    • 重要任务开始时 → 主动记录到memory
    • 任务完成后 → 更新状态
    • 定期用Git备份整个.openclaw目录
  4. 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,带大家体验一下被一群机器人包围的感觉哈哈~

![image-20260303170853776](/Users/chrislee/Library/Application Support/typora-user-images/image-20260303170853776.png)


参考文档:https://docs.openclaw.ai/zh-CN

AI工具实战派

觉得有用?每周的新笔记先发公众号。

每周的实战笔记先发在这里。扫码关注,新文章第一时间推给你。

关注 / 加入社群 →