OpenClaw完整配置教程：从安装到集成飞书

本指南基于实际配置过程编写，涵盖 OpenClaw 的安装、模型切换（OpenAI → DeepSeek）、飞书渠道集成、技能配置以及常见问题排查，旨在帮助你一站式搭建出自己的 AI 助理。

1. 环境准备

1.1 安装 Node.js

OpenClaw 基于 Node.js 开发，为确保最佳兼容性，推荐使用 v22 版本。

说起来，在不同的操作系统下，安装姿势也略有不同。

Windows 用户（建议在 WSL2 或 PowerShell 管理员模式下操作）

可以使用 nvm-windows 来管理版本，命令如下：

# 使用 nvm-windows 安装
nvm install 22
nvm use 22.22.0

macOS 或 Linux 用户

更推荐通过 nvm 来安装，一行命令搞定：

# 使用 nvm (推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install 22
nvm use 22

安装完成后，别忘了验证一下。在终端输入 node -v，如果显示 v22.x.x 就说明搞定了。

1.2 安装 OpenClaw

基础环境打好后，安装 OpenClaw 本身反而很简单。官方提供了一键安装脚本，省心省力。

Windows

iwr -useb https://openclaw.ai/install.ps1 | iex

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

完成后，用 openclaw --version 命令验证一下，看到版本号输出就意味着安装成功。

2. 初始配置（Onboarding）

安装只是第一步，接下来的配置才是让 AI 助理“活”起来的关键。运行配置向导开始：

openclaw onboard

向导会一步步引导你，几个关键选择这里划下重点：

• Config handling：如果是全新安装，直接选 Reset；如果只是想修改现有配置，就选 Update values。
• Mode：建议选择 Manual（手动模式）。虽然多花一两分钟，但能获得完全自定义的控制权，避免后续麻烦。
• Local gateway：选择 Local gateway (this machine)，让服务运行在本机。
• Workspace：使用默认路径即可，除非你有特别的存储需求。

完成以上几步，基础框架就搭好了。接下来，我们来搞定最核心的两部分：模型和渠道。

3. 配置 DeepSeek 模型（替代 OpenAI）

OpenClaw 默认可能指向 OpenAI，但国内开发者更熟悉的或许是 DeepSeek。切换过去并不复杂。

3.1 获取 DeepSeek API Key

1. 首先，访问 DeepSeek 开放平台 完成注册或登录。
2. 登录后，进入 **API Keys** 管理页面，点击“创建 API Key”按钮。
3. 系统会生成一个以 sk- 开头的密钥，务必及时复制保存好，关闭页面后就无法再次查看完整密钥了。