OpenClaw 超全屌米级保姆级教程：Mac 一次装好，Telegram/WhatsApp 直接开用 📦 准备工作 系统要求 · macOS 12 (Monterey) 或更高版本 · 至少 10GB 可用磁盘空间 · 稳定的网络连接 需要下载的软件 1. Homebrew（包管理器） 2. Docker Desktop for Mac 3. Git 4. Telegram/WhatsApp（桌面版或网页版） 🚀 第一步：安装 Homebrew 打开 终端（应用程序 > 实用工具 > 终端），粘贴以下命令： ```bash /bin/bash -c "$(curl -fsSL https://t.co/dIAb8WBEjZ)" ``` 安装完成后，运行： ```bash brew update brew doctor ``` 🐳 第二步：安装 Docker Desktop 1. 访问 Docker 官网 2. 下载 Apple Silicon 或 Intel 版本（根据你的 Mac 芯片选择） 3. 双击下载的 .dmg 文件，将 Docker 图标拖到 Applications 文件夹 4. 首次打开时，系统可能会提示需要权限，请按指引操作 5. 登录 Docker 账号（如果没有，免费注册一个） 验证安装（在终端中）： ```bash docker --version docker run hello-world ``` 📥 第三步：安装和配置 OpenClaw 克隆 OpenClaw 仓库 ```bash cd ~/Desktop git clone https://t.co/6tthz2NCx1 cd openclaw ``` 修改配置文件 找到 config.example.yaml 文件，复制一份： ```bash cp config.example.yaml config.yaml ``` 用文本编辑器打开 config.yaml，修改以下关键配置： ```yaml # Telegram 配置 telegram: enabled: true api_id: "你的API_ID" # 从 https://t.co/ALdc9FbSRl 获取 api_hash: "你的API_HASH" phone_number: "+8612345678900" # WhatsApp 配置 whatsapp: enabled: true session_path: "./whatsapp_session" ``` 获取 Telegram API 凭证 1. 访问 https://t.co/ALdc9FbSRl 2. 用你的手机号登录 3. 创建新应用，获得 api_id 和 api_hash 4. 将这些信息填入 config.yaml 🛠 第四步：使用 Docker 启动 OpenClaw 构建 Docker 镜像 ```bash docker build -t openclaw . ``` 运行容器 ```bash docker run -d \ --name openclaw \ -v $(pwd)/config.yaml:/app/config.yaml \ -v $(pwd)/data:/app/data \ -p 8080:8080 \ openclaw ``` 查看运行状态 ```bash docker ps docker logs openclaw -f ``` 🔑 第五步：首次登录验证 Telegram 登录 1. 查看日志获取验证码： ```bash docker logs openclaw | grep "code" ``` 1. 如果需输入验证码： ```bash docker exec -it openclaw python3 # 在Python交互环境中输入： from src.telegram_client import client client.send_code_request("你的手机号") # 输入收到的验证码 ``` WhatsApp 登录 1. 首次运行会自动生成二维码 2. 查看二维码： ```bash docker logs openclaw | grep -A5 "QR" ``` 1. 用手机 WhatsApp 扫描二维码登录 📱 第六步：连接 Telegram/WhatsApp 方法一：通过 API 使用 OpenClaw 默认在 http://localhost:8080 提供 API 接口 发送消息示例（在终端中）： ```bash # 发送 Telegram 消息 curl -X POST http://localhost:8080/telegram/send \ -H "Content-Type: application/json" \ -d '{"chat_id": "用户名或ID", "message": "Hello from OpenClaw!"}' # 发送 WhatsApp 消息 curl -X POST http://localhost:8080/whatsapp/send \ -H "Content-Type: application/json" \ -d '{"phone": "+1234567890", "message": "Hello!"}' ``` 方法二：使用 Web UI 1. 打开浏览器访问 http://localhost:8080/web 2. 使用图形界面发送消息、管理联系人 🔄 第七步：设置为开机自启 创建启动脚本 start_openclaw.sh： ```bash #!/bin/bash cd ~/Desktop/openclaw docker start openclaw || docker run -d \ --name openclaw \ -v $(pwd)/config.yaml:/app/config.yaml \ -v $(pwd)/data:/app/data \ -p 8080:8080 \ openclaw ``` 赋予执行权限： ```bash chmod +x ~/Desktop/openclaw/start_openclaw.sh ``` 添加到开机启动： 1. 打开 系统设置 > 通用 > 登录项 2. 点击 + 添加 start_openclaw.sh 3. 勾选隐藏选项（后台运行） 🐛 常见问题解决 1. Docker 启动失败 ```bash # 重启 Docker 服务 osascript -e 'quit app "Docker"' open -a Docker # 重置 Docker docker system prune -a ``` 2. 端口被占用 ```bash # 查看占用端口的进程 lsof -i :8080 # 修改 OpenClaw 端口 # 在 config.yaml 中修改： # web: # port: 8081 ``` 3. 登录验证问题 ```bash # 删除会话文件重新登录 rm -rf ./data/sessions/* # 重新构建并运行 docker stop openclaw && docker rm openclaw docker build -t openclaw . # 重新运行容器 ``` 4. WhatsApp 二维码不显示 ```bash # 确保已安装二维码显示依赖 docker exec openclaw pip install qrcode[pil] # 或者通过API获取二维码 curl http://localhost:8080/whatsapp/qr ```