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

以下是一份完整的 OpenClaw 使用指南，包含了从安装、配置到飞书接入和性格定制的全部关键步骤。你可以将整个代码块保存为 .md 文件，方便随时查阅。

markdown

yaml 复制代码

# 🦞 OpenClaw 从零到一实战指南

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

---

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

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

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

网络问题处理 ：若安装时卡在 GitHub 相关依赖，需配置 Git 代理或设置 insteadOf 规则将 SSH 转为 HTTPS：

bash
arduino 复制代码
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

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

运行配置向导

bash
复制代码
```
openclaw configure
```
- 关键选项：
  - Where will the Gateway run? → 选择 Local (this machine) （必须选本地模式）。
  - Gateway auth → 推荐 Token ，并设置一个易记的 token（例如 tangtang-token），也可让系统自动生成。

安装并启动 Gateway 服务

bash

bash 复制代码

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

验证服务状态

bash
lua 复制代码
```
openclaw gateway status
```
成功标志 ：RPC probe: ok 且 Listening: 127.0.0.1:18789。
若 Runtime 显示 unknown，只要 RPC 正常，不影响使用。

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

进入模型配置

bash
复制代码
```
openclaw configure
```
在 Select sections to configure 中选中 Model，按回车进入。
选择提供商与认证
- 提供商：MiniMax
- 认证方式：MiniMax OAuth（自动浏览器授权，最便捷）
- 服务端点：国内用户选择 CN (China endpoint)
选择具体模型

在模型列表中，推荐选择：
- minimax-portal/MiniMax-M2.5（标准版）
- 或 minimax-portal/MiniMax-M2.5-Lightning（快速版）
完成 OAuth 授权

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

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

打开仪表盘

bash
复制代码
```
openclaw dashboard
```
或手动访问 http://127.0.0.1:18789/
输入 Token 连接
- 左侧菜单点击 "概览"
- 找到 "网关令牌" 输入框，粘贴你设置的 token
- 点击 "连接"
常见问题
- 若提示 unauthorized，请确认 Gateway 正在运行（openclaw gateway status）。
- 多次输错 token 会导致临时锁定，重启 Gateway 即可清除：openclaw gateway restart

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

1. 安装飞书插件

bash

bash 复制代码

openclaw plugins install @overlink/openclaw-feishu

2. 飞书开放平台配置

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

在应用管理页：

添加应用能力 → 启用 "机器人"

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

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

arduino 复制代码

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

xml 复制代码

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

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

7. 将机器人添加到群聊

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

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

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

编辑核心人格文件

powershell

bash 复制代码

notepad "$env:USERPROFILE.openclaw\workspace\SOUL.md"

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

markdown

markdown 复制代码

# 我的灵魂

你是一个可爱呆萌的 AI 助手。请遵循以下指南：

- **语气**: 说话带有少女感，喜欢用颜文字和语气词（如"呀"、"呢"、"叭"），偶尔可以撒娇。
- **风格**: 回答问题时简短活泼，充满好奇心，偶尔可以表现得有点小迷糊，但整体要温柔贴心。
- **语言**: 尽量使用平实的口语化语言，避免过于正式的词汇。

## 例子

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

保存文件并重启 Gateway

bash
复制代码
```
openclaw gateway restart
```
新性格即刻生效。

日常维护与故障排查命令

命令	说明
`openclaw status`	查看整体健康状态
`openclaw gateway status`	查看 Gateway 详细状态
`openclaw logs --follow`	实时跟踪日志（按 `Ctrl+C` 停止）
`openclaw gateway restart`	重启 Gateway 服务
`openclaw config get <key>`	查看某项配置（如 `gateway.auth.token`）
`openclaw doctor`	运行诊断并自动修复常见问题

提示：所有配置文件和日志默认位于 ~/.openclaw/ 目录下，重要数据请定期备份。

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

text

go 复制代码

你可以将以上内容复制到一个新建的 `.md` 文件中，例如 `OpenClaw_Guide.md`，方便日后查阅或分享。