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

先列出几个必知前提——本指南基于真实配置经验整理，覆盖 OpenClaw 安装、Gateway 配置、AI 模型对接、飞书机器人集成，以及个性化角色设定。

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

开始前，确保下列准备工作就绪：

1. 安装 Node.js：本地须已安装 Node.js，版本需为 22 或更高。推荐使用 nvm 管理 Node 版本，便于切换。
2. 全局安装 OpenClaw：打开终端，执行以下命令。

npm install -g openclaw@latest

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

准备工作完成后，进入核心服务的配置与运行环节。

1. 运行配置向导

   openclaw configure

   以下关键选项需注意：

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

2. 安装并启动 Gateway 服务

   openclaw gateway install   # 注册为系统服务，Windows 下对应计划任务
   openclaw gateway start     # 启动服务

3. 验证服务状态

   openclaw gateway status

   成功标志很直观：看到 RPC probe: ok 和 Listening: 127.0.0.1:18789 即可。如果 Runtime 显示 unknown，无需担心，只要 RPC 正常，不影响使用。

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

Gateway 启动后，如何接入 AI 模型？

1. 进入模型配置

   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. 打开仪表盘

   openclaw dashboard

   或直接在浏览器访问 http://127.0.0.1:18789/。

2. 输入 Token 连接

   • 在左侧菜单点击 “概览”
   • 找到 “网关令牌” 输入框，填入之前设置的 token
   • 点击 “连接” 按钮，完成。

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

接下来是重点——如何将 OpenClaw 与飞书机器人对接。

1. 安装飞书插件

openclaw plugins install @overlink/openclaw-feishu

2. 飞书开放平台配置

• 访问飞书开放平台，登录个人账号，创建一个企业自建应用。
• 在应用管理页面：
  • 先添加应用能力，启用 “机器人”
  • 再到权限管理，点击 “批量导入/导出权限”，将以下 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 飞书通道

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. 批准用户

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

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

批准后该用户才能正常使用。

7. 将机器人添加到群聊

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

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

OpenClaw 的性格由工作区文件定义，而非通过 config 命令。这一点需要明确。

1. 编辑核心人格文件

   notepad "$env:USERPROFILE.openclawworkspaceSOUL.md"

2. 写入你的指令（以下是一个可爱呆萌风格的示例）

# 我的灵魂
你是一个可爱呆萌的 AI 助手。请遵循以下指南：
- **语气**: 说话带有少女感，喜欢用颜文字和语气词（如“呀”、“呢”、“叭”），偶尔可以撒娇。
- **风格**: 回答问题时简短活泼，充满好奇心，偶尔可以表现得有点小迷糊，但整体要温柔贴心。
- **语言**: 尽量使用平实的口语化语言，避免过于正式的词汇。

## 例子
- 用户说：今天天气怎么样？
- 你应该回答：唔…我看看外面的天空呀～好像有点多云呢，出门记得带伞哦 ☂️~

1. 保存文件并重启 Gateway

   openclaw gateway restart

   保存新性格后，重启 Gateway 即可立即生效。

日常维护与故障排查命令

现在，你的 OpenClaw 已经成为一个拥有独特灵魂的 AI 助手。快去和它聊聊天吧～ ????