OpenClaw与Ollama本地部署指南：Windows飞书平台高效搭建教程

在本地部署一个与飞书深度集成的AI助手，可以显著提升团队协作效率。本指南基于Windows 10系统环境，配备32GB内存与RTX 3060 Ti显卡，为你提供一套完整的实操方案。

前置条件

首先，请以管理员身份启动Windows PowerShell。我们需要调整执行策略，以允许后续脚本顺利运行。执行以下命令：

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

1. 安装 Node.js

Node.js是运行JavaScript环境的基础。请安装18.0.0或更高版本。安装后，在终端输入 node --version 以验证版本。

2. 安装 Ollama

Ollama提供了便捷的本地大语言模型管理服务。我们选择部署通义千问8B参数模型（qwen3:8b）。请根据你的GPU显存容量选择合适的模型版本，若资源有限，可选用参数更小的模型。

3. 安装部署 OpenClaw

3.1 安装 OpenClaw 核心

通过npm包管理器全局安装OpenClaw框架：

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

安装过程可能遇到Git协议问题。若执行 npm install -g openclaw 时出现以下SSH密钥错误：

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协议：

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网关服务，以启用Web管理界面。

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

服务启动后，在浏览器中访问 http://127.0.0.1:18789 或 localhost:18789。部分环境可能仅支持 localhost 域名访问。

此时若测试对话返回错误，可能是默认模型上下文长度配置过低。你需要手动编辑相关配置文件，将 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

最后，进入插件目录手动安装其Node.js依赖包：

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

4.2 配置飞书开发平台

你需要在飞书开放平台创建并配置一个自建应用。

1. 登录飞书开放平台，创建新的“企业自建”类型应用。
2. 在“应用能力”中，启用“机器人”功能。
3. 为机器人申请必要的API权限，或直接导入全部推荐权限以确保功能完整性。
4. 核心步骤：配置“事件与回调”。启用“接收消息”等事件订阅，并将OpenClaw网关提供的Webhook URL（格式通常为 https://你的域名或穿透地址/feishu/events）填入“请求地址URL”。同时，将飞书平台提供的Encrypt Key和Verification Token同步配置到OpenClaw中。

关键提示：在飞书开放平台完成所有配置后，必须执行“创建版本”并“发布上线”，否则配置将无法生效。

4.3 配置 OpenClaw 的飞书频道

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

运行 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 gateway restart

5. 使用飞书和 OpenClaw 进行交互

至此，本地AI助手与飞书的集成部署已完成。你可以在飞书聊天中直接@你的机器人助手进行交互。

需要指出的是，当前方案更适合技术尝鲜与内部测试。根据社区反馈，OpenClaw在长期运行的稳定性方面仍有优化空间。未来可能需要结合OpenCode等工具进行深度调优，以提升其鲁棒性与性能。但这无疑是将私有化大语言模型能力融入日常办公流的一个坚实起点，具体效果有待你在实际业务场景中验证。

来源：互联网