乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > �� OpenClaw WSL 配置教程

�� OpenClaw WSL 配置教程

当前时间： 2026-08-17 16:57:43 分类：办公文件 评论(0)
�� 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

  1. 登录 月之暗面开放平台
  2. 进入控制台 → API 管理 → 创建 API Key
  3. 复制生成的 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飞书应用准备

  1. 登录 飞书开放平台
  2. 创建企业自建应用（或使用已有应用）
  3. 在应用详情页，记录 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飞书开放平台事件配置

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

5测试消息接收

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

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

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

1检查长连接状态

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

2启用调试日志

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

DEBUG=feishu:* openclaw gateway

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

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

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

  1. 安装 ngrok（如果没有）
  2. 在一个新终端运行：
    ngrok http 18789
    记录生成的公网地址（如 https://xxxx.ngrok.io）
  3. 在飞书开放平台"事件订阅"中：
    • 将订阅方式改为 HTTP 回调
    • 请求网址填入：https://xxxx.ngrok.io/feishu/webhook
    • 点击 保存，飞书会发送验证请求，网关应自动响应（终端显示 [feishu] webhook verified）
  4. 保存成功后，再次向机器人发送消息，观察网关是否收到事件。

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工具实操和数字文化观察等内容。