OpenClaw 本地部署与飞书机器人接入指南

步骤 3：安装 Git

为什么需要 Git? OpenClaw 的一些依赖项可能直接从 GitHub 仓库安装。

操作步骤: 访问 Git 官网下载安装程序：https://git-scm.com/download/win 运行安装程序。在关键的 '选择组件' 步骤中，务必勾选 'Git from the command line and also from 3rd-party software'。 其他选项保持默认，一路 "Next" 完成安装。 安装完成后，再次重启 PowerShell 窗口，然后验证：

git --version

第二阶段：安装 OpenClaw 核心程序

步骤 4：执行安装命令

方法 A (推荐 - 手动 npm 安装):

npm install -g openclaw@latest

方法 B (一键脚本安装):

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

注意：如果使用此方法，请在运行后仔细观察窗口输出。如果它停留在 [OK] Windows detected 后就无响应，说明它可能未能自动完成后续的 npm 安装步骤。此时，请回到方法 A，使用 npm 命令手动安装。

步骤 5：解决可能遇到的错误

错误 1: 无法加载文件 ...，因为在此系统上禁止运行脚本。 原因: PowerShell 的执行策略 (Execution Policy) 默认设置为 Restricted。 解决方案:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。之后重新尝试安装命令。

错误 2: npm ERR! code ENOTENV 或 npm ERR! enoent ... git 原因: 系统找不到 git 命令。 解决方案: 请回到本章步骤 3，正确安装 Git 并确保其添加到 PATH 中。安装成功后，务必关闭当前 PowerShell 并打开一个新窗口。

错误 3: npm ERR! code 128 原因: 这是一个与 Git 相关的通用错误，可能的原因包括网络问题或 Git 配置问题。 解决方案:

1. 确认 Git 本身能正常工作：git clone https://github.com/nodejs/node.git --depth 1
2. 尝试更换 npm 镜像：npm config set registry https://registry.npmmirror.com

第三阶段：初始化配置并接入飞书

步骤 6：启动配置向导 在 PowerShell 中直接输入以下命令：

openclaw onboard

步骤 7 详细讲解：openclaw onboard 配置向导完全指南

1. 同意风险须知（Risk Acknowledgment）

当向导启动后，您会首先看到一段关于使用开源软件潜在风险的提示。 操作: 您需要输入 Yes（通常要求完整拼写）以继续。

2. 选择配置模式（Configuration Mode）

向导会询问您希望以哪种模式进行配置：

• QuickStart（快速开始）: 以问答形式引导您完成最核心的配置（AI 模型 + 通讯软件）。这是初次使用者的首选。
• Advanced（高级模式）: 直接打开一个配置文件供您手动编辑。

3. 配置 AI 模型（AI Model Configuration）

这是 OpenClaw 的'大脑'配置环节。由于 DeepSeek 的 API 完全兼容 OpenAI 格式，可以通过 openai-compatible 类型轻松接入。

3.1 通过 JSON 文件导入 DeepSeek 模型

以下是一个完整的 JSON 配置文件示例（~/.openclaw/config.json），展示了如何将 DeepSeek 配置为默认模型：

{
  "models": {
    "default": "deepseek-chat",
    "providers": {
      "deepseek": {
        "type": "openai-compatible",
        "baseURL": "https://api.deepseek.com",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "models": [
          {
            "name": "deepseek-chat",
            "description": "DeepSeek-V3 通用对话模型",
            "maxTokens": 8192,
            "temperature": 0.7
          }
        ]
      }
    }
  }
}

关键配置详解:

• type: "openai-compatible": 接入 DeepSeek 的核心。
• baseURL: 必须设置为 https://api.deepseek.com（不加 /v1）。
• apiKey: 建议使用环境变量引用，避免明文写入配置文件。

如何验证配置生效:

openclaw doctor

您将看到类似以下输出，确认 DeepSeek 已成功加载。

3.2 填写 DeepSeek 参数

当您选择自定义模式后，向导会逐一询问以下内容：

• Base URL: 输入 https://api.deepseek.com
• API Key: 输入您在 DeepSeek 开放平台创建的 API Key。
• Model Name: 例如 deepseek-chat, deepseek-reasoner。

4. 配置通讯软件（接入飞书）

4.1 准备飞书应用凭证

在向导开始询问具体参数前，您需要提前在飞书开放平台创建一个应用：

1. 访问 飞书开放平台。
2. 创建企业自建应用，获取 App ID 和 App Secret。
3. 配置事件订阅：启用事件订阅，请求地址 URL 需为公网可访问的地址（如使用 ngrok 等内网穿透工具）。
4. 添加事件：message.receive_v1, bot.add。
5. 配置权限：im:message, im:message:send_as_bot 等。
6. 发布版本。

4.2 在向导中填写飞书参数

回到 OpenClaw 配置向导，它会依次询问：

• App ID: 粘贴您保存的 App ID。
• App Secret: 粘贴 App Secret。
• 事件回调 URL: 向导可能会要求您确认或自动生成一个路径，您需要在飞书后台填入完整的 URL。

4.3 测试飞书连接 填写完毕后，向导会尝试向飞书服务器发送一个测试请求。如果成功，会显示'飞书配置验证通过'。

5. 配置 Skills（技能）

Skills 是 OpenClaw 的功能插件。在 QuickStart 模式下，向导通常只会询问是否要立即安装一些常用 Skills。建议选择 No 或 Skip，后续可通过 openclaw skills install <skill-name> 按需添加。

6. 完成配置与启动

所有问答结束后，向导会生成配置文件。建议运行诊断命令检查配置是否正确：

openclaw doctor

如果一切正常，您就可以启动机器人了：

openclaw start

常见问题与解决方案

附录：常用命令参考

安装与更新

# 一键安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

# 通过 npm 全局安装/更新
npm install -g openclaw@latest

配置向导与初始化

# 启动交互式配置向导
openclaw onboard

# 重新运行配置
openclaw configure

网关控制

openclaw gateway start
openclaw gateway stop
openclaw gateway restart

配置管理

# 查看配置项
openclaw config list

# 设置默认主模型
openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

诊断与日志

# 运行健康检查
openclaw doctor

# 查看实时日志
openclaw logs --follow

飞书通道配置

# 设置飞书 App ID
openclaw config set channels.feishu.appId "your_app_id"

# 设置飞书 App Secret
openclaw config set channels.feishu.appSecret "your_app_secret"

# 批准飞书用户访问
openclaw pairing approve feishu your_pairing_code

至此，您已经完成了 OpenClaw 从安装到配置的全过程，并成功接入了飞书和 DeepSeek 模型。接下来，您可以尝试在飞书中@机器人发送消息，观察它是否能调用 DeepSeek 智能回复。祝您探索愉快！