�� OpenClaw WSL 配置教程

Kimi 模型 + 飞书渠道完整指南

本教程基于在 Windows WSL2（Ubuntu）环境下使用 OpenClaw 的完整操作，重点记录了成功配置 Kimi 模型（月之暗面 API）的步骤，以及飞书渠道的配置尝试。文档中的命令和操作均已在实际环境中验证。

1. 前置要求

Windows 系统已安装 WSL2，并配置好 Ubuntu（或其他 Linux 发行版）
已安装 Node.js（推荐 v18 或更高）
已安装 npm 或 pnpm 用于安装 OpenClaw
一个可用的月之暗面开放平台 API Key
（可选）一个飞书开发者账号及企业应用

2. 安装 OpenClaw

OpenClaw 可以通过 npm 全局安装：

npm install -g openclaw

安装完成后，验证安装：

which openclawopenclaw --version

输出应显示 openclaw 的路径和版本号（如 2026.3.13）。

Kimi 模型3. 配置 Kimi 模型（月之暗面 API）

1获取 API Key

登录月之暗面开放平台
进入控制台 → API 管理 → 创建 API Key
复制生成的 sk- 开头的密钥（仅显示一次，请妥善保存）

2运行交互式配置向导

执行以下命令启动向导：

openclaw configure

在向导中，按以下提示操作：

选择模型提供商
：在列表中找到 moonshot AI（如果列表中没有，可选择 OpenAI 兼容项，但 moonshot AI 会自动填充 Base URL）
输入 API Key
：粘贴你的 sk- 密钥
输入 Base URL
：如果未自动填充，手动输入 https://api.moonshot.cn/v1
输入模型名称
：填写 kimi-k2-0905-preview（或你购买的模型名称）
其他选项
：按默认或跳过（如聊天渠道等）

配置完成后，向导会自动保存设置。

3验证模型调用

执行以下命令测试：

openclaw agent --local --session-id test --message "你好，请简单介绍一下自己"

如果配置成功，你会看到 Kimi 模型的回复（如"你好！👋 我是你新唤醒的 AI 助手……"）。

4（可选）持久化环境变量

为了确保每次新终端都能正确调用，可以将以下变量添加到 ~/.bashrc 或 ~/.zshrc：

export OPENAI_API_KEY="sk-你的密钥"export OPENAI_BASE_URL="https://api.moonshot.cn/v1"export OPENAI_MODEL="kimi-k2-0905-preview"

然后执行 source ~/.bashrc 使其生效。

飞书渠道4. 配置飞书渠道

注意：本部分记录了配置飞书渠道的完整步骤，但目前飞书消息尚未成功接收（长连接模式下无响应）。这些步骤仍可作为参考，后续可能需要排查飞书开放平台事件订阅或改用 HTTP 回调模式。

1飞书应用准备

登录飞书开放平台
创建企业自建应用（或使用已有应用）
在应用详情页，记录 App ID 和 App Secret（在"凭证与基础信息"中）

2配置 OpenClaw 飞书插件

openclaw channels login feishu

根据提示输入 App ID 和 App Secret。成功后，渠道会被保存。

3启动网关

在一个终端窗口中运行：

openclaw gateway

正常情况下，你会看到类似以下的输出：

[feishu] starting feishu[default] (mode: websocket)[feishu] feishu[default]: WebSocket client started[info]: [ '[ws]', 'ws client ready' ]

这表明网关已启动并尝试连接飞书长连接。

4飞书开放平台事件配置

进入你的飞书应用 → 事件订阅
订阅方式
：选择 使用长连接接收事件
在"已添加事件"中，点击 添加事件，勾选 "接收消息 v2.0"（im.message.receive_v1）
确认所需权限已开通（如 im:message:receive_v1、im:chat:readonly 等）
点击保存，并发布应用新版本（应用 → 版本管理与发布 → 创建版本 → 发布）

5测试消息接收

在飞书客户端搜索你的机器人名称，进入私聊窗口
发送一条消息（如"测试"）
观察运行 openclaw gateway 的终端，看是否有日志输出

如果网关收到消息，应该会显示类似 [feishu] received message 的日志，并调用模型回复。如果无任何输出，请尝试以下排查方法。

5. 飞书消息未收到时的排查建议

1检查长连接状态

在飞书开放平台"事件订阅"页面，查看 长连接 区域是否有"已连接"提示（有时无明确状态）。尝试点击保存或 重新连接 按钮。

2启用调试日志

停止当前网关进程（Ctrl+C），运行：

DEBUG=feishu:* openclaw gateway

然后再次发送消息，观察是否有 [feishu] ws message: 等详细输出。若无任何输出，说明飞书未向 WebSocket 推送事件。

3改用 HTTP 回调模式（推荐用于排查）

如果长连接始终无效，可以临时改用 HTTP 回调模式验证网络连通性：

安装 ngrok（如果没有）
在一个新终端运行：
```
ngrok http 18789
```
记录生成的公网地址（如 https://xxxx.ngrok.io）
在飞书开放平台"事件订阅"中：

将订阅方式改为 HTTP 回调
请求网址填入：https://xxxx.ngrok.io/feishu/webhook
点击保存，飞书会发送验证请求，网关应自动响应（终端显示 [feishu] webhook verified）

保存成功后，再次向机器人发送消息，观察网关是否收到事件。

6. 常见问题

Q: `openclaw agent --local` 报错 "Unknown model: openai/kimi-k2-0905-preview"

A：可能是模型名称或认证配置未生效。请重新运行 openclaw configure，确保选择 moonshot AI 并输入正确的模型名称。

Q: 飞书渠道配置后，网关启动时报 "duplicate plugin id detected"

A：这通常是因为 ~/.openclaw/extensions/feishu 目录下存在重复插件。可以忽略，或清理该目录后重新安装插件。

Q: 飞书消息收不到，但 `openclaw status` 显示飞书状态为 OK

A：这表示渠道配置已保存，但长连接实际可能未建立。请按第 5 节排查。

7. 参考资源

OpenClaw 官方文档：docs.openclaw.ai
月之暗面 API 文档：platform.moonshot.cn/docs
飞书开放平台文档：open.feishu.cn/document

本文档基于实际操作整理，如果你在配置过程中遇到其他问题，欢迎继续交流。

关于作者

艺设·集美，策展与博物馆研究领域的实践者与观察者。专注于展览设计、数字博物馆、观众体验与文化传播的交叉研究。关注策展与技术的融合，致力于在理论与实务之间寻找平衡。每周更新策展干货、AI工具实操和数字文化观察等内容。