一个脚本搞定一切,5 分钟让你的 AI 助手上线。
- 不怕崩溃 — AI 的"大脑"和"手脚"(浏览器)分开运行。浏览器炸了?重启一下就行,AI 照常工作,互不影响。
- 登录态永不丢失 — 你登录过的微信、推特等网站,哪怕把 AI 完全删了重装,登录状态还在。再也不用反复扫码。
- 装之前先检查 — 安装前会自动帮你测试 API Key 能不能用。不会出现装了半天,最后发现密钥写错了的尴尬。
- 省资源 — 不用浏览器功能?那就不启动浏览器容器,电脑少吃一大块内存。
- 10+ AI 模型随便选 — Claude、GPT、DeepSeek、Kimi、通义千问……你有哪家的 Key 就用哪家,还能从 API 直接拉取模型列表。
- 一键升级 / 修复 / 卸载 — 不用手动折腾命令,脚本帮你搞定升级、环境修复、干净卸载。
- 微信直接对话 AI — 扫码绑定微信后,给微信发消息就是在跟 AI 聊天,还能收发图片和文件。
- AI 不会"发疯" — 遇到验证码、滑块这种搞不定的东西,AI 会主动停下来告诉你,而不是在后台疯狂重试烧你的钱。
- 简易版 / 满血版自由选 — 不想装 Docker?选简易版,本地直接跑。想要最稳的隔离环境?选满血版,Docker 全自动。
openclaw-oneclick/
├── setup.sh # 主交互式安装向导 (v2.0)
├── upgrade.sh # 一键升级脚本(版本感知)
├── repair.sh # 一键修复 / 诊断 / 日志导出
├── uninstall.sh # 一键卸载脚本(标准/彻底)
├── factory-reset.sh # 一键洗脑 — 出厂重置脚本
├── CHANNELS_SOP.md # 🤖 通讯频道机器人配置指南
├── .env.example # 环境变量模板
├── docker-compose.yml # 核心容器编排(大脑主容器)
├── docker-compose.browser.yml # 浏览器 Sidecar 编排(按需加载)
├── .gitignore # 防止 .env 数据泄露
└── templates/ #
├── SOUL.md # 被 setup.sh 动态加工的系统提示词底座
├── AGENTS.md # 控制工作流模式
└── MEMORY.md # 长期记忆
# 1. 克隆项目
git clone https://github.com/Lvmonz/openclaw-oneclick.git
cd openclaw-oneclick
# 2. 运行交互式安装向导(会先让你选择简易版/满血版)
chmod +x setup.sh upgrade.sh repair.sh
./setup.sh💡 安装向导第一步会让你选择版本:⚡ 简易版 (无 Docker,本地环境) 或 🚀 满血版 (Docker 容器化)。 💡 已有配置时再次运行会默认上次版本,可直接修改参数。
宿主机 Docker Compose 网络 (172.x.x.x)
───────── ──────────
.env (API Keys) ──生成──> openclaw-core (大脑主容器)
│ ├── 独立挂载: openclaw-data (存放工作区与技能)
│
└── CHROME_CDP_URL=ws://openclaw-browser:9222
│ (仅启用浏览器时)
▼
openclaw-browser (动作肢体容器, alpine-chrome)
├── 暴露 9222 供宿主机直接查验 debug
└── 独立挂载: browser_profile (持久化保留 Twitter 等网站 Cookies)
- 安全网络隔离:外部环境只暴露出给宿主机用的端口,容器相互之间通过纯内网的 WebSocket
.9222通信。 - 动态 SOUL 赋予:安装脚本会根据你的选择,动态把当前 Sidecar 架构的使用说明写入 AI 的
SOUL.md大脑皮层,AI 天生就知道如何运用 Playwright 连上它。 - 按需编排:不启用浏览器时只运行
docker-compose.yml,启用浏览器时自动合并docker-compose.browser.yml。
因为容器做了完善的数据挂载,不需要重装即可快速切换 Agent 的大脑:
场景一:只想换模型(API 供应商或 URL 没变)
比如你一开始选了深势 (DeepSeek),想从 deepseek-chat 换成 deepseek-reasoner,直接用内部命令行秒切:
# 修改格式:供应商前缀/模型名,例如 deepseek/deepseek-reasoner
docker exec openclaw-main openclaw config set agents.defaults.model "deepseek/deepseek-reasoner"
# 让新模型热加载生效
docker exec openclaw-main openclaw gateway restart场景二:想换一个全新的 API 供应商 / 修改本地 API URL(推荐重跑向导)
如果你想从 OpenAI 换到 Custom 代理,或者换个 API Key,最稳妥的方式是重新执行 ./setup.sh(不带 --clean 参数):
- 它会重新询问你的 API URL、Key 和模型名,并写死到大模型配置里。
- 因为没有加
--clean,它只会平滑刷新[1/7]的配置文件,绝对不会丢失你的微信登录态或浏览器配置库。 - 注:如果你手滑按了
Ctrl+Z,新版脚本内置了安全自毁机制,会自动强制清理底层进程防止环境死锁。
# 启动(不带浏览器)
docker compose up -d
# 启动(带浏览器 Sidecar)
docker compose -f docker-compose.yml -f docker-compose.browser.yml up -d
# 停止
docker compose down
# 查看核心日志
docker logs openclaw-main --tail 100 -f# 独立脚本(推荐)
bash upgrade.sh
# 或在安装向导确认页选择 "5" 一键升级
./setup.sh升级会自动根据安装模式(lite/full)拉取最新镜像或 npm 包,保留所有数据和配置。
# 独立脚本
bash repair.sh
# 或在安装向导确认页选择 "6" 一键修复
./setup.sh修复工具会自动检测:文件完整性、Docker/Node 环境、容器健康、端口冲突、数据卷状态、磁盘空间等,并尝试自动修复。支持导出诊断日志(macOS 支持文件选择器)。
安装向导支持同时选择多个通讯频道:
| 频道 | 安装方式 | 需要配置 |
|---|---|---|
| 📱 微信 | openclaw-weixin-cli |
扫码授权 |
| 🔷 钉钉 | openclaw channels add |
企业应用 App ID/Secret |
| 内置频道 | Bot Token (@BotFather) | |
| 🔵 飞书 | @openclaw/feishu 插件 |
企业应用 App ID/Secret |
openclaw channels add |
Bot 应用凭证 | |
| 🔧 自定义 | Webhook 配置 | URL + Token + 消息格式 |
# 独立脚本
bash uninstall.sh
# 或在安装向导确认页选择 "8" 一键卸载
./setup.sh| 卸载方式 | 容器 | 镜像 | 数据卷 | Skills | .env | 日志 | 缓存 |
|---|---|---|---|---|---|---|---|
| 🧹 标准卸载 | ✅ 删 | 保留 | 保留 | ✅ 保留 | ✅ 保留 | 保留 | 保留 |
| 💣 彻底卸载 | ✅ 删 | ✅ 删 | ✅ 删 | ❌ 删 | ❌ 删 | ❌ 删 | ❌ 删 |
当 AI 出现幻觉、串记忆、行为异常,或者你调整了 SOUL.md / SKILL.md 后想让 AI 以全新状态重新开始时,使用出厂重置脚本:
# 普通重置:清空对话记忆、日志、LLM 缓存,保留浏览器登录态
bash factory-reset.sh
# 硬重置:额外清除浏览器 Cookie(需重新扫码登录各网站)
bash factory-reset.sh --hard| 项目 | 普通重置 | 硬重置 (--hard) |
|---|---|---|
| 对话历史 | ✅ 清空 | ✅ 清空 |
| Agent 记忆 | ✅ 清空 | ✅ 清空 |
| LLM prompt cache | ✅ 清空 | ✅ 清空 |
| 日志 | ✅ 清空 | ✅ 清空 |
| 已安装的 Skills | ✅ 保留 | ✅ 保留 |
| 配置文件 (SOUL/IDENTITY/USER.md) | ✅ 保留 | ✅ 保留 |
| 微信账号绑定 | ✅ 保留 | ✅ 保留 |
| 浏览器 Cookie 与登录态 | ✅ 保留 | ❌ 清空 |
💡 推荐:日常调试用普通重置即可,无需每次都重新扫码。只有在浏览器状态异常(如网站检测到自动化、Cookie 过期)时再用
--hard。
cd ~/openclaw-oneclick
docker compose down -v # -v 意味着销毁包括登录态在内的一切卷数据
cd ~ && rm -rf ~/openclaw-oneclickQ: 报错 403 Author anthropic is banned 怎么办?
A: 这通常是因为 openclaw.json 中 API Key 的挂载方式不对。正确的配置应该使用 models.providers 显式配置,而非 env 层注入。解决方法:
- 删除容器和数据:
docker compose down -v - 重新运行:
./setup.sh --clean - 如果仍然出现,进入容器检查配置:
docker exec openclaw-main cat /home/node/.openclaw/openclaw.json,确认 API Key 在models.providers下而非env下。
Q: 我发现 AI 用了一段时间浏览器后经常崩溃 (Connection Closed) 怎么办?
A: 现代网页长时运行容易泄露。解决方式极简:docker restart openclaw-browser,重启仅需 1 秒,并且因为 browser_profile 挂载了的缘故,任何登录态都不会丢失。
Q: 为什么 AI 不用内置的 browser 工具了?
A: 之前用内置 browser 会把几十上百 MB 的 Chromium 强行塞进 openclaw-core,容易互相影响并导致内存无法回收。新架构用 python playwright.chromium.connect_over_cdp("ws://openclaw-browser:9222"),性能直接翻飞。
Q: 安装时提示 API Key 验证失败? A: 安装向导会在拉取镜像前预检 API 连通性。如果提示失败:
- 检查 API Key 是否正确复制(包括前缀
sk-or-、sk-ant-等) - 检查网络是否可以访问对应的 API 地址
- 确认账户余额是否充足(OpenRouter 需要先充值)
Q: 不启用浏览器功能会有什么影响?
A: AI 仍然可以通过 fetch/curl 获取网页文本内容(无 JS 渲染),但无法进行需要 JavaScript 的操作(如登录网页、操作 SPA 应用)。你可以之后随时重新运行 ./setup.sh 启用。
MIT