MacOS 安装 OpenClaw 并接入飞书机器人

最后这个我选择 Web UI，当然你也可以选择 TUI 这个是用命令行窗口聊天，我习惯用 web 页面。后续在想进入这个配置页面的话可以使用仪表盘命令

openclaw dashboard

然后就会自动打开一个网页看到龙虾的配置页面了。

四、配置 AI 模型

点击'配置'然后点击右边的 open 按钮打开配置源文件修改。

在 json 文件的根节点上看下有没有 models 属性，没有就新建个，有就修改它；

{
  "models": {
    "mode": "merge",
    "providers": {
      "unicom-cloud": {
        "baseUrl": "根据自己的模型服务上信息配置",
        "apiKey": "根据自己的模型服务上信息配置",
        "api": "openai-completions",
        "models": [
          {
            "id": "Qwen3.5-397B-A17B",
            "name": "Qwen3.5-397B-A17B",
            "reasoning": false,
            "input": ["text"],
            "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0},
            "contextWindow": 202752,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

以上是我的配置，我用的是联通云的服务，Qwen、DeepSeek 等都有官方文档教程可以到对应的官方查看下。

然后，再修改 agents.defaults（默认模型与工作空间配置）

{
  "agents": {
    "defaults": {
      "model": {"primary": "unicom-cloud/Qwen3.5-397B-A17B"},
      "models": {"unicom-cloud/Qwen3.5-397B-A17B": {}},
      "workspace": "/Users/当前登录用户/.openclaw/workspace"
    }
  }
}

保存并生效配置。

保存后点击 Update 按钮更新新配置。

再次启动后，选择刚才配置好的模型，在聊天窗口可以和龙虾聊天了。

五、接入飞书机器人

打开飞书开放平台：

https://open.feishu.cn

创建企业自建应用

填写应用名称（如 OpenClaw 机器人）、应用描述（可选），点击创建。

应用创建后，进入凭证与基础信息，记录 App ID 和 App Secret（后续配置需用）。 然后在配置飞书机器人权限与事件订阅。

开通核心权限：左侧菜单栏开发配置 → 权限管理

• 「应用身份权限」：搜索 im:message，全部选中并开通；
• 「用户身份权限」：搜索 contact:user.base:readonly，选中并开通；

订阅方式选择长连接。 添加接收消息事件：点击添加事件，搜索 im.message.receive_v1，添加该事件并确认开通对应权限。 好了可以创建版本并发布：点击页面顶部应用发布 → 版本管理与发布，创建新版本，填写更新说明后申请线上发布。

六、配置 openclaw 的飞书能力

步骤一：安装 OpenClaw 飞书插件 官方命令安装

openclaw plugins install @m1heng-clawd/feishu

OpenClaw 会自动完成安装、配置、重启。

在 OpenClaw 中配置飞书参数

终端执行以下命令，将 和 替换为飞书应用的实际信息：

# 配置飞书 App ID
openclaw config set channels.feishu.appId "<App ID>"
# 配置飞书 App Secret
openclaw config set channels.feishu.appSecret "<App Secret>"
# 启用飞书渠道
openclaw config set channels.feishu.enabled true
# 配置长连接模式（飞书推荐）
openclaw config set channels.feishu.connectionMode websocket
# 单聊策略为配对授权
openclaw config set channels.feishu.dmPolicy pairing
# 群聊策略为白名单
openclaw config set channels.feishu.groupPolicy allowlist
# 群聊需@机器人才响应
openclaw config set channels.feishu.requireMention true

配置完成后重启网关：

openclaw gateway restart

七、飞书机器人配对授权

飞书机器人配置完成后，需完成配对授权才能实现消息响应。 要配对可以按照以下流程：

• 终端执行配对命令获取配对码
• 在飞书向刚才配置的机器人发送任意消息，机器人会自动回复包含配对码的消息

openclaw pairing approve feishu xxxx

• 重启网关使授权生效

openclaw gateway restart

• 验证授权是否成功 再次向飞书机器人发送消息，机器人能正常回答就说明配置好了，不过测试的时候发现机器人答复的有点慢，需要多等一会。

八、配置 OpenClaw 开机自启（推荐）

为了避免每次手动启动，可以配置开机自启。

方法 1 官方守护进程（推荐）

openclaw onboard --install-daemon

重启电脑即可自动启动。

方法 2 LaunchAgent 手动配置（备用）

创建 LaunchAgent：

mkdir -p ~/Library/LaunchAgents

创建配置文件：

vim ~/Library/LaunchAgents/com.openclaw.gateway.plist

内容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.openclaw.gateway</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/openclaw</string>
<string>gateway</string>
<string>start</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>

加载服务：

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.openclaw.gateway.plist

验证：

launchctl list | grep openclaw

九、常见问题解决

在配置 OpenClaw 时，遇到了两个典型问题。

问题 1

compdef: command not found

原因

macOS 默认未启用 zsh 补全系统，而 OpenClaw 的自动补全脚本依赖 compdef。

问题 2

zsh compinit: insecure directories

原因

zsh 补全目录权限不安全。

十、完整解决方案（推荐）

1. 安装补全组件

brew install zsh-completions

2. 修改 .zshrc

nano ~/.zshrc

在文件最顶部添加：

autoload -Uz compinit && compinit -i -u
if type brew &>/dev/null; then
  fpath=($(brew --prefix)/share/zsh-completions $fpath)
fi

3. 修复目录权限

sudo chmod -R go-w $(brew --prefix)/share/zsh-completions
sudo chown -R $(whoami) $(brew --prefix)/share/zsh-completions
sudo chmod -R go-w /usr/share/zsh
sudo chown -R root:wheel /usr/share/zsh

4. 清理缓存

rm -f ~/.zcompdump*
source ~/.zshrc

十一、验证是否成功

重新打开终端：

source ~/.zshrc

如果没有任何报错，说明成功。

测试：

openclaw + TAB

能看到命令补全。

十二、懒人方案（可选）

如果不需要命令补全，可以直接禁用：

echo 'export OPENCLAW_COMPLETIONS_DISABLE=1' >> ~/.zshrc
rm -f ~/.openclaw/completions/openclaw.zsh
source ~/.zshrc

总结

通过本文，完成了 MacOS 安装 OpenClaw、接入飞书机器人、配置开机自启、解决终端报错。当 AI Agent 与协作工具结合时，很多重复工作都可以自动化。未来可以扩展自动日报、自动会议总结、自动任务创建、自动客服机器人等功能。OpenClaw 是一个非常值得尝试的 AI Agent 开源项目。