本文介绍了在 Ubuntu 服务器上本地部署 OpenClaw 并接入 Ollama 模型及飞书通道的完整流程。内容涵盖环境检查、Ollama 安装与模型拉取、OpenClaw 安装配置、飞书应用对接、服务启动验证及常见问题排查。该方案适用于需要私有化 AI Agent 的个人开发者，实现本地推理与消息入口的集成。
本次部署采用单机本地方案：
数据路径：飞书消息 -> OpenClaw -> Ollama -> OpenClaw -> 飞书回复。
先确认系统和资源：
uname -m
lsb_release -a
free -h
df -h /
推荐配置：
安装并校验：
curl -fsSL https://ollama.com/install.sh | sh && ollama --version
拉取一个模型做烟雾测试：
ollama pull qwen2.5:7b
ollama run qwen2.5:7b "只回复 OK"
查看当前模型是否用到 GPU：
ollama ps
重点看 PROCESSOR 列：出现 GPU 说明已启用显卡推理。
如果系统还没有 Node/npm，先安装 Node 20 LTS：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
npm -v
安装 OpenClaw：
sudo npm i -g openclaw
将 OpenClaw 的模型提供方指向本机 Ollama API：
openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434/v1"
openclaw config set models.providers.ollama.apiKey "ollama-local"
openclaw models set ollama/qwen2.5:7b
说明：
apiKey 占位值就是 ollama-localmodels set 用于设置默认模型执行引导配置：
openclaw onboard
向导里选择：
feishu.cn，国际选 larksuite.comappId、appSecret如需通过配对码放行会话：
openclaw pairing list
openclaw pairing approve feishu <配对码>
启动网关：
openclaw gateway
看到以下日志即基本正常：
agent model: ollama/...listening on ws://127.0.0.1:18789另开终端跟日志：
openclaw logs --follow
No API key found for provider "ollama"原因：agent 侧缺少 Ollama auth/profile。 处理：
openclaw config set models.providers.ollama.apiKey "ollama-local"
openclaw gateway restart
failed to obtain token，并且请求 bot/v3/info 返回 400原因：飞书凭据或应用状态异常。 检查项：
appId/appSecret 是否正确appSecret 后更新配置token_missing / unauthorized原因：Control UI 没带 gateway token。 处理：
Control UI settings 填写 gateway.auth.tokenduplicate plugin id detected原因：同一插件被重复加载（常见于 feishu 插件有两份）。 处理：
openclaw agent 提示 Pass --to / --session-id / --agent原因：命令需要指定目标会话或 agent。 处理示例：
openclaw agent --agent main --message "只回复 OK" --json --timeout 60
这套方案适合'本地可控、快速上线'的 AI Agent 场景：
建议上线后做两件事：
tmux 持久化运行会话，避免 SSH 断开中断任务openclaw security audit --deep 做安全巡检
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online