OpenClaw环境搭建

A_miahao

303人浏览 · 2026-08-04 17:06:01

A_miahao · 2026-08-04 17:06:01 发布

2.1 前置硬件 & 系统要求

系统推荐优先级

macOS（强烈推荐）完整支持日历、备忘录、截图、iCloud 同步；硬件最低 M 系列 / Intel i5，内存≥8GB（推荐 16GB），硬盘空闲 10GB 以上；系统版本 macOS 12 Monterey 及以上，最优 14/15 版本。
Windows 原生 Power 部署功能受限，官方推荐 WSL2 Ubuntu 完整环境；硬件 2 核 CPU、4GB 内存起步。
Linux（Ubuntu/Debian）开发者首选，自定义配置自由度最高。

国内配套 IM 推荐

Mac 本地用户：飞书（API 完善、富文本、文件消息全兼容）海外用户：Telegram（Bot 生态最完善）

两大部署路线

本地部署（Mac 首选）优势：零服务器费用、本地无网络延迟、解锁全部系统集成功能
云端部署（无 Mac / 需要 24 小时在线）优势：电脑关机也能运行，手机随时通过 QQ / 企微访问，月费 20 元起

2.2 Mac 本地部署（官方最优方案）

前置依赖

Node.js 22.0.0+（安装脚本自动部署，无需手动下载）；Homebrew 可选，用于补充系统工具。

完整分步安装

唤起终端：Command + 空格打开聚焦搜索，输入 Terminal 回车启动
一键安装脚本（复制到终端执行）

curl -fsSL https://openclaw.ai/install.sh | bash

脚本自动检测系统、安装 Node、下载程序、配置环境变量，耗时 2~5 分钟。 3. 验证安装是否成功

openclaw --version

输出版本号2026.2.9代表安装完成。 4. 初始化配置向导

openclaw onboard

向导完整配置流程： ① 风险提示：选择 Yes 确认知晓权限风险 ② 启动模式：QuickStart 快速配置（新手推荐） ③ 选择大模型厂商：国内优先 Moonshot (Kimi)、DeepSeek、智谱 GLM ④ 粘贴对应平台的 API Key 密钥 ⑤ 选择需要接入的聊天软件（飞书 / 企微 / QQ，可先 Skip 跳过） ⑥ Gateway 端口：默认 18789 无需修改 ⑦ 空格键勾选需要预装的基础技能（文件、日历、搜索等） ⑧ 第三方地图 API：无需求直接 No 跳过 ⑨ 启用三个核心钩子：boot-md、command-logger、session-memory ⑩ 配置完成自动启动 Gateway，本地 Web 控制台地址：http://127.0.0.1:18789/ 5. 日常启停命令

# 启动网关服务
openclaw gateway start
# 设置开机自启
openclaw gateway enable
# 停止网关
openclaw gateway stop
# 打开网页控制台
openclaw dashboard
# 查看渠道连接状态
openclaw channels status

接入飞书 Bot 流程

参考第 9 章多平台集成完整教程，配置 AppID、AppSecret 后，即可在飞书内直接对话、发送文件给本地 OpenClaw。

Mac 部署常见问题

Q1：安装提示权限不足解决：在脚本前增加 sudo 提升权限

curl -fsSL https://openclaw.ai/install.sh | sudo bash

Q2：如何更新版本

openclaw update

Q3：彻底卸载

openclaw uninstall

2.3 Windows 本地部署

两种部署方式：WSL2 Ubuntu（官方推荐，功能完整）、原生 PowerShell（功能残缺）

方式一：WSL2 Ubuntu 部署（首选）

管理员身份打开 PowerShell，执行开启虚拟机功能

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /noresta
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2

执行完成后重启电脑。 2. 微软商店安装 Ubuntu 22.04/24.04 LTS，启动设置用户名密码。 3. Ubuntu 内更新系统依赖

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential

安装 Node.js 22.x

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v # 校验版本≥22

一键安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

校验安装

openclaw --version
openclaw status

Windows 端口转发配置 WSL 内网关端口 18789，创建批处理文件start-openclaw.bat一键启动访问：

@echo off
echo Starting OpenClaw Gateway in WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

方式二：原生 PowerShell 部署（不推荐）

官网下载 Node.js 22.x LTS 安装包，勾选自动工具安装
管理员身份打开 PowerShell，全局安装

npm install -g openclaw@latest
# 国内汉化版
npm install -g @qingchencloud/openclaw-zh@latest

权限报错修复

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
npm config set prefix "C:\npm"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User")

启动配置向导

openclaw onboard --install-daemon

Windows 常用管理命令

# 查看版本、系统状态
openclaw --version
openclaw health
# 配置增删改
openclaw configure
openclaw config set 键 值
# 更新/诊断
openclaw update
openclaw doctor

2.4 Linux 本地部署（Ubuntu/Debian）

安装 Node.js 22

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version

一键安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

校验 + 初始化

openclaw --version
openclaw onboard

2.5 云端一键部署（无电脑 24 小时在线方案）

支持服务商：腾讯云轻量、火山引擎、百度智能云、阿里云

腾讯云 Lighthouse 部署（推荐，20 元 / 月，20M 带宽）

访问活动页面选购实例：https://cloud.tencent.com/act/pro/lighthouse-molt 配置：2 核 2G、20M 带宽，地域可选硅谷（海外模型稳定），月付 20 元，年付 99 元。
完成实名认证，购买后在站内信获取服务器公网 IP、账号密码。
SSH 工具 / F 网页终端连接服务器，执行openclaw --version校验预装完成。
模型配置：进入应用管理，选择 Kimi/DeepSeek，粘贴 API Key 保存。
访问 Web 控制台：http://服务器IP:18789/?token=后台令牌

火山引擎方案（9.9 元 / 月，5M 带宽，飞书用户首选）

活动链接：https://www.volcengine.com/activity/clawdb 带宽较低，适合仅飞书渠道使用，部署流程同腾讯云。

百度智能云特惠（首月 0.01 元试用）

活动页面：https://cloud.baidu.com/product/BCC/moltbot.html 限制仅首月低价，需实名，内置千帆大模型一键配置。

云端通用优缺点

优势：电脑关机不中断、手机随时通过 IM 访问、一键部署无需配环境劣势：每月固定服务器开销，无法访问本地电脑文件，仅能操作云端磁盘

2.6 国内一键汉化安装脚本

国内镜像加速脚本，下载速度更快，默认国产模型： macOS/Linux：

curl -fsL https://clawd.org.cn/install.sh | bash

iwr -useb https://clawd.org.cn/install.ps1 | iex

2.7 Docker 容器部署（隔离环境）

前置：本地安装 Docker Desktop

一键脚本部署

curl -fsSL https://clawd.org.cn/install.sh | bash

手动 docker-compose 部署

mkdir -p ~/openclaw-docker && cd ~/openclaw-docker

新建.env 环境变量文件

OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest
OPENCLAW_CONFIG_DIR=./data/.openclaw
OPENCLAW_WORKSPACE_DIR=./data/clawd
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_GATEWAY_TOKEN=自定义安全密钥

docker-compose.yml 配置文件（省略完整代码，文档内附完整模板）
启动服务

docker compose pull
docker compose up -d openclaw-cn-gateway
# 初始化配置
docker compose run --rm openclaw-cn-cli onboard

Docker 常用运维命令

# 查看日志
docker compose logs -f openclaw-cn-gateway
# 重启/更新
docker compose restart
docker compose pull && docker compose up -d
# 备份数据
tar -czf openclaw-backup.tar.gz ./data

2.8 Cloudflare Workers 进阶无服务器部署

适合有 CF 账号、需要全球加速的技术用户，5 美元 / 月起步，Serverless 无需维护服务器，步骤复杂，适合进阶开发者，文档内配套后台界面截图：

2.9 API 模型配置指南

OpenClaw 无内置大模型，必须自行配置对应服务商 API Key 才能使用。

两大配置模式

向导配置（新手推荐，openclaw onboard）
手动编辑~/.openclaw/openclaw.json（进阶）

主流国产模型配置教程

1. Kimi（Moonshot，超长 200 万字上下文）

官网：https://platform.moonshot.cn/
注册账号、购买套餐，控制台新建 API Key，复制保存（仅显示一次）
配置向导选择 Moonshot AI，粘贴密钥即可使用

2. DeepSeek（性价比之王，推理 / 代码极强）

平台地址：https://platform.deepseek.com/
账户充值（最低 10 元），进入 API keys 创建密钥
向导选择 DeepSeek 完成绑定

自定义 API 配置示例（json 片段）

json

"models": {
  "mode": "merge",
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com",
      "apiKey": "sk-你的密钥",
      "auth": "api-key",
      "api": "openai-chat"
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "deepseek/deepseek-chat"}
    }
  }
}