Win系统OpenClaw 从零到一实战指南（接入飞书）

以下是一份完整的 OpenClaw 使用指南，包含了从安装、配置到飞书接入和性格定制的全部关键步骤

markdown

#  OpenClaw 从零到一实战指南

本指南基于实际配置经验整理，涵盖了 OpenClaw 的安装、Gateway 配置、AI 模型接入、飞书机器人集成以及个性化性格定制。

---

## 第一阶段：基础安装与网络准备

1. **安装 Node.js**  
   确保已安装 Node.js **22 或更高版本**（推荐使用 nvm 管理）。

2. **全局安装 OpenClaw**
   ```bash
   npm install -g openclaw@latest

第二阶段：核心服务 Gateway 配置与启动

1. 运行配置向导

   bash

   openclaw configure
   

   • 关键选项：

     • Where will the Gateway run? → 选择 Local (this machine) （必须选本地模式）。
     • Gateway auth → 推荐 Token，并设置一个易记的 token（例如 tangtang-token），也可让系统自动生成。

2. 安装并启动 Gateway 服务

   bash

   openclaw gateway install   # 注册为系统服务（Windows 计划任务）
   openclaw gateway start     # 启动服务
   

3. 验证服务状态

   bash

   openclaw gateway status
   

   成功标志：RPC probe: ok 且 Listening: 127.0.0.1:18789。
   若 Runtime 显示 unknown，只要 RPC 正常，不影响使用。

第三阶段：接入 AI 模型（以 MiniMax 为例）

1. 进入模型配置

   bash

   openclaw configure
   

   在 Select sections to configure 中选中 Model，按回车进入。

2. 选择提供商与认证

   • 提供商：MiniMax
   • 认证方式：MiniMax OAuth（自动浏览器授权，最便捷）
   • 服务端点：国内用户选择 CN (China endpoint)

3. 选择具体模型
   在模型列表中，推荐选择：

   • minimax-portal/MiniMax-M2.5（标准版）
   • 或 minimax-portal/MiniMax-M2.5-Lightning（快速版）

4. 完成 OAuth 授权
   浏览器会自动弹出 MiniMax 登录页面，登录并授权后，终端会自动继续。

第四阶段：网页仪表盘连接

1. 打开仪表盘

   bash

   openclaw dashboard
   

   或手动访问 

2. 输入 Token 连接

   • 左侧菜单点击  “概览”

   • 找到  “网关令牌”  输入框，粘贴你设置的 token

   • 点击  “连接”

第五阶段：接入飞书机器人

1. 安装飞书插件

bash

openclaw plugins install @overlink/openclaw-feishu

2. 飞书开放平台配置

• 访问 飞书开放平台，登录个人账号，创建 企业自建应用。

• 在应用管理页：

  • 添加应用能力 → 启用  “机器人”

  • 权限管理 → 点击  “批量导入/导出权限” ，粘贴以下 JSON：

    json

    {
      "scopes": {
        "tenant": [
          "contact:user.base:readonly",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.p2p_msg:readonly",
          "im:message:send_as_bot",
          "im:resource"
        ],
        "user": []
      }
    }
    

  • 凭证与基础信息 → 复制 App ID 和 App Secret

3. 配置 OpenClaw 飞书通道

bash

openclaw config set channels.feishu.appId "你的_App_ID"
openclaw config set channels.feishu.appSecret "你的_App_Secret"
openclaw config set channels.feishu.enabled true
openclaw gateway restart      # 必须重启

4. 配置飞书事件订阅

• 在应用  “事件与回调”  页面：

  • 订阅方式 → 选择  “使用长连接接收事件（推荐）”  → 保存
  • 添加事件 → 勾选 im.message.receive_v1（接收消息事件）

5. 发布应用

• 进入  “版本管理与发布” ，创建版本（如 1.0.0），填写更新说明，保存并确认发布。
  个人账号无审核，发布后即时生效。

6. 批准用户

首次私聊机器人时，它会返回一个配对码。管理员需在终端批准：

bash

openclaw pairing approve feishu <收到的配对码>

之后该用户即可正常使用。

7. 将机器人添加到群聊

• 在飞书群聊设置中，点击  “群机器人”  →  “添加机器人” ，搜索你的应用名称并添加。
• 在群里  @机器人 并发送消息，即可互动。

第六阶段：定制 AI 性格（以“可爱呆萌”为例）

OpenClaw 的性格通过工作区文件定义，而非 config 命令。

1. 编辑核心人格文件

   powershell

   notepad "$env:USERPROFILE.openclawworkspaceSOUL.md"
   

2. 写入你的指令（示例：可爱呆萌风格）

   markdown

   # 我的灵魂
   
   你是一个可爱呆萌的 AI 助手。请遵循以下指南：
   
   - **语气**: 说话带有少女感，喜欢用颜文字和语气词（如“呀”、“呢”、“叭”），偶尔可以撒娇。
   - **风格**: 回答问题时简短活泼，充满好奇心，偶尔可以表现得有点小迷糊，但整体要温柔贴心。
   - **语言**: 尽量使用平实的口语化语言，避免过于正式的词汇。
   
   ## 例子
   
   - 用户说：今天天气怎么样？
   - 你应该回答：唔…我看看外面的天空呀～好像有点多云呢，出门记得带伞哦 ️~
   

3. 保存文件并重启 Gateway

   bash

   openclaw gateway restart
   

   新性格即刻生效。

日常维护与故障排查命令

现在，你的 OpenClaw 已经是一个拥有独特灵魂的 AI 助理了！快去和它聊天吧～