给 OpenClaw 龙虾搭了一间像素办公室：一眼看懂 Agent 在忙什么

# macOS 部署
OpenClaw 完整指南
OpenClaw 是一款开源 AI
Agent 框架，能够在本地 Mac 设备上实现智能化任务处理。下面将详细介绍从环境准备到完整部署的全流程。 一、环境准备与依赖安装 1. 系统要求与工具安装 在开始部署前，需要确保 Mac 设备满足以下基础环境要求： | 组件 | 版本要求 | 安装方法 | |——|———-|———-| | Docker | 最新稳定版 | 官方 Docker Desktop for Mac | | Git | 2.x 及以上 | `brew install git` | | Node.js | 18.x 及以上 | `brew install node` | 具体安装步骤： “`bash # 安装 Homebrew（如未安装） /bin/bash -c “$(curl -fsSL https
://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)” # 安装 Git brew install git # 安装 Node.js brew install node # 安装 Docker Desktop # 从官网下载：https
://www.docker.com/products/docker-desktop/ “` 确保 Docker 服务正常运行： “`bash docker –version docker-compose –version “` 2. 项目获取与目录准备 “`bash # 克隆
OpenClaw 项目 git clone https
://github.com/open-claw/
openclaw.git cd
openclaw # 创建必要的配置目录 mkdir -p config logs data “` 二、核心服务部署配置 1. Docker 容器化部署
OpenClaw 采用 Docker 容器化部署，提供隔离的运行环境。以下是核心服务的 docker-compose 配置： “`yaml # docker-compose.yml version
: ‘3.8’ services
:
openclaw-core
: image
:
openclaw/core
:latest container_name
:
openclaw-core restart
: unless-stopped ports
: – “3000
:3000″ volumes
: – ./config
:/app/config – ./logs
:/app/logs environment
: – NODE_ENV=production – MODEL_PROVIDER=minimax networks
: –
openclaw-network gateway
: image
:
openclaw/gateway
:latest container_name
:
openclaw-gateway restartopenclaw 龙虾
: unless-stopped ports
: – “8080
:8080″ depends_on
: –
openclaw-core networks
: –
openclaw-network networks
:
openclaw-network
: driver
: bridge “` 启动服务： “`bash docker-compose up -d “` 2. 大模型配置
OpenClaw 支持多种大模型，推荐使用 MiniMax 等国产大模型： “`bash # 配置环境变量 echo “MODEL_API_KEY=your_minimax_api_key” >> .env echo “MODEL_BASE_URL=https
://api.minimax.chat” >> .env echo “GATEWAY_TOKEN=your_gateway_token” >> .env “` 模型配置对比： | 模型类型 | 接入方式 | 适用场景 | 配置复杂度 | |———-|———-|———-|————| | MiniMax | OpenAI API 兼容 | 通用对话、代码生成 | 简单 | | DeepSeek | OpenAI API 兼容 | 数学推理、逻辑分析 | 简单 | | 通义千问 | 定制接口 | 中文理解、创意写作 | 中等 | 三、飞书机器人集成配置 1. 飞书应用创建 在飞书开发者后台创建企业自建应用： 1. 访问 [飞书开放平台](https
://open.feishu.cn/) 2. 创建新应用，获取 `App ID` 和 `App Secret` 3. 配置权限：`im
:message`、`contact
:user.id
:readonly` 等 2. 事件订阅配置 “`yaml # feishu-config.yaml app_id
: “cli_xxxxxx” app_secret
: “xxxxxx” encrypt_key
: “” verification_token
: “xxxxxx” event_subscription
: – im.message.receive_v1 – im.message.message_read_v1 permissions
: im
:message
: – receive – send “` 3. 长连接回调设置 配置飞书事件回调地址： “` https
://your-domain.com/feishu/events “` 本地开发可使用 ngrok 进行测试： “`bash ngrok http 3000 “` 四、安全加固与网络隔离 1. Docker 安全配置 为增强安全性，建议采用沙箱模式运行： “`yaml services
:
openclaw-core
: # … 其他配置 security_opt
: – no-new-privileges
:true cap_drop
: – ALL read_only
: true networks
:
openclaw-network
: aliases
: –
openclaw-core “` 2. 网络隔离方案 通过路由器 Guest WiFi 实现硬件级网络隔离： “`bash # 配置 Tailscale 加密隧道 sudo tailscale up –advertise-routes=192.168.1.0/24 # 防火墙规则设置 sudo pfctl -f /etc/pf.conf “` 3. 权限管控 “`bash # 创建专用用户 sudo dscl . -create /Users/
openclaw sudo dscl . -create /Users/
openclaw UserShell /bin/bash # 配置 sudo 权限 echo ”
openclaw ALL=(ALL) NOPASSWD
: /usr/local/bin/docker” >> /etc/sudoers.d/
openclaw “` 五、无显示器部署方案 对于 Mac mini 等无显示器设备，可采用以下远程管理方案： 1. SSH 密钥认证 “`bash # 生成 SSH 密钥 ssh-keygen -t ed25519 -f ~/.ssh/
openclaw_mac # 配置 SSH 免密登录 ssh-copy-id -i ~/.ssh/
openclaw_mac.pub user@mac-mini-ip “` 2. 远程桌面配置 启用 VNC 远程访问： “`bash # 启用屏幕共享 sudo systemsetup -setremotelogin on sudo /System/Library/CoreServices/RemoteManagement/ARD
Agent.app/Contents/Resources/kickstart -activate -configure -access -on -restart –
agent -privs -all “` 3. 服务监控脚本 “`bash #!/bin/bash # monitor_
openclaw.sh while true; do if ! docker ps | grep -q ”
openclaw-core”; then echo “$(date)
:
OpenClaw service down, restarting…” >> /var/log/
openclaw_monitor.log cd /path/to/
openclaw && docker-compose up -d fi sleep 60 done “` 六、故障排查与维护 常见问题解决： | 问题现象 | 可能原因 | 解决方案 | |———-|———-|———-| | 容器启动失败 | 端口占用 | 修改 docker-compose.yml 端口映射 | | 模型调用超时 | API 密钥错误 | 检查 .env 文件配置 | | 飞书消息无响应 | 事件订阅未配置 | 验证飞书后台回调地址 | | 内存占用过高 | 模型加载过多 | 调整 Docker 内存限制 | 日志查看方法： “`bash # 查看核心服务日志 docker logs
openclaw-core -f # 查看网关日志 docker logs
openclaw-gateway -f # 查看系统资源 docker stats
openclaw-core
openclaw-gateway “` 七、高级功能扩展 1. 多模型支持 通过修改配置支持多个大模型： “`yaml model_providers
: minimax
: api_key
: ${MINIMAX_API_KEY} base_url
: “https
://api.minimax.chat” deepseek
: api_key
: ${DEEPSEEK_API_KEY} base_url
: “https
://api.deepseek.com” “` 2. 自定义技能开发 “`javascript // skills/custom-skill.js module.exports = { name
: “weather”, description
: “获取天气信息”, execute
: async (params) => { // 实现自定义逻辑 return await fetchWeatherData(params.city); } }; “` 通过以上完整部署流程，可以在 Mac 设备上成功运行
OpenClaw，实现本地化 AI 任务处理能力，并与飞书等协作平台无缝集成。整个方案强调本地执行、安全隔离和易维护性，适合个人开发者和小团队使用 [ref_1][ref_2][ref_3][ref_4][ref_5][ref_6]。