首页 > AI教程 >OpenClaw与Ollama本地部署及飞书Windows平台集成指南

OpenClaw与Ollama本地部署及飞书Windows平台集成指南

来源：互联网 2026-07-30 07:54:02

在Windows10环境下，通过PowerShell配置Node.js和Ollama本地模型服务，并安装部署OpenClaw核心与网关。随后安装飞书插件，配置飞书开放平台应用的事件回调与权限，最后在OpenClaw中完成飞书频道配置，实现本地AI助手与飞书的集成。

想在本地电脑上搭建一个能与飞书集成的AI助手吗？本文将详细介绍在Windows 10系统下的完整部署流程，帮助你实现这一目标。测试环境为Windows 10，配备32GB内存和一张RTX 3060 Ti显卡。请跟随以下步骤开始操作。

环境准备

首先，请确保以管理员身份运行PowerShell。我们需要调整PowerShell的执行策略，以便后续脚本能够顺利执行。请在PowerShell中输入以下命令：

长期稳定更新的攒劲资源： >>>点此立即查看<<<

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入 Y 确认

1. 安装 Node.js

Node.js是运行环境的基础。请安装版本不低于18.0.0的Node.js。安装完成后，可以通过运行 node --version 命令来验证安装是否成功。

2. 安装 Ollama

接下来，需要部署一个本地语言模型服务。这里选择安装Ollama，并使用通义千问的8B版本模型（qwen3:8b）。你可以根据自己电脑的显卡显存情况，选择其他更小或更大的模型。

3. 部署 OpenClaw

3.1 安装 OpenClaw 核心

通过npm命令全局安装OpenClaw：

npm install -g openclaw
#验证安装
openclaw --version
# 2026.2.25

安装过程中可能会遇到问题。如果执行 npm install -g openclaw 时出现类似下面的错误：

PS D:\dmtcg\front_end> npm install -g openclaw
npm error code 128
npm error An unknown git error occurred
npm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
npm error git@github.com: Permission denied (publickey).
npm error fatal: Could not read from remote repository.
...

这通常是因为npm尝试通过SSH协议克隆代码仓库，而本地Git未配置相应密钥。一个快速的解决方法是临时切换到HTTPS协议。在当前PowerShell窗口中执行：

git config --global url."https://github.com/".insteadOf git@github.com:
# 然后重新运行安装命令
npm install -g openclaw

3.2 运行配置向导

安装成功后，运行配置向导。以下是关键配置项的说明：

Model/auth provider: 选择 Custom Provider（通常需要用方向键滚动到列表末尾）。
API Base URL: 输入 http://127.0.0.1:11434/v1（这是Ollama的本地API地址）。
API Key: 可以输入任意字符串，例如 ollama（Ollama本身无需鉴权，但此项不能为空）。
Endpoint compatibility: 选择 OpenAI-compatible。
Model ID: 输入之前在Ollama中拉取的模型名称，如 qwen3:8b。
后续关于配置渠道、技能等选项，全部选择 Skip for now 或 No 跳过即可。

3.3 启用管理界面服务

接下来，安装并启动网关服务，这是OpenClaw的管理界面。

# 安装gateway服务
openclaw gateway install
# 启动网关服务
openclaw gateway start
# 查看服务状态，确保为 "running"
openclaw gateway status

启动成功后，打开浏览器，访问 http://127.0.0.1:18789 或 localhost:18789。在某些环境中，可能需要使用 localhost 才能正常访问。

此时，直接对话可能仍会报错。这是因为默认配置文件中，模型上下文长度（tokens）的设置可能不足。需要手动修改配置文件，将相关参数（如 max_tokens 或 context_length）调整到至少16000，以满足OpenClaw的最低要求。

4. 集成飞书

4.1 安装飞书插件

现在，开始将OpenClaw与飞书连接。首先安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu

这一步也可能遇到问题。如果报错信息中包含类似 Failed to start CLI: Error: spawn EINVAL 的错误，并指向一个名为 exec-TIZD7ZZn.js 的文件，则需要找到该文件，将其中的某个 shell: false 选项改为 shell: true（具体行号需根据错误堆栈定位）。修改保存后，重新运行安装命令：

openclaw plugins install @openclaw/feishu

安装后，可以尝试将插件升级到最新版本：

openclaw plugins update feishu

最后，插件目录下的依赖安装可能会失败。需要手动进入插件目录执行安装：

cd C:\Users\[你的用户名]\.openclaw\extensions\feishu
npm install --verbose

4.2 配置飞书开放平台

插件安装完成后，需要在飞书开放平台创建一个应用。

访问飞书开放平台，创建一个新的企业自建应用。
在应用能力中，选择“添加机器人”。
为机器人开通必要的API权限，或者直接导入所有推荐权限以确保功能完整。
最关键的一步：配置“事件与回调”。你需要启用“接收消息”等事件订阅，并将OpenClaw网关提供的URL（通常是 https://你的域名或穿透地址/feishu/events）填入请求地址URL。同时，飞书会提供加密令牌，需要在OpenClaw配置中对应填写。

重要提示：在飞书开放平台完成所有配置后，务必进行“创建版本”和“发布上线”操作，否则配置不会生效。

4.3 配置 OpenClaw 的飞书频道

最后一步，在OpenClaw中配置飞书连接。你需要使用飞书开放平台提供的 App ID 和 App Secret。

在PowerShell中运行 openclaw config 命令，会打开配置文件。找到 channels.feishu 部分，进行如下配置：

channels:
  feishu:
    enabled: true
    appId: "cli_xxxxx" # 替换为你的飞书应用 App ID
    appSecret: "secret" # 替换为你的飞书应用 App Secret
    # 域名: "feishu" (国内) 或 "lark" (国际)
    domain: "feishu"
    # 连接模式: "websocket" (推荐) 或 "webhook"
    connectionMode: "websocket"
    # 私聊策略: "pairing" | "open" | "allowlist"
    dmPolicy: "pairing"
    # 群聊策略: "open" | "allowlist" | "disabled"
    groupPolicy: "allowlist"
    # 群聊是否需要 @机器人
    requireMention: true
    # 媒体文件最大大小 (MB, 默认 30)
    mediaMaxMb: 30
    # 回复渲染模式: "auto" | "raw" | "card"
    renderMode: "auto"

配置完成后，重启OpenClaw网关服务：