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

OpenClaw 是一个开源 AI Agent 框架，支持接入 LLM（如 OpenAI、DeepSeek、Claude），调用工具执行任务，并可与协作平台（如飞书）打通，实现 AI 自动回复和自动化工作流。

一、环境准备

1. MacOS 系统

建议版本：MacOS 12+（Intel 和 Apple Silicon 均支持）。

2. 安装 Homebrew

若未安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

更新 brew：

brew update

如遇更新失败，可切换国内源或使用 VPN。

3. 安装 Node.js

OpenClaw 依赖 Node.js 运行环境。

brew install node

验证安装：

node -v
npm -v

二、安装 OpenClaw

推荐使用 npm 方式安装（适用于 MacOS 12+）：

npm i -g openclaw

安装完成后启动初始化：

openclaw onboard

按提示操作，大部分选项可选择跳过，后续可在 WebUI 配置。启动 Web UI：

openclaw dashboard

三、配置 AI 模型

在 WebUI 中点击'配置'，打开配置文件修改。确保根节点下有 models 属性。示例配置（以联通云 Qwen 为例）：

{
  "models": {
    "mode": "merge",
    "providers": {
      "unicom-cloud": {
        "baseUrl": "你的服务地址",
        "apiKey": "你的 API Key",
        "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
          }
        ]
      }
    }
  }
}

同时修改 agents.defaults 配置默认模型与工作空间：

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

保存后点击 Update 按钮生效。

四、接入飞书机器人

1. 创建企业自建应用

访问飞书开放平台，创建企业自建应用，记录 App ID 和 App Secret。

2. 配置权限与事件订阅

开通核心权限：搜索 im:message 全部选中；搜索 contact:user.base:readonly 选中。
订阅方式选择长连接。
添加接收消息事件：搜索 im.message.receive_v1 并确认开通。
发布新版本至线上。

3. 配置 OpenClaw 飞书能力

安装插件：

openclaw plugins install @m1heng-clawd/feishu

配置参数（替换实际信息）：

openclaw config set channels.feishu.appId "<App ID>"
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

4. 配对授权

向飞书机器人发送任意消息获取配对码，终端执行：

openclaw pairing approve feishu <配对码>

再次重启网关使授权生效。

五、配置开机自启

方法 1：官方守护进程

openclaw onboard --install-daemon

方法 2：LaunchAgent 手动配置

创建 LaunchAgent 目录：

mkdir -p ~/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

六、常见问题解决

问题 1：compdef: command not found

macOS 默认未启用 zsh 补全系统，OpenClaw 依赖 compdef。

问题 2：zsh compinit: insecure directories

zsh 补全目录权限不安全。

解决方案

安装补全组件：
```
brew install zsh-completions
```

修改 .zshrc，在文件顶部添加：

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

修复目录权限：

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

清理缓存：
```
rm -f ~/.zcompdump*
source ~/.zshrc
```

七、总结

本文介绍了在 MacOS 上安装 OpenClaw、配置 AI 模型、接入飞书机器人及开机自启的方法，并解决了常见的终端报错问题。结合 AI Agent 与协作工具可实现自动日报、会议总结等重复工作的自动化。

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