安装配置
本页面帮助你根据自己的使用场景选择最合适的安装策略，并完成从源码构建 OpenClaw 所需的全部配置。
选择定制策略（Tailoring Strategy）
OpenClaw 提供两种主要的安装使用方式，你可以根据自己的需求选择：
| 策略 | 适合人群 | 说明 |
|---|---|---|
| 稳定工作流（Stable） | 大多数用户 | 使用 macOS 应用或 CLI 安装，开箱即用 |
| 前沿工作流（Bleeding Edge） | 开发者 / 贡献者 | 从源码克隆仓库，实时跟踪最新改动 |
如何选择？
如果你只是想用 OpenClaw 完成日常任务，选择稳定工作流即可。如果你想参与开发、调试或者需要最新功能，选择前沿工作流。
前置要求（从源码构建）
从源码运行 OpenClaw 需要以下环境：
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| Node.js | >= 22 | 运行时环境 |
| pnpm | 最新版 | 包管理器 |
| Docker | 可选 | 仅部分技能（Skill）需要 |
bash
node --version
# 要求 v22.0.0 或更高bash
corepack enable
corepack prepare pnpm@latest --activate注意
OpenClaw 不支持 npm 或 yarn 从源码构建。请务必使用 pnpm。
定制策略配置
OpenClaw 的全局配置文件和工作空间分别位于：
| 路径 | 用途 |
|---|---|
~/.openclaw/openclaw.json | 全局配置文件（Config） |
~/.openclaw/workspace/ | 默认工作空间（Workspace） |
配置文件示例 (~/.openclaw/openclaw.json)
json
{
"gateway": {
"port": 18789,
"host": "127.0.0.1"
},
"models": {
"default": "openai:gpt-4o"
},
"workspace": "~/.openclaw/workspace"
}你可以使用环境变量覆盖默认路径：
bash
# 自定义配置文件路径
export OPENCLAW_CONFIG_PATH="/your/custom/path/openclaw.json"
# 自定义工作空间路径
export OPENCLAW_WORKSPACE="/your/custom/workspace"稳定工作流（Stable Workflow）
推荐：macOS 用户
如果你使用 macOS，建议优先安装 macOS 应用，它提供图形化引导和更完整的系统集成。
第一步：安装 macOS 应用
bash
brew install openclaw --cask第二步：启动应用并完成引导
打开 OpenClaw 应用，按照 macOS 应用初始化 流程完成首次配置。
第三步：验证网关运行
bash
openclaw gateway status前沿工作流（Bleeding Edge Workflow）
适合想要实时跟踪最新开发进展的开发者。
第一步：克隆仓库
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw第二步：安装依赖
bash
pnpm install关于 gateway:watch
此命令以开发模式运行 Gateway（网关），文件变更时自动重新编译。适合本地开发和调试，不建议用于生产环境。
从仓库运行 Gateway（网关）
如果你已经从源码克隆了仓库，可以直接运行 Gateway（网关）：
bash
# 进入项目目录
cd openclaw
# 构建项目
pnpm build
# 启动 Gateway
pnpm gateway或使用开发模式：
bash
pnpm gateway:watchGateway（网关）默认监听 http://127.0.0.1:18789/。
凭据存储映射（Credential Storage）
OpenClaw 的 API 密钥和凭据通过配置文件管理，支持多种存储后端：
| 存储方式 | 说明 | 适用场景 |
|---|---|---|
| 配置文件 | 明文存储在 openclaw.json 中 | 本地开发 |
| 环境变量 | 通过 OPENCLAW_* 前缀的环境变量注入 | CI/CD、容器化部署 |
| 系统密钥链 | macOS Keychain / Linux Secret Service | 个人使用，安全性要求高 |
bash
# 通过环境变量设置 API 密钥
export OPENCLAW_OPENAI_API_KEY="sk-..."
export OPENCLAW_ANTHROPIC_API_KEY="sk-ant-..."使用 macOS Keychain 存储密钥
macOS 应用会自动使用系统 Keychain 存储凭据。CLI 用户可以通过引导向导配置：
bash
openclaw onboard
# 在认证步骤中选择 "System Keychain"Linux systemd 用户服务
在 Linux 上，你可以将 OpenClaw Gateway（网关）配置为 systemd 用户服务，实现开机自启和后台运行。
第一步：创建 service 文件
bash
mkdir -p ~/.config/systemd/user/ini
[Unit]
Description=OpenClaw Gateway
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=%h/.local/bin/openclaw gateway --port 18789
Restart=on-failure
RestartSec=5
Environment=NODE_ENV=production
[Install]
WantedBy=default.target第二步：启用并启动服务
bash
# 重新加载 systemd 配置
systemctl --user daemon-reload
# 启用开机自启
systemctl --user enable openclaw-gateway
# 立即启动
systemctl --user start openclaw-gateway第三步：查看运行状态
bash
systemctl --user status openclaw-gateway查看日志
bash
# 实时查看日志
journalctl --user -u openclaw-gateway -f
# 查看最近 50 行日志
journalctl --user -u openclaw-gateway -n 50Linux 用户注意
使用 systemctl --user 服务需要启用 linger，否则用户注销后服务会停止：
bash
sudo loginctl enable-linger $USER深入了解
引导向导详解CLI 向导完整参考和高级选项
→macOS 应用初始化macOS 应用的首次运行流程
→初始化概览所有初始化路径的对比概览
→