提供OpenClaw部署的详细教程

下面给你一份完整、可直接照着做的 OpenClaw（小龙虾AI）部署教程，覆盖：Windows / macOS / Linux 本地部署、Docker 私有化部署、模型配置、面板访问、常见问题。
一、环境要求

• 系统：Windows 10+/macOS 12+/Linux（Ubuntu 20.04+ 推荐）

• Node.js：v22.14+ 或 v24（官方推荐）

• 内存：≥4GB（本地模型建议 8GB+）

• 网络：能访问模型 API（OpenAI / 月之暗面 / 通义千问等）
二、本地部署（一键脚本，推荐新手）

1）macOS / Linux（终端）
curl -fsSL https://openclaw.ai/install.sh | bash
• 自动安装 Node.js、OpenClaw 核心、依赖

• 安装完成后自动加入环境变量，可直接用 openclaw 命令

2）Windows（PowerShell 管理员）

以管理员身份打开 PowerShell，执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
• 全程自动，无需手动装 Node.js

三、初始化配置（核心步骤）

安装完成后执行引导配置：
openclaw onboard –install-daemon
按向导依次配置：

1. Onboarding 模式 → 选 QuickStart（推荐）

2. 网关模式 → local（本地）

3. AI 模型选择（关键）

◦ 国内推荐：Moonshot（Kimi）/ 通义千问 / 百川

◦ 国外：OpenAI / Anthropic

◦ 示例（Kimi）：

◦ 接入点：https://api.moonshot.cn/v1

◦ API Key：从 Kimi 控制台获取

◦ 模型：moonshot-v1-8k

4. 聊天渠道（可跳过，后续再加）

◦ Telegram：填 Bot Token

◦ WhatsApp：扫码绑定

◦ Discord：填 Token

5. 守护进程 → 安装（开机自启）

◦ macOS：launchd

◦ Linux：systemd

◦ Windows：服务

配置完成后，服务自动启动。
四、Docker 私有化部署（服务器推荐）

1）安装 Docker
# Ubuntu
sudo apt update
sudo apt install docker.io -y
sudo systemctl enable docker
sudo systemctl start docker
2）拉取镜像并启动
docker pull openclaw/openclaw:latest

docker run -d \
 –name openclaw \
 -p 8080:8080 \
 -p 3000:3000 \
 -v ~/.openclaw:/root/.openclaw \
 –restart=always \
 openclaw/openclaw:latest
3）进入容器配置
docker exec -it openclaw bash
openclaw onboard
后续步骤同本地部署。
五、Web 面板访问

配置完成后，启动面板：
openclaw dashboard
输出类似：
Dashboard URL: http://localhost:3000
Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
• 本地浏览器打开：http://localhost:3000

• 服务器部署：放行 3000 端口，用 http://你的IP:3000 访问

六、配置文件说明（可手动改）

主目录：~/.openclaw/

• 主配置：~/.openclaw/config.json

• 模型密钥：~/.openclaw/credentials/oauth.json

• 代理配置：~/.openclaw/agents//agent/auth-profiles.json

示例（config.json 片段）：
{
 “defaults”: {
   “model”: {
     “primary”: “moonshot/moonshot-v1-8k”
   }
 },
 “gateway”: {
   “mode”: “local”
 }
}
改完重启：openclaw restart
七、常用命令
openclaw start       # 启动服务
openclaw stop        # 停止服务
openclaw restart     # 重启
openclaw status      # 查看状态
openclaw logs        # 查看日志
openclaw configure    # 重新配置模型/渠道
八、常见问题

1. 安装失败：Node.js 版本过低

◦ 手动装 Node.js 22+：https://nodejs.org/

2. 模型调用失败：API Key 错误/网络不通

◦ 检查 Key 是否正确、接入点是否匹配国内/国际

3. 面板打不开：端口被占用

◦ 改端口：openclaw dashboard –port 3001

4. 无显示器服务器无法 OAuth 认证

◦ 先在有浏览器的机器认证，复制 oauth.json 到服务器对应目录
九、国内模型推荐（直接可用）

• Moonshot（Kimi）：https://api.moonshot.cn/v1

• 通义千问：https://dashscope.aliyuncs.com/compatible-mode/v1

• 百川：https://api.baichuan-ai.com/v1