[OpenClaw]-1-安装与初始化配置详解
引言
本文是面向全用户的 OpenClaw 保姆级安装与配置指南，一站式解决这款爆火开源 AI 智能体的落地部署难题。文中完整收录了 Windows/Mac/Linux 全系统的一键安装命令、手动部署步骤，详解了大模型对接，同时汇总了安装过程中的常见报错与排坑方案。无论你是零基础想搭建个人 AI 数字员工的普通用户，还是想要实现流程自动化的开发者，都能通过本文快速上手 OpenClaw，让 AI 真正从 “会聊天” 变成 “能做事”。
文章目录
0×1.Linux安装OpenClaw
本文以Ubuntu linux为例（其他发行版替换包管理命令即可）安装OpenClaw：
1.安装与配置openclaw：
# 官方网站（https://openclaw.ai/）如果下面的安装命令失效，请参考官方网站上的最新方法
# 脚本会自动检测系统是否安装node.js，git，curl等等这些工具，如果缺失会一并安装
987@hk987.xyz:~$ curl -fsSL https://openclaw.ai/install.sh | bash
### 初始化安装配置步骤 ###
# 立即生成并配置网关令牌？选Yes
# OpenClaw 的 Gateway Token（网关令牌） 是整个系统的核心安全凭证
# 相当于 OpenClaw 网关的 “万能钥匙”，没有这个令牌访问不了openclaw
# 默认明文保存在用户家目录.openclaw/openclaw.json文件的gateway字段中
Generate and configure a gateway token now?
│ ● Yes / ○ No
# 将openclaw工作目录权限改成700,选Yes
Tighten permissions on ~/.openclaw to 700?
│ ● Yes / ○ No
# 创建会话存储目录
# 它是 OpenClaw 默认 main 智能体的会话数据持久化目录，用于：
# -保存你和 AI 的完整对话历史（.jsonl 格式）
# -存储会话元数据、上下文状态、工具调用记录
# -重启后恢复对话、继续上下文，避免每次都从头开始
# -选 Yes（推荐）：自动创建目录，OpenClaw 才能正常保存 / 加载会话，否则无法持久化对话
# -选 No：不创建目录，会话仅在内存中，重启后所有对话历史丢失，且可能报错
Create Session store dir at ~/.openclaw/agents/main/sessions?
│ ● Yes / ○ No
# 到目前为止，单智能体目录结构
~/.openclaw/ # OpenClaw 全局状态根目录
└── agents/
└── main/ # 默认智能体（main）
└── sessions/ # ✅ 你当前确认创建的会话存储目录
├── sessions.json # 会话索引/元数据
└── *.jsonl # 每条对话的完整记录文件
# 是否安装网关服务，选Yes
# 网关服务是 OpenClaw 对接外部通讯渠道（如 WhatsApp、Telegram）的核心组件
Install gateway service now?
│ ● Yes / ○ No
#「网关服务运行时」，即网关服务依赖的编程语言执行环境，选推荐的Node即可
◆ Gateway service runtime
│ ● Node (recommended) (Required for WhatsApp + Telegram. Bun can corrupt memory on reconnect.)
# 完成之后可能默认会自动弹出web页面，因为还没有配置模型和本地运行环境等，
# 可能无法访问（ubuntu上有时候会出现无法打开网页要重启服务的情况），
# 所以接下来可以先手动配置一下
# 使用下面的命令来配置openclaw
987@hk987.xyz:~$ openclaw configure
# 网关服务在哪运行，本文选Local，即本地运行
Where will the Gateway run?
│ ● Local (this machine) (No gateway detected (ws://127.0.0.1:18789))
│ ○ Remote (info-only)
# 选项解析
● Local (this machine) (No gateway detected (ws://127.0.0.1:18789))
Local (this machine)：本地（当前这台电脑），这是默认选中的选项；
No gateway detected：系统检测到当前本机的 127.0.0.1:18789 端口（网关默认端口）上还没有运行中的网关服务；
ws://127.0.0.1:18789：网关服务的默认本地连接地址（WebSocket 协议），后续安装完成后网关会在这个地址启动。
○ Remote (info-only)
Remote (info-only)：远程（仅信息展示），
即网关服务部署在另一台服务器 / 设备上，
当前仅用于填写远程网关的连接信息（不会在本机安装 / 启动网关）
# 选择需要配置的模块，这是Openclaw的模块化配置环节
Select sections to configure
│ ● Workspace (Set workspace + sessions)
│ ○ Model
│ ○ Web tools
│ ○ Gateway
│ ○ Daemon
│ ○ Channels
│ ○ Skills
│ ○ Health check
│ ○ Continue
# 模块化配置环节，选项解析请看下面这张图
# 例如我们要配置模型，以Minimax模型为例（需要先去购买模型使用权，获得API key）
Select sections to configure
│ Model
│
◆ Model/auth provider
│ ○ OpenAI
│ ○ Anthropic
│ ○ Chutes
│ ● MiniMax (M2.5 (recommended))
│ ○ Moonshot AI (Kimi K2.5)
│ ○ Google
MiniMax auth method # 在国内可以选择CN API 如果在国外就选择Global API
│ ○ MiniMax Global — OAuth (minimax.io)
│ ○ MiniMax Global — API Key (minimax.io)
│ ○ MiniMax CN — OAuth (minimaxi.com)
│ ● MiniMax CN — API Key (minimaxi.com) (sk-api- or sk-cp- keys supported)
│ ○ Back
How do you want to provide this API key? # 明文方式储存API key
│ ● Paste API key now (Stores the key directly in OpenClaw config)
│ ○ Use external secret provider
Enter MiniMax CN API key (sk-api- or sk-cp-)
│ sk-cp-j7hnSxxxxxxx... # API Key粘贴到这里，然后回车
# 当前代理中，模型的API key会保存在这个文件中~/.openclaw/agents/main/agent/auth-profiles.json
Models in /model picker (multi-select)
# 之前输入 Minimax 的 API Key，只是告诉 OpenClaw：「我有访问 Minimax 平台的权限了」；
# 而这一步选模型，是告诉 OpenClaw：
# 「我要从 Minimax 平台的多个模型中，选定具体用哪一个 / 哪几个来运行 AI 对话」
Models in /model picker (multi-select)
│ Search: 默认应该会选择MiniMax最新的模型，下面的highspeed是我用空格键选中的，选好模型后回车就行
│ ...
│ ◻ kimi-coding/k2p5
│ ◼ minimax/MiniMax-M2.5
│ ◼ minimax/MiniMax-M2.5-highspeed (MiniMax M2.5 Highspeed · ctx 195k · reasoning)
# 回到上层菜单选最下面的Continue,配置就算完成了
Select sections to configure
│ Continue
三个实用的OpenClaw管理命令：
#-1-启动 OpenClaw 的 Web 可视化仪表盘（获取token web访问连接）
987@hk987.xyz:~$ openclaw dashboard --no-open
openclaw dashboard：启动 OpenClaw 的 Web 可视化仪表盘（用于图形化管理智能体、模型、会话、配置等）；
--no-open：禁止自动打开浏览器（默认情况下，启动仪表盘会自动弹出浏览器窗口访问，加此参数后仅打印 URL，需手动打开）
#-2-查看OpenClaw运行状态
987@hk987.xyz:~$ openclaw status
#-3-检查配置
987@hk987.xyz:~$ openclaw doctor
4.卸载
# 如果不需要使用openclaw了，可以使用下面的命令一键卸载
987@hk987.xyz:~$ openclaw uninstall --all --yes --non-interactive
0×2.Windows安装OpenClaw
1.安装与初始化配置
# 首先为当前用户启动允许无签名脚本运行权限，打开Powershell输入下面的指令回车
# 当前用户允许运行本地脚本（无签名），仅要求远程下载的脚本有签名
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
# 使用官方推荐安装命令，一键安装
iwr -useb https://openclaw.ai/install.ps1 | iex
# 配置openclaw
openclaw configure
Workspace里面设置一下龙虾的工作路径，Model里面配置模型的API key，然后Gateway中可以设置Web管理页面的访问Token，初始化配置和Linux一样就不再赘述了，详细请参考本文上面Linux部分。
2.手动启动OpenClaw
# 启动OpenClaw网关服务
openclaw gateway
# 如果忘记了Token，通过下面的命令显示带Token的连接
openclaw dashboard --no-open
3.创建计划任务，开机自动启动网关服务
# 自动创建计划任务
openclaw gateway install
# 打开启动文件夹，在其中创建快捷方式
Win+R → shell:startup
新建快捷方式 → 请输入对象位置中，输入下面这一行：
schtasks /Run /TN "OpenClaw Gateway"
命名：OpenClaw Gateway
重启
4.如果不想使用了，用下面的方法卸载：
# 1. 先停止网关服务
openclaw gateway stop
# 2. 官方一键卸载（含服务、配置、数据）
openclaw uninstall --all --yes --non-interactive
# 3. 删除Win+R → shell:startup中的快捷方式