OpenClaw 详细使用教程：从零搭建你的个人AI智能体系统

OpenClaw（原名 Clawdbot，昵称“小龙虾”）是一个本地优先、强执行能力的开源 AI 智能体（Agent）框架。它的核心价值在于让 AI “openclaw skills 教程真正能做事”——通过自然语言指令自动拆解任务、调用工具（Skills），在设备上完成实际操作，如文件处理、浏览器自动化、多平台联动等，而非仅提供对话回答。

本教程将从零开始，手把手教你在不同平台（Windows、macOS、Linux）上部署 OpenClaw，配置免费的大模型 API，并安装实用的技能（Skills），最终搭建出属于你自己的个人 AI 智能体系统。

在开始安装之前，需要确保你的环境和账号满足以下要求。

1.1 硬件与系统要求

• 内存：≥4GB（推荐 8GB 以上，多任务或复杂 Skills 需要更多）。
• 硬盘：可用空间 ≥10GB。
• 系统：
      – Windows: Windows 10/11 专业版或企业版（强烈推荐使用 WSL2，原生支持较差）。
      – macOS: macOS 12 及以上（兼容 Intel/Apple Silicon）。
      – Linux: Ubuntu 20.04+/Debian 11+/Fedora 38+。

1.2 核心依赖

• Node.js：版本必须 ≥ 22.0.0（18/20 版本可能存在兼容性问题）。
• Git：用于克隆代码和版本管理。
• Python：版本 ≥ 3.9（部分 Skills 执行依赖）。

1.3 账号准备（以阿里云百炼为例）

为了获得大模型的理解和生成能力，你需要一个大模型 API。本教程以 阿里云百炼 为例，因为它为新用户提供 90天免费额度，且国内访问稳定。

1. 注册并登录阿里云账号，完成实名认证。
2. 访问阿里云百炼大模型服务平台，开通服务。
3. 进入“密钥管理”，点击“创建API-Key”，生成并妥善保存你的 和 （Secret 仅创建时可见）。

1.4 网络环境优化（国内用户必看）

由于 GitHub 和 npm 源在国外，直接安装可能很慢或失败，建议提前配置国内镜像加速。

OpenClaw 提供了跨平台的一键安装脚本，可以自动处理大部分依赖，是新手的最佳选择。

2.1 一键安装 OpenClaw

根据你的操作系统，在终端（Linux/macOS）或 PowerShell（Windows）中执行相应命令。

• macOS / Linux:
   
    注：macOS 用户也可通过 Homebrew 安装 Node.js 22 后，再用此命令安装 。
• Windows 11 (强烈推荐 WSL2 方案):
    1.  以管理员身份打开 PowerShell，安装 WSL2 和 Ubuntu 子系统：
       
        重启电脑，完成 Ubuntu 的初始化设置（用户名和密码）。
    2.  打开 Ubuntu 终端，执行与 Linux 相同的安装命令：
       
• Windows 11 (原生 PowerShell 备选方案):
    1.  以管理员身份打开 PowerShell。
    2.  解锁脚本执行权限（仅对当前进程有效）：
       
    3.  执行安装命令：
       

安装完成后，验证是否成功：

2.2 初始化配置与启动网关

OpenClaw 的核心是一个叫 的服务，它负责提供 Web 控制台和处理任务。

1. 初始化配置：
      
       在 向导中，可以大部分情况选择默认选项（直接回车）。关键步骤提示：
       – 模型提供商：可以先选“Custom Provider”，后续再配置。
       – 技能初始化：选择“Yes”，启用核心技能框架。
       – 网关端口：保持默认 。
2. 配置网关模式（本地部署必做）：
      
3. 启动网关服务：
      
4. 生成访问令牌（Token）：
       Token 是登录 Web 控制台的密码，非常重要。
      

2.3 验证部署

打开浏览器，访问 。如果能看到 OpenClaw 的对话界面，恭喜你，核心部署成功！

OpenClaw 本身不包含大模型，需要对接外部 API 来获得智能。以下是配置阿里云百炼 API 的详细步骤。

3.1 通过命令行配置 API 密钥

将你在第一部分准备的阿里云百炼 API 密钥配置到 OpenClaw 中。

3.2 其他模型提供商（备选）

除了阿里云百炼，OpenClaw 还支持众多其他模型：

• 七牛云：在配置文件中设置 和你的 ，模型 ID 格式为 。
• 本地模型：也可以通过 Ollama 等工具集成本地运行的 Qwen2.5、Llama 3 等开源模型。

Skills 是 OpenClaw 的“手脚”，让它能真正执行任务。OpenClaw 预装了基础的 技能，使其具备网页访问能力。

4.1 安装新技能

你可以从 ClawHub 社区安装海量的技能。以下安装三个“拯救打工人”的神级 Skill 为例。

4.2 技能管理技巧

• 查看已安装技能：
• 技能存储位置：你的所有定制化数据（包括 Skills、提示词、记忆）都应保存在 目录下，这样可以安全更新 OpenClaw 版本而不会丢失个人配置。
• 技能选择原则：“痛点优先、安全第一、轻量化”。不要盲目安装过多技能，以免造成资源浪费或冲突。

5.1 配置开机自启（守护进程）

为了让 OpenClaw 在后台 7×24 小时运行，需要将其安装为系统服务。

• macOS（使用 launchd）：
   
• Linux（使用 systemd）：
   
• Windows（使用计划任务）：
   
    这会在任务计划程序中创建一个使用 账户运行的任务，实现登录自动启动。

5.2 重要文件存储路径

了解这些路径有助于你进行备份和迁移。

• 配置文件：
• 工作区（Skills， 提示词， 记忆）：
• 凭证（各类账号登录信息）：
• 会话记录：
• 日志文件： (macOS/Linux) 或 (Windows)

5.3 新手常见问题避坑指南

1. 端口被占用：
       – 现象：启动 Gateway 时报错 。
       – 解决：修改默认端口，，并在防火墙放行新端口。
2. Windows 原生部署权限不足：
       – 现象：安装或启动失败，提示权限错误。
       – 解决：务必以管理员身份运行 PowerShell，并将 OpenClaw 目录（如 ）添加到 Windows Defender 排除列表，避免被误判。
3. 阿里云国内地域网络受限：
       – 现象：无法从海外 ClawHub 下载 Skills，或某些海外服务（如 WhatsApp）Skills 调用失败。
       – 解决：在阿里云选购服务器时，地域优先选择“中国香港”或“美国弗吉尼亚”，这两个地域免备案且网络限制少。
4. Token 泄露风险：
       – 现象：他人未经授权访问你的 OpenClaw 控制台。
       – 解决：定期使用 重新生成 Token，并妥善保管，不要明文存储在公开位置。

通过以上步骤，你已经从零搭建了一个属于自己的、功能强大的 AI 智能体系统。OpenClaw 的真正魅力在于其无限的扩展性，现在，你可以开始探索 ClawHub 上超过 1.3 万个 Skills，或者尝试编写自己的 Skill，让你的“数字员工”完成更多专属任务。