在 AI Agent 和自动化工具越来越普及的今天，越来越多开发者希望拥有一个 能够自动处理任务、接入团队协作工具的 AI 助手。
最近OpenClaw火的一塌糊涂，我也跟风研究了一下这个开源项目。它可以理解为一个 可扩展的 AI Agent 框架，支持接入各种工具、自动执行任务，并且可以和企业协作平台（如飞书）打通，实现 AI 自动回复、自动化工作流。
本文将带大家 从 0 开始，在 MacOS 上安装 OpenClaw，并接入飞书机器人。
同时我也整理了自己在安装过程中遇到的 终端报错问题与完整解决方案，让你一次性避坑。



本文包含：
 
  
    
    
 
     
MacOS 安装 OpenClaw
 
     
接入飞书机器人
 
     
配置开机自启
 
     
终端报错解决（compdef / compinit）
 
    
 
  
    
    
 
     
简单来说，OpenClaw 是一个 开源 AI Agent 平台，具备以下能力：
 
     
 
      
支持接入 LLM（OpenAI / DeepSeek / Claude 等）
 
      
可以调用工具执行任务
 
      
支持自动化流程
 
      
支持企业协作平台接入（飞书 / Slack）
 
     
 
     
如果把传统 AI 聊天比作 一个会聊天的大脑，那么 OpenClaw 更像是：
 
     

       一个会思考、会调用工具、还能帮你自动做事的 AI 助手。 
     
 
     
例如：
 
     
 
      
飞书自动回复
 
      
自动总结群消息
 
      
自动生成日报
 
      
自动创建任务
 
      
自动执行脚本
 
     
 
     
 
      
建议版本：
 
      
MacOS 12+ 
 
      
Intel 和 Apple Silicon 都可以。
 
      
 
       
如果没有安装 Homebrew：
 
       
/bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
       
更新 brew：
 
       
brew update 
 
       
 
         
       
 
       
 
         
       
 
       
 
         
       
 
       
 
        
OpenClaw 依赖 Node.js 运行环境。
 
        
brew installnode
 
        
验证：
 
        
node-vnpm-v
 
        
 
          
        
 
        
 
         
 
           
         
 
         
npm i -g openclaw 
 
         
 
           
         
 
         
openclaw onboard 
 
         
 
           
         
 
         
openclaw dashboard 
 
         
 
           
         
 
         
 
           
         
 
         
在 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":,"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"}}
 
         
 
           
         
 
         
 
           
         
 
         
打开飞书开放平台：
 
         
https://open.feishu.cn 
 
         
创建 企业自建应用
 
         
 
           
         
 
         
 
           
         
 
         
 
           
         
 
         
 
           
         
 
         
 
          
「应用身份权限」：搜索im:message，全部选中并开通；
 
          
「用户身份权限」：搜索contact:user.base:readonly，选中并开通；
 
         
 
         
 
           
         
 
         
 
          
openclaw plugins install @m1heng-clawd/feishu 
 
          
OpenClaw会自动完成安装、配置、重启。
 
          
在OpenClaw中配置飞书参数
 
          
终端执行以下命令，将和替换为飞书应用的实际信息：
 
          
# 配置飞书App ID openclaw config set channels.feishu.appId " 
          
      
            
              "# 配置飞书App Secret openclaw config set channels.feishu.appSecret " 
             
               "# 启用飞书渠道 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 onboard --install-daemon 
 
          
重启电脑即可自动启动。
 
          
创建 LaunchAgent：
 
          
mkdir-p ~/Library/LaunchAgents 
 
          
创建配置文件：
 
          
vim ~/Library/LaunchAgents/com.openclaw.gateway.plist 
 
          
内容：
 
          
 
          
      
             
          
      
             
              
              
                Label 
               
              
                com.openclaw.gateway 
               
              
                ProgramArguments 
               
               
               
                 /usr/local/bin/openclaw 
                
               
                 gateway 
                
               
                 start 
                
               
              
                RunAtLoad 
               
               
              
                KeepAlive 
               
               
              
            
 
          
加载服务：
 
          
launchctl bootstrap gui/$(id-u) ~/Library/LaunchAgents/com.openclaw.gateway.plist 
 
          
验证：
 
          
launchctl list |grep openclaw 
 
          
 
           
在配置 OpenClaw 时，我遇到了两个典型问题。
 
           
 
            
compdef: command not found 
 
            
原因
 
            
macOS 默认 未启用 zsh 补全系统，
而 OpenClaw 的自动补全脚本依赖 compdef。



 
            
 
             
zsh compinit: insecure directories 
 
             
原因
 
             
zsh 补全目录权限不安全。
 
             
 
              
brew install zsh-completions 
 
              
 
               
nano ~/.zshrc 
 
               
在文件最顶部添加：
 
               
autoload -Uz compinit && compinit -i -u if type brew &>/dev/null; then fpath=($(brew --prefix)/share/zsh-completions $fpath) fi 
 
               
sudochmod-R go-w $(brew --prefix)/share/zsh-completions sudochown-R$(whoami)$(brew --prefix)/share/zsh-completions sudochmod-R go-w /usr/share/zsh sudochown-R root:wheel /usr/share/zsh 
 
               
 
                
rm-f ~/.zcompdump* source ~/.zshrc 
 
                
 
                 
重新打开终端：
 
                 
source ~/.zshrc 
 
                 
如果没有任何报错，说明成功。
 
                 
测试：
 
                 
openclaw + TAB 
 
                 
能看到命令补全。
 
                 
 
                  
如果不需要命令补全，可以直接禁用：
 
                  
echo'export OPENCLAW_COMPLETIONS_DISABLE=1'>> ~/.zshrc rm-f ~/.openclaw/completions/openclaw.zsh source ~/.zshrc 
 
                  
 
                   
通过本文，我们完成了：
 
                   
当 AI Agent + 协作工具结合时，很多重复工作都可以自动化。
 
                   
未来你可以扩展：
 
                   
 
                    
自动日报
 
                    
自动会议总结
 
                    
自动任务创建
 
                    
自动客服机器人
 
                   
 
                   
OpenClaw 是一个非常值得尝试的 AI Agent 开源项目。
 
                   
如果觉得文章有帮助，欢迎 点赞 + 收藏 + 关注作者