vault backup: 2026-02-13 20:28:50

07-Other/AI/AI Agent/OpenClaw.md

@@ -8,5 +8,113 @@
 	- 【别当冤大头！1分钟白嫖GLM官方大模型！】 https://www.bilibili.com/video/BV1t2c5z3E8Y/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
 
 
-# docker 部署
+# Docker 部署
 https://docs.openclaw.ai/install/docker
+
+# OpenClaw
+```c++
+docker pull alpine/openclaw:main
+
+```
+
+1. git clone https://github.com/openclaw/openclaw.git
+2. cd openclaw
+3. 核心步骤：构建并启动 Docker 镜像（约 5–30 分钟）
+	1. （可选）加速：使用预构建镜像。如果不想本地构建（build 过程可能下载依赖较慢），设置环境变量跳过：`bash export OPENCLAW_IMAGE=alpine/openclaw   # 或官方其他镜像（视最新可用）`
+
+## 克隆 OpenClaw 仓库
+bash 运行
+```
+git clone https://github.com/openclaw/openclaw.git
+cd openclaw
+```
+
+github还需要添加一下代理。
+curl也需要使用代理：
+
+curl --socks5 192.168.50.100:20172 https://github.com/
+
+export http_proxy http://192.168.50.100:20171
+export https_proxy http://192.168.50.100:20171
+
+export https_proxy="http://192.168.50.100:20171"
+export http_proxy="http://192.168.50.100:20171"
+
+取消代理
+unset http_proxy https_proxy
+
+## 核心步骤：构建并启动 Docker 镜像（约 5–30 分钟）
+### （可选）加速：使用预构建镜像
+如果不想本地构建（build 过程可能下载依赖较慢），设置环境变量跳过：
+bash运行
+```
+export OPENCLAW_IMAGE=alpine/openclaw   # 或官方其他镜像（视最新可用）
+```
+
+### 运行官方 setup 脚本
+bash运行
+```
+./docker-setup.sh   # 明确用新 bash 执行
+```
+脚本会完成以下操作：
+- 拉取 / 构建镜像（openclaw:local）
+- 创建～/.openclaw（配置）和～/openclaw/workspace（沙箱目录）
+- 启动 docker-compose 服务
+
+构建过程会输出进度，如果卡在 100%，耐心等或检查网络 / 代理。
+
+## 常见坑点处理
+1. 报 `declare -A: invalid option` → 确认用 bash 5.x 执行（上文已解决）
+2. 报 `Cannot connect to the Docker daemon` → 启动 Docker Desktop，或执行 `docker context use desktop-linux`
+3. 权限问题 → 执行 `sudo chown -R $USER ~/.openclaw ~/openclaw/workspace`
+
+## 配置与首次使用（Onboarding）
+### 启动 onboarding wizard
+bash运行
+```
+docker compose run --rm openclaw-cli wizard
+```
+1. 选择 QuickStart（推荐，新手友好，后续可手动调整）
+2. 阅读安全警告 → 输入 Yes 继续
+3. 输入模型 API Key（推荐 Groq、Claude、OpenAI 等）
+4. 配置通道（Telegram/Discord 推荐先用一个）
+5. 生成 pairing code → 在对应平台发给 bot 配对
+
+### 批准配对（以 Discord 为例）
+bash运行
+```
+docker compose run --rm openclaw-cli pairing approve discord <你的配对码>
+```
+
+### 验证
+bash运行
+```
+docker compose run --rm openclaw-cli devices list
+```
+
+## 测试
+1. 在 Discord/Telegram 发消息给 bot（如 “你好”）
+2. 查看日志确认：
+
+bash运行
+```
+docker compose logs -f
+```
+
+## 日常管理命令
+- 启动 / 重启：`docker compose up -d` / `docker compose restart`
+- 停止：`docker compose down`
+- 查看状态：`docker compose ps`
+- 打开 Web Dashboard：`docker compose run --rm openclaw-cli dashboard`（通常 [localhost:18789](https://localhost:18789)）
+- 安全审计：`docker compose exec openclaw-gateway openclaw security audit --deep`
+
+## 安全提醒
+1. Docker 提供隔离，但仍需谨慎开启工具（如文件读写、shell 执行）。
+2. 不要把高危权限给 bot，启用 allowlist、mention gating。
+3. 定期运行 `openclaw security audit --fix`。
+4. API Key 等敏感信息存储在～/.openclaw/，备份好。
+
+## 总结
+在 macOS 上通过 Docker 安装 OpenClaw 非常可靠，整体流程为：
+**准备（Homebrew + bash 升级 + Docker）→ 克隆仓库 → bash ./docker-setup.sh → wizard 配置 → pairing 批准 → 测试聊天**
+整个过程 30–60 分钟就能跑起本地个人 AI 助手，强烈推荐 Docker 方式，避免直接污染系统。