# 检查系统更新（图形界面） Apple Menu > 系统设置 > 通用 > 软件更新# 或者使用命令行softwareupdate --listsoftwareupdate --install --all

# 安装命令行工具xcode-select --install# 验证安装xcode-select -p# 应该输出: /Library/Developer/CommandLineTools# 查看 GCC 版本gcc --version

# 安装 Homebrew/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 验证安装brew --version# 更新 Homebrewbrew update

# 将 Homebrew 添加到 PATH（Apple Silicon）echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofileeval "$(/opt/homebrew/bin/brew shellenv)"

# 使用 Homebrew 安装 Gitbrew install git# 验证安装git --version# 配置 Git（可选）git config --global user.name "你的名字"git config --global user.email "你的邮箱"

# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash# 重新加载 shell 配置source ~/.zshrc  # 如果使用 zsh# 或source ~/.bashrc  # 如果使用 bash# 安装最新 LTS 版本的 Node.jsnvm install --ltsnvm use --lts# 设置默认版本nvm alias default lts/*# 验证安装node --version# 应该输出: v20.x.x 或更高npm --version# 应该输出: 10.x.x 或更高

# 全局安装 OpenClawnpm install -g openclaw# 验证安装openclaw --version# 查看帮助openclaw --help

🦞 OpenClaw 2026.3.2 (85377a2) — Give me a workspace and I'll give you fewer tabs, fewer toggles, and more oxygen.

# 添加 OpenClaw tapbrew tap openclaw/openclaw# 安装 OpenClawbrew install openclaw# 验证安装openclaw --version

# 克隆仓库git clone https://github.com/openclaw/openclaw.git ~/openclaw-srccd ~/openclaw-src# 安装依赖npm install# 链接到全局npm link# 验证安装openclaw --version

# 启动 Gatewayopenclaw gateway start# 检查 Gateway 状态openclaw gateway status# 查看 Gateway 日志openclaw gateway logs

✅ Gateway is runningPID: 12345Port: 19001Uptime: 00:05:23

# 实时查看日志openclaw gateway logs# 查看最近 50 行openclaw gateway logs --tail 50# 查看日志文件位置ls -la ~/.openclaw/logs/

cat > ~/Library/LaunchAgents/com.openclaw.gateway.plist << 'EOF'<?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>/opt/homebrew/bin/openclaw</string>        <string>gateway</string>        <string>start</string>    </array>    <key>RunAtLoad</key>    <true/>    <key>KeepAlive</key>    <true/>    <key>StandardOutPath</key>    <string>/Users/pmyx/.openclaw/logs/gateway-stdout.log</string>    <key>StandardErrorPath</key>    <string>/Users/pmyx/.openclaw/logs/gateway-stderr.log</string>    <key>WorkingDirectory</key>    <string>/Users/pmyx/.openclaw</string>    <key>EnvironmentVariables</key>    <dict>        <key>PATH</key>        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>    </dict></dict></plist>EOF

# 加载服务launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist# 启动服务launchctl start com.openclaw.gateway# 查看服务状态launchctl list | grep openclaw# 停止服务（如需）launchctl stop com.openclaw.gateway# 卸载服务（如需）launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist

cat > ~/openclaw-start.sh << 'EOF'#!/bin/bash# OpenClaw Gateway 自动启动脚本# 等待网络连接sleep 10# 启动 Gateway/opt/homebrew/bin/openclaw gateway start# 记录启动时间echo "OpenClaw Gateway started at $(date)" >> ~/.openclaw/gateway-startup.logEOF# 添加执行权限chmod +x ~/openclaw-start.sh

# 配置文件位置~/.openclaw/openclaw.json# 查看当前配置cat ~/.openclaw/openclaw.json

{  "model": {    "default": "zai/glm-4",    "providers": {      "openai": {        "apiKey": "sk-你的-openai-api-key"      },      "anthropic": {        "apiKey": "sk-ant-你的-anthropic-api-key"      },      "zai": {        "apiKey": "你的-zai-api-key"      }    }  }}

# 设置默认模型openclaw config set model.default "zai/glm-4"# 设置 OpenAI API Keyopenclaw config set model.providers.openai.apiKey "sk-..."# 设置 Anthropic API Keyopenclaw config set model.providers.anthropic.apiKey "sk-ant-..."# 设置 Z.ai API Keyopenclaw config set model.providers.zai.apiKey "..."

# 重启 Gateway 使配置生效openclaw gateway restart# 查看 Gateway 日志确认配置加载openclaw gateway logs | grep -i model

{  "channels": {    "feishu": {      "appId": "cli_你的-app-id",      "appSecret": "你的-app-secret",      "encryptKey": "你的加密-key",      "verificationToken": "你的验证-token"    }  }}

# 设置飞书 App IDopenclaw config set channels.feishu.appId "cli_..."# 设置飞书 App Secretopenclaw config set channels.feishu.appSecret "..."# 设置加密密钥openclaw config set channels.feishu.encryptKey "..."# 设置验证令牌openclaw config set channels.feishu.verificationToken "..."

# 安装 cloudflaredbrew install cloudflared# 登录 Cloudflarecloudflared tunnel login# 创建隧道cloudflared tunnel create openclaw# 配置隧道cat > ~/.cloudflared/config.yml << 'EOF'tunnel: 你的-tunnel-idcredentials-file: ~/.cloudflared/你的-tunnel-id.jsoningress:  - hostname: 你的域名.com    service: http://localhost:19001  - service: http_status:404EOF# 运行隧道cloudflared tunnel run openclaw

# 重启 Gatewayopenclaw gateway restart# 查看日志openclaw gateway logs# 在飞书中给应用发送消息# 应该能看到响应

{  "channels": {    "telegram": {      "token": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"    }  }}

# 使用命令行配置openclaw config set channels.telegram.token "你的-bot-token"

# 重启 Gatewayopenclaw gateway restart# 在 Telegram 中找到你的机器人# 发送 /start 命令# 开始与 OpenClaw 对话

{  "channels": {    "discord": {      "token": "MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.GhIjKl.MnOpqRsTUVwxyzABCdefGHIjklMNOpqRsTUVwxyz"    }  }}

# 使用命令行配置openclaw config set channels.discord.token "你的-discord-bot-token"

# 安装 ClawHub CLInpm install -g clawhub# 验证安装clawhub --version# 搜索技能clawhub search "搜索关键词"

# 搜索技能clawhub search self-improving# 安装技能clawhub install self-improving# 查看已安装的技能clawhub list

# 使用 GitHub 源安装curl -sSL https://raw.githubusercontent.com/jrr996shujin-png/tavily-search-skill/main/install.sh | bash# 验证安装ls -la ~/.openclaw/workspace/skills/tavily-search/

{  "skills": {    "entries": {      "web-search": {        "apiKey": "tvly-你的-tavily-api-key"      }    }  }}

# 使用命令行配置openclaw config set skills.entries.web-search.apiKey "tvly-..."# 测试搜索python3 ~/.openclaw/workspace/skills/tavily-search/scripts/search.py "今天新闻"

# 安装技能clawhub install weather# 测试（在聊天中）# "查询北京天气"

# 创建安装脚本cat > ~/openclaw-skills-install.sh << 'EOF'#!/bin/bashecho "开始安装常用 OpenClaw 技能..."skills=(  "self-improving"  "weather"  "github"  "coding-agent"  "feishu-doc"  "healthcheck")for skill in "${skills[@]}"; do  echo "正在安装 $skill..."  clawhub install "$skill"  sleep 2doneecho "技能安装完成！"EOF# 添加执行权限chmod +x ~/openclaw-skills-install.sh# 运行安装~/openclaw-skills-install.sh

cat > ~/Library/LaunchAgents/com.openclaw.gateway.plist << 'EOF'<?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>/opt/homebrew/bin/openclaw</string>        <string>gateway</string>        <string>start</string>    </array>    <key>RunAtLoad</key>    <true/>    <key>KeepAlive</key>    <true/>    <key>StandardOutPath</key>    <string>/Users/pmyx/.openclaw/logs/gateway-stdout.log</string>    <key>StandardErrorPath</key>    <string>/Users/pmyx/.openclaw/logs/gateway-stderr.log</string>    <key>WorkingDirectory</key>    <string>/Users/pmyx/.openclaw</string>    <key>EnvironmentVariables</key>    <dict>        <key>PATH</key>        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>        <key>HOME</key>        <string>/Users/pmyx</string>    </dict>    <key>ThrottleInterval</key>    <integer>60</integer>    <key>Nice</key>    <integer>0</integer></dict></plist>EOF

# 加载服务launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist# 启动服务launchctl start com.openclaw.gateway# 查看服务状态launchctl list | grep openclaw# 查看服务日志tail -f ~/.openclaw/logs/gateway-stdout.log# 重启服务launchctl restart com.openclaw.gateway# 停止服务launchctl stop com.openclaw.gateway# 卸载服务launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist

# 重启 Mac minisudo reboot# 重启后检查服务状态launchctl list | grep openclaw# 检查 Gateway 是否运行openclaw gateway status

cat > ~/openclaw-backup.sh << 'EOF'#!/bin/bash# OpenClaw 配置备份脚本BACKUP_DIR="$HOME/openclaw-backups"DATE=$(date +%Y%m%d_%H%M%S)# 创建备份目录mkdir -p "$BACKUP_DIR"# 备份配置文件cp ~/.openclaw/openclaw.json "$BACKUP_DIR/openclaw-$DATE.json"# 备份技能目录tar -czf "$BACKUP_DIR/skills-$DATE.tar.gz" -C ~/.openclaw/workspace skills/# 备份记忆文件tar -czf "$BACKUP_DIR/memory-$DATE.tar.gz" -C ~/.openclaw/memory .# 清理 30 天前的备份find "$BACKUP_DIR" -name "*.json" -mtime +30 -deletefind "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -deleteecho "备份完成: $DATE"ls -lh "$BACKUP_DIR" | tail -3EOFchmod +x ~/openclaw-backup.sh

# 编辑 crontabcrontab -e# 添加定时任务（每天凌晨 2 点备份）0 2 * * * /Users/pmyx/openclaw-backup.sh >> /Users/pmyx/openclaw-backup.log 2>&1

# 禁用 Spotlight 索引（可选）sudo mdutil -i off /# 禁用 Time Machine 本地快照（如果使用外部备份）sudo tmutil disablelocal

# 设置 Mac mini 永不休眠（适合 7×24 运行）sudo pmset -a displaysleep 0sudo pmset -a sleep 0sudo pmset -a disksleep 10# 允许网络唤醒（如需要）sudo pmset -a womp 1# 查看当前电源设置pmset -g

# 增加文件描述符限制echo "kern.maxfiles=65536" | sudo tee -a /etc/sysctl.confecho "kern.maxfilesperproc=65536" | sudo tee -a /etc/sysctl.conf# 增加共享内存sudo sysctl -w kern.sysv.shmmax=4194304sudo sysctl -w kern.sysv.shmall=1048576

cat > ~/Library/LaunchAgents/com.openclaw.logrotate.plist << 'EOF'<?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.logrotate</string>    <key>ProgramArguments</key>    <array>        <string>/usr/sbin/logrotate</string>        <string>/Users/pmyx/.openclaw/logrotate.conf</string>    </array>    <key>StartCalendarInterval</key>    <dict>        <key>Hour</key>        <integer>0</integer>        <key>Minute</key>        <integer>0</integer>    </dict></dict></plist>EOF

cat > ~/.openclaw/logrotate.conf << 'EOF'~/.openclaw/logs/*.log {    daily    rotate 7    compress    missingok    notifempty    copytruncate}EOF

# 设置 Node.js 最大内存（MB）export NODE_OPTIONS="--max-old-space-size=2048"# 添加到 shell 配置echo 'export NODE_OPTIONS="--max-old-space-size=2048"' >> ~/.zshrcsource ~/.zshrc

{  "gateway": {    "logLevel": "warn",    "maxConcurrentRequests": 10,    "requestTimeout": 30000,    "idleTimeout": 60000  }}

$ openclaw gateway startError: Port 19001 already in use

# 检查端口占用lsof -i :19001# 停止占用端口的进程kill -9 <PID># 或者使用不同的端口openclaw gateway start --port 19002

# 1. 检查 Gateway 状态openclaw gateway status# 2. 查看日志openclaw gateway logs | grep feishu# 3. 验证配置cat ~/.openclaw/openclaw.json | grep -A 10 feishu# 4. 测试网络连接（如果使用隧道）curl https://你的域名.com

# 1. 检查 API Key 配置cat ~/.openclaw/openclaw.json | grep -A 5 providers# 2. 重新配置 API Keyopenclaw config set model.providers.zai.apiKey "你的新-key"# 3. 切换到其他提供商openclaw config set model.default "openai/gpt-4o-mini"# 4. 重启 Gatewayopenclaw gateway restart

# 方式 1: 等待后重试sleep 60clawhub install skill-name# 方式 2: 手动从 GitHub 安装git clone <skill-repo-url> ~/.openclaw/workspace/skills/skill-name# 方式 3: 使用安装脚本curl -sSL <install-script-url> | bash

# 设置永不休眠sudo pmset -a sleep 0sudo pmset -a displaysleep 0# 防止磁盘休眠sudo pmset -a disksleep 0# 查看当前设置pmset -g

# 清理旧日志rm -rf ~/.openclaw/logs/*.log.1# 配置日志轮转（见上文"性能优化"部分）# 限制日志大小echo "*.log {    size 100M    rotate 5    compress    missingok    notifempty}" > ~/.openclaw/logrotate.conf

cat > ~/openclaw-diagnose.sh << 'EOF'#!/bin/bash# OpenClaw 系统诊断脚本echo "=== OpenClaw 系统诊断 ==="echo ""echo "1. 系统信息"echo "   macOS 版本: $(sw_vers -productVersion)"echo "   芯片架构: $(uname -m)"echo "   内存大小: $(sysctl hw.memsize | awk '{print $2/1024/1024/1024}') GB"echo ""echo "2. 软件版本"echo "   OpenClaw: $(openclaw --version 2>/dev/null || echo '未安装')"echo "   Node.js: $(node --version 2>/dev/null || echo '未安装')"echo "   npm: $(npm --version 2>/dev/null || echo '未安装')"echo "   Git: $(git --version 2>/dev/null || echo '未安装')"echo ""echo "3. Gateway 状态"openclaw gateway status 2>/dev/null || echo "   Gateway 未运行"echo ""echo "4. 端口占用"lsof -i :19001 2>/dev/null || echo "   端口 19001 未被占用"echo ""echo "5. 配置文件"echo "   配置文件存在: $([ -f ~/.openclaw/openclaw.json ] && echo '是' || echo '否')"echo "   配置文件大小: $(du -h ~/.openclaw/openclaw.json 2>/dev/null | awk '{print $1}')"echo ""echo "6. 日志文件"echo "   日志目录大小: $(du -sh ~/.openclaw/logs 2>/dev/null | awk '{print $1}')"echo "   最新日志:"tail -n 5 ~/.openclaw/logs/gateway-stdout.log 2>/dev/null | sed 's/^/   /'echo ""echo "7. 技能列表"ls -1 ~/.openclaw/workspace/skills 2>/dev/null | head -10 | sed 's/^/   - /'echo ""echo "8. launchd 服务"launchctl list | grep openclaw | sed 's/^/   /'echo ""echo "=== 诊断完成 ==="EOFchmod +x ~/openclaw-diagnose.sh

~/openclaw-diagnose.sh

# 1. 查看 Gateway 实时日志openclaw gateway logs# 2. 查看 Gateway 日志（最后 100 行）openclaw gateway logs --tail 100# 3. 筛选错误日志openclaw gateway logs | grep -i error# 4. 筛选飞书相关日志openclaw gateway logs | grep -i feishu# 5. 查看系统进程ps aux | grep openclaw# 6. 检查端口占用lsof -i :19001# 7. 测试 API 连接curl -X GET http://localhost:19001/health# 8. 查看磁盘使用df -h ~/.openclaw# 9. 查看内存使用top -l 1 | grep PhysMem# 10. 查看网络连接netstat -an | grep 19001

# 停止 Gatewayopenclaw gateway stop# 停止 launchd 服务launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist# 备份重要数据cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)# 删除配置rm -rf ~/.openclaw# 重新安装npm install -g openclaw# 重新配置openclaw gateway start

# 停止 Gatewayopenclaw gateway stop# 恢复配置文件cp ~/openclaw-backups/openclaw-YYYYMMDD_HHMMSS.json ~/.openclaw/openclaw.json# 恢复技能目录tar -xzf ~/openclaw-backups/skills-YYYYMMDD_HHMMSS.tar.gz -C ~/.openclaw/workspace/# 恢复记忆文件tar -xzf ~/openclaw-backups/memory-YYYYMMDD_HHMMSS.tar.gz -C ~/.openclaw/memory# 重启 Gatewayopenclaw gateway start

openclaw gateway start    # 启动openclaw gateway stop     # 停止openclaw gateway restart  # 重启openclaw gateway status   # 状态openclaw gateway logs     # 日志

openclaw config set <key> <value>  # 设置配置openclaw config get <key>           # 获取配置openclaw config unset <key>         # 删除配置openclaw config file                # 编辑配置文件

clawhub search <query>    # 搜索技能clawhub install <skill>    # 安装技能clawhub update <skill>     # 更新技能clawhub update --all       # 更新所有clawhub list               # 列出已安装clawhub remove <skill>     # 删除技能

~/openclaw-diagnose.sh     # 运行诊断openclaw status            # 查看状态openclaw logs              # 查看日志pmset -g                   # 查看电源设置launchctl list | grep openclaw  # 查看服务

cat > ~/openclaw-daily-check.sh << 'EOF'#!/bin/bash# OpenClaw 每日检查脚本echo "=== OpenClaw 每日检查 - $(date) ==="# 1. 检查 Gateway 状态echo -n "Gateway 状态: "if openclaw gateway status >/dev/null 2>&1; then    echo "✅ 运行中"else    echo "❌ 未运行"    openclaw gateway startfi# 2. 检查磁盘空间echo -n "磁盘空间: "df -h ~/.openclaw | tail -1 | awk '{print "已使用: " $3 " / " $2}'# 3. 检查日志大小echo -n "日志大小: "du -sh ~/.openclaw/logs 2>/dev/null | awk '{print $1}'# 4. 检查错误日志ERROR_COUNT=$(grep -i error ~/.openclaw/logs/*.log 2>/dev/null | wc -l)echo -n "错误数量: $ERROR_COUNT"if [ $ERROR_COUNT -gt 10 ]; then    echo " (⚠️ 较多)"else    echo " (✅ 正常)"fi# 5. 检查 launchd 服务echo -n "服务状态: "if launchctl list | grep -q openclaw; then    echo "✅ 已注册"else    echo "❌ 未注册"fi# 6. 检查内存使用echo -n "内存使用: "top -l 1 | grep PhysMem | awk '{print $2 " / " $8}'echo "=== 检查完成 ==="EOFchmod +x ~/openclaw-daily-check.sh

# 编辑 crontabcrontab -e# 添加定时任务（每天早上 9 点检查）0 9 * * * /Users/pmyx/openclaw-daily-check.sh >> /Users/pmyx/openclaw-daily.log 2>&1