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

修改 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. 打开飞书开放平台：https://open.feishu.cn
2. 创建 企业自建应用，填写应用名称和描述。
3. 记录 App ID 和 App Secret。
4. 开通核心权限：
   • 「应用身份权限」：搜索 im:message，全部选中并开通。
   • 「用户身份权限」：搜索 contact:user.base:readonly，选中并开通。
5. 订阅方式选择长连接，添加接收消息事件 im.message.receive_v1。
6. 创建新版本并发布申请线上发布。

六、配置 OpenClaw 的飞书能力

步骤一：安装 OpenClaw 飞书插件

openclaw plugins install @m1heng-clawd/feishu

在 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

七、飞书机器人配对授权

1. 终端执行配对命令获取配对码。
2. 在飞书向配置的机器人发送任意消息，机器人会自动回复包含配对码的消息。
3. 执行配对命令：

openclaw pairing approve feishu xxxx

4. 重启网关使授权生效：

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

九、常见问题解决

问题 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 与协作工具结合时，许多重复工作可以实现自动化，如自动日报、自动会议总结、自动任务创建等。