大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
适用系统： Windows 10/11、macOS (Intel/Apple Silicon)、Linux (Ubuntu/Debian/Fedora/Arch)
 目标读者： 个人用户、开发者、运维人员

 

---

1. 系统要求
2. 前置条件
3. Windows 安装
4. macOS 安装
5. Linux 安装
6. 安装后配置
7. 常见问题与解决方案
8. 服务管理
9. 验证安装
10. 卸载与清理

---

---

1. 安装 Node.js

OpenClaw 基于 Node.js，需要先安装：

• Windows/macOS/Linux 通用： 从 nodejs.org 下载 LTS 版本（v20.x）
• 验证： 应输出 或更高

2. 安装 Git

部分技能安装依赖 git：

• Windows： 下载 Git for Windows，安装时勾选“Add to PATH”
• macOS：
• Linux：
  Ubuntu/Debian:
  Fedora:
  Arch:
  
  
  
  
  
  
  
  

3. (可选) Python 与 FFmpeg

某些技能（如 ）需要：

• Python 3.9+（先安装）
• FFmpeg：
  Windows：下载二进制并添加到 PATH
  macOS：
  Linux： 或对应包管理器
  
  
  
  
  
  
  
  

---

步骤 1：以管理员身份打开 PowerShell

Windows ¹⁰⁄₁₁：

• 按 → 选择 “Windows Terminal (Admin)” 或 “PowerShell (Admin)”
• 如果未启用脚本执行，先运行：

步骤 2：全局安装 OpenClaw CLI

等待完成（约 1–2 分钟）。如果速度慢，可配置 npm 镜像：

步骤 3：初始化 OpenClaw

这个命令会：

• 创建配置文件
• 生成默认技能目录
• 提示你配置 API 密钥（OpenRouter、OpenAI 等）

步骤 4：配置网关（Gateway）

OpenClaw 使用本地网关进行服务通信。确保：

应显示网关正在运行。如果未运行，执行：

关于网关 token：

• 首次运行会自动生成，存储在 的
• 如果需要重置，可运行 （如果支持）或手动编辑配置文件

---

步骤 1：安装 Homebrew（如未安装）

步骤 2：通过 Homebrew 安装 Node.js

步骤 3：全局安装 OpenClaw

步骤 4：初始化

步骤 5：网关管理

macOS 下网关作为后台服务运行：

---

Ubuntu / Debian

Fedora / RHEL

Arch Linux

---

1. 配置 AI 模型提供方

运行配置向导：

选择你要使用的模型提供商：

• OpenRouter（推荐，多模型，按用量计费）
• OpenAI（需 OpenAI API Key）
• Anthropic（Claude 系列）
• 本地模型（Ollama 等）

按提示输入 API Key。这些密钥将保存在 下（加密或明文取决于配置）。

2. 检查技能列表

应看到已安装的核心技能列表（如 、、 等）。如缺少所需技能，可后续安装。

3. 设置默认模型

编辑 或使用命令：

4. 配置通道（可选）

如需连接 Telegram、Discord、Slack 等，需在 中添加 配置，并安装对应技能。

示例（Discord）：

---

Q1: 或权限错误

问题： 全局安装时权限不足。

解决：

• 不推荐： 使用 （Linux/macOS）
• 推荐： 修改 npm 全局目录权限：
  重新登录后再次安装。

Q2: （Linux/macOS）

原因： npm 全局 bin 目录未加入 PATH。

解决：

Q3: 网关启动失败，提示

原因： 配置文件 中的 与运行中的网关服务环境变量 不一致。

解决：

1. 查看当前服务 token：

2. 更新 中的 token 与之匹配：

3. 重启网关：

Q4: 或通道错误

原因： 中配置了一个不存在的通道 ID。

解决：

• 检查 的 部分
• 删除未知的通道配置（如 ），仅保留已安装技能的通道（如 、）
• 运行 自动修复

Q5: 无法访问外网或 GitHub 克隆技能失败

现象：

解决：

1. 检查网络连接和代理设置：

2. 使用可访问的镜像（如果是中国地区）：

3. 手动下载 ZIP 并解压到技能目录

Q6: 技能安装失败，提示 或

原因： 安装的技能不是 OpenClaw 格式，或路径不对。

解决：

• 只从 OpenClaw 官方源或可信仓库安装技能
• 确保技能目录包含 和可执行文件
• 使用 查看已安装技能状态

Q7: 无反应

原因： 可能 stdout 被重定向或终端交互异常。

解决：

• 直接编辑 ：

• 在 创建对应文件（如 ），内容为 API Key

Q8: Windows 下网关无法启动，端口被占用

解决：

1. 检查端口占用：

2. 更换网关端口：

Q9: 技能需要 Python 依赖，运行时

解决： 为该技能创建虚拟环境并手动安装依赖（或在系统 Python 安装）：

OpenClaw 将在PATH中自动发现该虚拟环境。

Q10: 时区不对，时间显示错误

解决： 设置系统时区，或覆盖 OpenClaw 时区：

---

Windows

网关安装为计划任务（Scheduled Task）：

macOS / Linux

使用 systemd（Linux）：

macOS 使用 （由 openclaw 自动安装）。

---

1. 检查 CLI 版本：

2. 查看状态：

   应显示类似：

3. 运行快速测试：

4. 检查网关：

---

完全卸载 OpenClaw

Windows：

macOS / Linux：

---

openclaw.json 示例（Windows）

凭证文件（OpenRouter）

文件：

内容：

---

• 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/openclaw/openclaw
• 社区 Discord：https://discord.com/invite/clawd
• 问题反馈：https://github.com/openclaw/openclaw/issues

---

祝安装顺利！ 如遇未列出的问题，欢迎在社区提问。