OpenClaw + Ollama 开发者分享文档

OpenClaw Ollama 开发者分享文档文档结构章节内容1分享定位与时长2AI Agent 概念、组成、风险3OpenClaw 架构与适用场景4安装、初始化、配置、模型、记忆、基础使用5OpenClaw vs Cursor边界与选型全文只在此处展开6OpenClaw 差异化场景 Agent 能力示例79Ollama 介绍、安装、接入 OpenClaw10Ollama 与云端 API 对比11演示设计12开场白13QA 与一页总结14分享结尾1. 分享会定位1.1 分享主题OpenClaw Ollama 开发者实践从 AI Agent 架构到本地模型辅助开发1.2 听众与分享目标听众画像前端 / 全栈开发者已有 Cursor 或 Copilot 使用经验想了解 Agent 架构、本地模型和可自部署助手。本次分享主要解决八个问题AI Agent 是什么和「单次问答 / 补全」有什么本质区别。OpenClaw 的架构是什么开发者能扩展哪些能力Skills、Tools、MCP、模型路由。OpenClaw 怎么安装、初始化怎么配默认模型、理解 Memory。Cursor 已能 plan execute 的前提下OpenClaw 还剩哪些独特价值。两者边界在哪里——运行形态、扩展方式、部署位置详见第 5 章。Ollama 是什么本地跑模型的硬件门槛和选型建议。Ollama 如何一键接入OpenClaw原生集成无需 OpenAI 兼容配置。本地 Ollama 与云端 API 在开发场景下的取舍。1.3 分享建议时长建议总时长60 到 75 分钟。环节时间对应章节开场5 分钟§12AI Agent 是什么8 分钟§2OpenClaw 是什么8 分钟§3安装和使用12 分钟§4含配置、模型、MemoryOpenClaw vs Cursor10 分钟§5差异化场景与示例10 分钟§6Ollama 介绍与安装10 分钟§78Ollama 接入 OpenClaw5 分钟§9Ollama vs 云端 API5 分钟§10QA5 分钟§132. AI Agent 是什么2.1 一句话介绍AI Agent 是「能围绕目标自主完成任务的 AI 系统」理解目标 → 规划步骤 → 调用工具 → 观察结果 → 迭代而不只是生成一段文字。前提Cursor 的 Agent / Plan 模式在 IDE 内已能完成这条链路。OpenClaw 与 Cursor 的差异不在「会不会 plan execute」而在运行形态——详见第 5 章此处只讲 Agent 本身。2.2 典型工作流程用户提出目标 → 理解目标 → 拆解任务 → 调用模型和工具 → 执行动作 → 观察结果 → 返回或继续执行是否否是用户提出目标AI Agent 接收任务Prompt 定义角色、目标和边界LLM 理解、推理和决策Planning 拆解任务步骤是否需要调用工具Tools 查询数据、调用接口、执行命令Execution 执行动作直接生成结果Feedback Loop 观察执行结果结果是否满足目标返回结果给用户Memory 保存偏好、历史和上下文Permission Control 控制访问和执行权限示例「头像上传返回 413帮我排查并给修复方案」——Agent 会读UploadAvatar.vue、grep upload 配置、对比接口 size limit、产出 patch而不是只解释 HTTP 413 含义。2.3 组成部分与协作示例组成部分作用大模型LLM理解、推理、生成、决策提示词Prompt定义角色、边界、输出格式工具Tools读文件、调 API、执行命令记忆Memory保存偏好、历史、项目上下文规划Planning把复杂目标拆成可执行步骤执行Execution按计划调用工具完成动作反馈Feedback Loop观察结果决定是否继续调整权限Permission Control限制访问范围避免越权以「用户列表白屏TypeError: undefined」为例Prompt 加载调试规则 → Memory 补充 Vue3Pinia 约定 → LLMPlanning 定计划 → Tools 读 UserList.vue、grep user.profile → Feedback 单测仍红、补判空 → Permission 禁止触达 .env → 输出根因 补丁2.4 价值与风险开发者视角价值多步骤自动化、接入工程工具、Skill 沉淀团队规范、配合 Ollama 本地部署。风险权限越界、错误执行、敏感数据泄露、结果不可控、缺少审计日志。原则默认只读 → 写操作须确认 → 最小权限 → 保留 tool call 日志。3. OpenClaw 是什么3.1 一句话介绍OpenClaw 是开源 AI Agent 运行时提供模型路由、工具调用、Skills 扩展、Memory 与权限沙箱把 AI 接到 CLI、消息 Bot 或团队工作流——不是 ChatGPT 套壳。模型路由在多个 Provider / 模型间按规则调度主模型、fallback、按通道切换。例如日常走 Ollama 7B复杂任务切云端主模型 429 时自动降级。3.2 架构三层入口层CLI、消息 Bot、工作空间 能力层模型路由、Tools、Skills/MCP、Memory、权限沙箱 扩展层自定义 Skill、脚本、内部 API、Ollama / 云端模型3.3 核心特征开源可 fork学习 Agent Runtime、Tool 注册、Skill 加载。工具调用读文件、跑 shell、调 HTTP。Skills 可扩展联调 checklist、CR 模板等可复用。模型可替换Ollama 本地 ↔ 云端 API同一套 Agent 配置。可自部署代码与推理可不出内网。3.4 适用场景适合不适合IDE 外CI、Slack/飞书 Bot、内网 daemon替代 Cursor 做 IDE 内日常编码Ollama 离线、代码不出网未经审计直接改生产 / 部署Skill 沉淀、Agent 架构学习一上来接高权限生产库4. OpenClaw 安装和使用4.1 安装前准备Node.js 24最低 22.16、npm/pnpm/bun、Git源码时模型Ollama 或云端 API KeyWindows 建议 WSL2命令以 OpenClaw 官方文档 为准4.2 WSL2Windows 用户wsl--install# 管理员 PowerShell重启后 wsl -l -v 确认版本为 24.3 安装npminstall-gopenclawlatest openclaw--version源码git clone https://github.com/openclaw/openclaw.git4.4 初始化openclaw onboard# 交互引导openclaw onboard --install-daemon# 安装后台守护进程provider 列表选Ollama可一键接入本地模型自动发现、auto-pull云端 API 则选对应 provider 填 Key。还会配置工作区、入口、技能、权限范围。4.5 升级与卸载npminstall-gopenclawlatest# 升级npmuninstall-gopenclaw# 卸载先停 daemon4.6 开发者路径安装 → onboard → 配置模型 → CLI 发任务 → 观察 tool call → 扩展 Skill三个 checkpoint①openclaw --version② 模型连通 ③ 完成一个只读任务如 CR 清单。习惯建议描述带上技术栈和输出格式改代码前先只要方案本地试验优先 Ollama。4.7 配置文件概览OpenClaw 的配置集中在JSON5文件默认路径~/.openclaw/openclaw.json # 主配置模型、通道、技能、Memory 等 ~/.openclaw/workspace/ # Agent 工作区Memory 文件、知识文档等三种修改方式推荐优先用 CLI / 向导避免手写出错方式命令 / 入口适合交互向导openclaw onboard/openclaw configure首次安装、改模型/通道CLI 读写openclaw config get/set/unset改单个字段、脚本自动化Control UIopenclaw dashboard→ 浏览器 Config 标签可视化表单 Raw JSONControl UI 默认地址http://127.0.0.1:18789端口以gateway.controlUi.port为准。常用配置片段示例Ollama 本地 降级链{ agents: { defaults: { workspace: ~/.openclaw/workspace, model: { primary: ollama/qwen2.5-coder:7b, fallbacks: [anthropic/claude-sonnet-4-6], // 主模型失败时尝试 }, models: { ollama/qwen2.5-coder:7b: { alias: local }, anthropic/claude-sonnet-4-6: { alias: cloud }, }, }, }, }模型引用格式provider/model如ollama/qwen2.5-coder:7b。改agents.defaults.model后通常需重启 gatewayMemory 相关字段部分支持热更新。配置变更后建议openclaw doctor# 检查配置是否合法openclaw doctor--fix# 升级后修复过时字段openclaw config get agents.defaults.model.primary# 确认生效值4.8 模型设置默认与切换模型选择优先级简化当前会话 /model 选择 → agents.defaults.model.primary → fallbacks 链 → Provider 内 auth 轮换设置默认模型CLI改全局默认写入 openclaw.jsonopenclaw models list# 看已配置/可用模型openclaw models list--providerollama# 只看 Ollamaopenclaw models status# 当前 primary、fallbacks、鉴权状态openclaw models status--probe# 探测各 Provider 是否连通openclaw modelssetollama/qwen2.5-coder:7b# 设默认模型openclaw models fallbacksaddanthropic/claude-sonnet-4-6 openclaw models aliasesaddlocalollama/qwen2.5-coder:7b配置文件openclaw configsetagents.defaults.model.primaryollama/qwen2.5-coder:7b--strict-jsonControl UIopenclaw dashboard→ Config →agents.defaults.model→ 设置primary/fallbacks。会话内临时切换不改全局默认在 CLI TUI、Telegram、Discord 等对话里/model # 弹出编号选择器 /model list # 列出可选模型 /model 2 # 选第 2 个 /model ollama/qwen2.5-coder:7b /model status # 看当前会话用的模型与鉴权/model只影响当前会话新会话仍用agents.defaults.model.primary。用户用/model指定的模型若不可用会直接报错不会静默 fallback与全局默认行为不同。交互式分段配置openclaw configure--sectionmodel# 只跑模型相关向导openclaw configure--sectionchannels# 只配消息通道4.9 记忆Memory原理Memory ≠ 聊天记录缓存也 ≠ RAG 知识库Knowledge Skill 是另一条线。Memory 是Agent 主动写入工作区的 Markdown 笔记下次对话再检索注入。核心原理模型本身无持久记忆 → OpenClaw 把「值得记住的」写到磁盘 Markdown → 新会话 bootstrap 加载摘要 → memory_search 语义检索历史笔记 → 注入 promptAgent 只「记得」写进文件的内容没有隐藏状态。文件结构默认在 workspace 内文件作用何时加载MEMORY.md长期记忆偏好、规范、 durable 决策每次私聊会话开始时注入memory/YYYY-MM-DD.md日志层当天观察、联调结论、临时上下文今天昨天自动加载全文可被检索DREAMS.md可选后台整理dreaming的人类可读摘要人工 review非每轮注入怎么写入直接告诉 Agent——「记住我偏好 TypeScript」「记住这个项目用 Vue3Pinia」——它会写到合适文件。Compaction上下文压缩前还会自动memory flush把对话里尚未落盘的重要信息写入memory/*.md。Memory 工具Agent 运行时调用工具作用memory_search语义 关键词混合检索找相关笔记即使用词不同memory_get读取指定 memory 文件或行范围CLI 等价操作openclaw memory status openclaw memory search联调 头像上传openclaw memory index--force# 重建索引检索Embedding配置默认用云端 embedding本地/Ollama 场景可在openclaw.json配置{ agents: { defaults: { memorySearch: { provider: ollama, // 或 local、openai、gemini 等 model: qwen3-embedding:0.6b, enabled: true, }, }, }, }配合 Ollama 全离线时对话模型和embedding 模型可分别指定例如 7B coder 对话 小 embedding 模型检索。Memory vs 其他概念Memory对话上下文Knowledge SkillRAG存什么Agent 总结的偏好/笔记当前 thread 消息预先放入的文档库谁写入Agent / memory flush用户Agent 每轮对话开发者丢文件到 knowledge/典型用途「记住我用 pnpm」当前任务连贯性「查团队规范 PDF」进阶 bundledmemory-wiki插件可把 Memory 整理成带溯源的 wikiHoncho、LanceDB 等为可选后端插件。4.10 常用命令速查# ── 生命周期 ──openclaw onboard --install-daemon openclaw configure openclaw dashboard# 打开 Control UIopenclaw doctor--fix# ── Gateway ──openclaw gateway status|restart openclaw agent--message你好# 直接跑一轮 Agent# ── 配置 ──openclaw config get agents.defaults.model.primary openclaw configsetgateway.bindloopback--strict-json# ── 模型 ──openclaw modelssetollama/qwen2.5-coder:7b openclaw models fallbacks list# ── Memory ──openclaw memory status openclaw memory search部署 checklist# ── 通道Bot ──openclaw channels list openclaw channelsadd--channeltelegram openclaw configure--sectionchannels对话内常用 slash 命令/model、/model status、/reset清会话、/context list看注入上下文大小。5. OpenClaw 和 Cursor 对比全文唯一展开 Cursor 对比的章节。其他章节仅引用结论。5.1 一句话Cursor IDE 内 Agentplan execute 代码任务日常编码首选。OpenClaw IDE外的开源 Agent 运行时——Bot、CI、Ollama 离线、可 fork。5.2 对比表维度CursorOpenClaw运行位置IDE 内CLI、daemon、Bot、自部署IDE 内 plan execute✅ 成熟—CI / Slack / 内网 daemon❌✅开源 fork Runtime❌✅Ollama 完全离线部分✅ 运行时级团队 Skill 挂 Bot❌✅模型路由 / 多 Provider有限✅上手成本装 IDE 即用需安装配置5.3 选型决策任务推荐IDE 内写组件、改 bug、重构、排查Cursor AgentCI 日志分析、Slack Bot、内网 daemonOpenClaw代码不能出网OpenClaw Ollama学习 / fork Agent RuntimeOpenClaw 源码团队 Skill不依赖每人开 IDEOpenClaw Skill Bot组合用法Cursor — 日常编码plan execute OpenClaw — IDE 外 Bot / CI / Skill 基础设施 Ollama — 本地模型配合 OpenClaw 离线跑 云端 API — 复杂推理Cursor 或 OpenClaw 均可接编码用 Cursor 就够了要把 Agent 部署到 IDE 之外再看 OpenClaw。6. 差异化场景与 Agent 能力示例6.1 OpenClaw 真正差异化的场景场景说明CI 日志分析pipeline 失败自动输出排查步骤Slack / 飞书 BotBot 获取 PR checklist无需每人开 IDE内网 / 离线机Ollama OpenClaw代码与推理不出网团队 Skill统一规范沉淀为多入口能力Skill 示例# frontend-pr-checklist 当用户说「PR 检查」→ 询问 Vue/React → 输出 a11y/性能/类型 checklist 表格新人在 Slack Bot 即可得到团队统一输出——IDE 产品难以直接提供这种部署形态。6.2 Agent 能力示例Cursor 同样擅长以下示例用于理解 Agent 能力模型。Cursor Agent 在 IDE 内已能 plan execute不必为此专门装 OpenClaw。场景示例 prompt典型输出需求拆解头像上传预览、裁剪、重试 → 拆任务 待确认项组件拆分、接口字段、测试点组件设计UploadAvatarVue3TS → 设计 props/emits职责边界、状态结构CSS 排查flex 右侧撑破容器 → 给方案min-width: 0等联调辅助后端 JSON → 设计 TS 类型interface、空值策略CR 清单Vue3TSVite 评审清单性能、a11y、边界状态线上排查Bot/CLI白屏 source map 指向某行 → 只输出排查步骤grep 关键词、文件路径分享建议6.2 可快速带过重点演示 6.1 的 IDE 外场景。7. Ollama 是什么Ollama 是在本机下载、运行开源大模型的工具默认服务地址http://127.0.0.1:11434。价值不依赖云端 API适合学习、演示、隐私敏感和内网开发。7.1 核心能力本地推理数据默认不出本机ollama pull / run / list管理模型原生 API/api/chat——OpenClaw 直接集成支持 streaming tool calling推荐代码模型qwen2.5-coder:7b7.2 硬件要求简表规模用途建议内存说明3B7B演示、轻量代码辅助16GB分享推荐均衡14B复杂分析24GB笔记本可能变慢30B强推理32GB工作站级磁盘预留 2050GB有 NVIDIA GPU 明显加速分享演示16GB 内存 7B 模型即可8. Ollama 安装与使用# 安装macOS/Linuxcurl-fsSLhttps://ollama.com/install.sh|sh# Windows https://ollama.com 下载安装包ollama--versioncurlhttp://127.0.0.1:11434/api/tags# 确认服务在跑ollama pull qwen2.5-coder:7b ollama run qwen2.5-coder:7b ollama list/v1OpenAI 兼容接口供其他第三方工具使用OpenClaw 不走此路径见 §9.3。9. Ollama 接入 OpenClawOpenClaw原生支持Ollama无需手动填 OpenAI Compatible //v1/ 假 API Key。9.1 一键接入方式 A推荐openclaw onboard# → 选 Ollama → Local only → 选模型自动发现、auto-pullopenclaw models list--providerollama# 验证方式 BOllama 0.17ollama launch openclaw--modelqwen2.5-coder:7b方式 CCI / 非交互openclaw onboard --non-interactive\--auth-choice ollama\--custom-model-idqwen2.5-coder:7b\--accept-risk9.2 接入前检查ollama--versionollama listcurlhttp://127.0.0.1:11434/api/tags9.3 为何不用 OpenAI Compatible/v1原生接入推荐/v1兼容模式不推荐配置onboard 或ollama launch openclaw手动 Base URL KeyTool calling✅ 可靠❌ 不可靠模型发现✅ auto-pull手填模型名9.4 好处与限制好处零 API 成本、数据不出网、tool calling 稳定、auto-pull 省心。限制7B 能力弱于顶级云端模型速度受硬件影响复杂推理可能不稳定。10. Ollama 与云端 API 对比维度Ollama 本地云端 API数据留本机发外部成本耗硬件按 token 计费效果取决于模型硬件通常更强隐私✅ 敏感代码友好需评估合规适合试验、离线、OpenClaw 原型复杂推理、对外 demo日常编码 → Cursor Agent IDE 外 / 离线 / Bot → OpenClaw Ollama 复杂方案 / 高 SLA → 云端 API11. 分享演示设计#内容要点1对齐认知「Cursor Agent 修 bug plan execute今天讲 IDE 外怎么跑」2OpenClaw 差异化CLI checklist / Skill 结构 / Bot 场景不和 Cursor 同题 PK3Ollama 本地模型ollama run qwen2.5-coder:7b CSS 问题4一键接入openclaw onboard选 Ollama或ollama launch openclaw5配置演示可选openclaw models status/model切换openclaw memory search注意提前装好、拉好 7B 模型每个 demo 35 分钟准备截图 fallback勿展示真实 Key。12. 分享开场白大家好今天聊OpenClaw Ollama。先对齐Cursor Agent 在 IDE 里已经能 plan execute——这很好日常编码继续用它。OpenClaw 讲四件事Agent 架构、IDE 之外CLI/Bot/CI、本地模型Ollama、配置与 Memory默认模型、持久记忆。分享结束后请思考什么情况下才值得上 OpenClaw默认模型和 Memory 怎么配Bot/Skill 权限怎么控13. QA 与一页总结常见问题QOpenClaw 能替代 Cursor 吗不能也不必要。Cursor 做 IDE 内编码OpenClaw 做 Bot、CI、内网、Ollama 离线。Q已有 Cursor还需要 OpenClaw 吗日常写代码 ❌代码不出网 / 做 Bot / CI 分析 / 学 Runtime ✅。QOllama 怎么接 OpenClawopenclaw onboard选 Ollama或ollama launch openclaw --model 名。不需要 OpenAI Compatible。QOllama vs 云端试验、隐私、离线 → Ollama复杂推理、高 SLA → 云端。Q默认模型怎么设全局openclaw models set ollama/qwen2.5-coder:7b或 Control UI Config。会话内/model ollama/qwen2.5-coder:7b仅当前会话。QMemory 是什么Agent 把偏好/结论写入 workspace 的MEMORY.md和memory/YYYY-MM-DD.md通过memory_search检索不是聊天自动缓存。说「记住 xxx」即可写入。Q试用第一步前提编码已有 Cursor。若有 IDE 外需求 → 安装 OpenClaw → onboard 选 Ollama → 试 Skill/Bot。一页总结概念一句话AI Agentplan 工具 迭代Cursor IDE 内已是 AgentCursorIDE 内 Agent日常编码首选OpenClawIDE 外运行时Bot、CI、Ollama、开源Ollama本机模型onboard一键原生接入MemoryMarkdown 落盘 检索MEMORY.md长期、memory/*.md日志默认模型openclaw models set provider/model或/model模型路由多模型/Provider 间自动调度与 fallbackIDE 内编码 → Cursor Agent IDE 外 / 离线 → OpenClaw Ollama 学 Agent 架构 → OpenClaw 源码Cursor 把 Agent 做进了 IDEOpenClaw 让你把 Agent部署到 IDE 之外——互补非替代。14. 分享结尾Cursor继续担任 IDE 内编码首选。OpenClaw适合 Agent 架构学习、IDE 外部署、Ollama 离线、fork Runtime。务实路径编码 → CursorIDE 外基础设施 → OpenClaw Ollama。