1. 项目概述在当今AI技术快速发展的背景下本地部署大语言模型成为许多开发者和技术爱好者的需求。本文将详细介绍如何在Windows和Mac系统上通过Ollama和OpenClaw搭建一套完整的本地AI助手系统并实现与飞书机器人的对接。这套方案的核心优势在于完全本地运行无需消耗云服务token支持多种主流大语言模型如LLaMA 3、Qwen等可通过飞书等办公软件便捷访问可根据硬件配置灵活选择适合的模型2. 环境准备与Ollama安装2.1 Ollama简介与下载Ollama是一个开源的本地大语言模型运行框架支持在个人电脑上运行多种开源模型。它提供了简单的命令行接口和REST API方便开发者集成到自己的应用中。安装步骤访问Ollama官网(https://ollama.com/)根据操作系统选择对应的安装包(Windows/macOS)下载完成后运行安装程序提示安装过程中Ollama会自动启动后台服务默认监听11434端口2.2 安装验证与基本使用安装完成后可以通过命令行验证是否安装成功ollama -v成功运行第一个模型的命令示例ollama run llama3首次运行会下载模型文件(约4-5GB)下载完成后即可开始交互。2.3 模型管理技巧常用模型管理命令查看已安装模型ollama list删除模型ollama rm 模型名更新模型ollama pull 模型名模型推荐组合通用聊天llama3或qwen2.5编程辅助deepseek-coder推理任务deepseek-r13. OpenClaw安装与配置3.1 WSL2环境准备Windows系统需要通过WSL2运行OpenClaw安装步骤如下启用WSL功能wsl --install设置WSL2为默认版本wsl --set-default-version 2安装Ubuntu 22.04发行版wsl --install --web-download -d Ubuntu-22.043.2 OpenClaw安装流程在WSL环境中执行以下步骤更新系统包sudo apt update sudo apt upgrade -y安装基础依赖sudo apt install -y curl git build-essential安装Node.jscurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs安装OpenClawnpm install -g openclawlatest3.3 OpenClaw初始化配置执行初始化命令openclaw onboard --install-daemon配置过程中需要注意选择模型类型时选OpenAI-compatible基础URL设置为http://本地IP:11434/v1API Key可填写ollama-local作为占位符4. 飞书机器人对接4.1 飞书应用创建访问飞书开放平台(https://open.feishu.cn/app)创建企业自建应用记录App ID和App Secret4.2 权限配置必须开通的权限包括获取用户基础信息接收消息发送消息获取用户邮箱获取用户手机号4.3 OpenClaw飞书插件安装在OpenClaw项目目录执行pnpm openclaw plugins install ./extensions/feishu pnpm openclaw channels add配置飞书连接时选择WebSocket模式并填写从开放平台获取的App ID和App Secret。5. 日常使用与维护5.1 启动顺序启动Ollama服务set OLLAMA_HOST0.0.0.0:11434 ollama serve启动OpenClaw网关cd ~/openclaw pnpm openclaw gateway --port 19001访问Dashboardhttp://127.0.0.1:19001/5.2 常见问题排查飞书消息无响应检查OpenClaw网关是否运行查看日志确认WebSocket连接状态模型响应异常验证模型状态pnpm openclaw models status --probe检查Ollama服务是否正常运行权限相关问题确认飞书应用已发布新版本检查所有必需权限是否已开通6. 技能扩展与优化6.1 常用技能安装增强AI助手能力的推荐技能GitHub相关gh-issues, gitgrep多媒体处理video-framesAPI调用xurl安装所需依赖sudo apt install -y gh ffmpeg jq ripgrep curl6.2 性能优化建议根据硬件配置选择合适的模型8GB内存Mistral 7B16GB内存Llama3 8B32GB内存Qwen2.5 14B调整Ollama参数设置环境变量控制线程数使用--num-gpu参数启用GPU加速网络优化对于局域网访问调整Ollama监听地址考虑使用Nginx反向代理提高稳定性这套本地AI助手系统经过实际测试在16GB内存的Windows笔记本上运行Llama3 8B模型响应速度可满足日常办公需求。飞书机器人对接稳定能够处理复杂的自然语言交互任务。
1. 项目概述在当今AI技术快速发展的背景下本地部署大语言模型成为许多开发者和技术爱好者的需求。本文将详细介绍如何在Windows和Mac系统上通过Ollama和OpenClaw搭建一套完整的本地AI助手系统并实现与飞书机器人的对接。这套方案的核心优势在于完全本地运行无需消耗云服务token支持多种主流大语言模型如LLaMA 3、Qwen等可通过飞书等办公软件便捷访问可根据硬件配置灵活选择适合的模型2. 环境准备与Ollama安装2.1 Ollama简介与下载Ollama是一个开源的本地大语言模型运行框架支持在个人电脑上运行多种开源模型。它提供了简单的命令行接口和REST API方便开发者集成到自己的应用中。安装步骤访问Ollama官网(https://ollama.com/)根据操作系统选择对应的安装包(Windows/macOS)下载完成后运行安装程序提示安装过程中Ollama会自动启动后台服务默认监听11434端口2.2 安装验证与基本使用安装完成后可以通过命令行验证是否安装成功ollama -v成功运行第一个模型的命令示例ollama run llama3首次运行会下载模型文件(约4-5GB)下载完成后即可开始交互。2.3 模型管理技巧常用模型管理命令查看已安装模型ollama list删除模型ollama rm 模型名更新模型ollama pull 模型名模型推荐组合通用聊天llama3或qwen2.5编程辅助deepseek-coder推理任务deepseek-r13. OpenClaw安装与配置3.1 WSL2环境准备Windows系统需要通过WSL2运行OpenClaw安装步骤如下启用WSL功能wsl --install设置WSL2为默认版本wsl --set-default-version 2安装Ubuntu 22.04发行版wsl --install --web-download -d Ubuntu-22.043.2 OpenClaw安装流程在WSL环境中执行以下步骤更新系统包sudo apt update sudo apt upgrade -y安装基础依赖sudo apt install -y curl git build-essential安装Node.jscurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs安装OpenClawnpm install -g openclawlatest3.3 OpenClaw初始化配置执行初始化命令openclaw onboard --install-daemon配置过程中需要注意选择模型类型时选OpenAI-compatible基础URL设置为http://本地IP:11434/v1API Key可填写ollama-local作为占位符4. 飞书机器人对接4.1 飞书应用创建访问飞书开放平台(https://open.feishu.cn/app)创建企业自建应用记录App ID和App Secret4.2 权限配置必须开通的权限包括获取用户基础信息接收消息发送消息获取用户邮箱获取用户手机号4.3 OpenClaw飞书插件安装在OpenClaw项目目录执行pnpm openclaw plugins install ./extensions/feishu pnpm openclaw channels add配置飞书连接时选择WebSocket模式并填写从开放平台获取的App ID和App Secret。5. 日常使用与维护5.1 启动顺序启动Ollama服务set OLLAMA_HOST0.0.0.0:11434 ollama serve启动OpenClaw网关cd ~/openclaw pnpm openclaw gateway --port 19001访问Dashboardhttp://127.0.0.1:19001/5.2 常见问题排查飞书消息无响应检查OpenClaw网关是否运行查看日志确认WebSocket连接状态模型响应异常验证模型状态pnpm openclaw models status --probe检查Ollama服务是否正常运行权限相关问题确认飞书应用已发布新版本检查所有必需权限是否已开通6. 技能扩展与优化6.1 常用技能安装增强AI助手能力的推荐技能GitHub相关gh-issues, gitgrep多媒体处理video-framesAPI调用xurl安装所需依赖sudo apt install -y gh ffmpeg jq ripgrep curl6.2 性能优化建议根据硬件配置选择合适的模型8GB内存Mistral 7B16GB内存Llama3 8B32GB内存Qwen2.5 14B调整Ollama参数设置环境变量控制线程数使用--num-gpu参数启用GPU加速网络优化对于局域网访问调整Ollama监听地址考虑使用Nginx反向代理提高稳定性这套本地AI助手系统经过实际测试在16GB内存的Windows笔记本上运行Llama3 8B模型响应速度可满足日常办公需求。飞书机器人对接稳定能够处理复杂的自然语言交互任务。
