在完成了 OpenClaw(小龙虾)的本地部署后,系统已经"能启动、能对话"。
接下来的关键不是继续折腾安装,而是把它从"会聊天"升级到"会干活":
- 能查:检索类 Skills(联网查证、补全最新信息)
- 能记:记忆类 Skills(沉淀你自己的知识库)
- 能跑:自动化类 Skills(定时和流程执行)
- 能连:多平台接入类 Skills(一个助手多处可用)
本文是承上启下的详细版,重点讲 本地部署场景 下,如何稳妥安装并用起来这四类能力。
1. 本地部署后的核心思路:先"稳定",再"扩展"
很多人安装完马上连装一堆 Skills,结果经常遇到:权限冲突、端口占用、配置项忘填、日志里全是报错。
正确做法是先建立"最小可用基线",再逐步扩展。
1.1 最小可用基线(建议先检查)
- OpenClaw 主服务能稳定启动(重启后可恢复)
- 模型 API 可用(至少 1 个可调用模型)
- 控制台可访问(本地 Web 管理页正常)
- 日志可查看(知道在哪看报错)
- 机器休眠策略可控(避免定时任务被系统睡眠打断)
1.2 本地环境建议(Windows)
- Node 与依赖版本固定,不频繁升降级
- API Key 统一放在本地安全配置中,不写死在脚本里
- 给 OpenClaw 单独目录,避免和其他项目混装依赖
- 如需长期运行,建议配合系统开机启动或守护工具
2. Skills 安装总流程(本地通用)
不同版本入口名字可能不同,但流程几乎一致,可以按这个"统一模板"操作:
- 发现技能:在 Skills 市场/列表搜索关键词(search、memory、automation、channel)
- 安装技能:点击安装,或通过 CLI 安装
- 配置鉴权:填 API Key / Token / App Secret
- 配置参数:模型、超时、重试、白名单、索引路径等
- 启用开关:确认 Skill 为 Enabled
- 小样本验证:先跑 1 条最小任务
- 观察日志:看是否有鉴权、配额、限流、超时错误
建议遵循"一次只装一个 Skill"的节奏。每装完一个先验证,再装下一个,排错成本最低。
3. 推荐安装顺序(本地部署优先级)
如果你希望尽快看到效果,建议这个顺序:
- 检索类(最快见效)
- 记忆类(让回答越来越贴近你)
- 自动化类(释放重复劳动)
- 多平台接入类(扩大使用场景)
这样做的好处是:你前两步就能获得"信息准确 + 内容贴身",后三步再做规模化和自动化。
4. 四类热门能力详细介绍(安装、配置、使用、验收)
4.1 检索能力(Web Search / Retrieval)
适合场景
- 查最新政策、版本更新、竞品动态
- 生成"有来源"的回答
- 减少模型幻觉
安装与配置要点
- 安装检索类 Skill(名字可能是 search、web-search、retrieval)
- 配置搜索 API Key(或第三方检索服务授权)
- 设置请求超时、并发数、结果条数
- 如支持来源过滤,配置优先域名(例如官方文档域名)
建议参数(通用)
- 每次检索结果数:5 到 10
- 超时:10 到 20 秒
- 重试:1 到 2 次
- 输出要求:必须附来源链接
对话触发模板
- "请检索
关键词,给我 5 条最新信息,按时间倒序,附链接。" - "只引用官方来源(官网/文档),不要论坛二手转载。"
- "把检索结果整理成:结论、依据、风险、待确认事项。"
验收标准
- 回答里有明确来源链接
- 链接可打开,信息时间较新
- 遇到查不到时会明确说"不确定",而不是编造
常见问题
- 无结果:关键词太窄,先扩大后再收敛
- 报鉴权错:Key 错误、权限不足、余额/配额不足
- 速度慢:降低结果条数,缩短检索范围
4.2 记忆能力(Vector Memory / RAG)
适合场景
- 产品文档问答
- 内部术语解释
- 项目历史决策复盘
- 固化你的写作风格和规则
安装与配置要点
- 安装记忆类 Skill(vector、memory、rag、knowledge)
- 配置数据目录或知识库入口
- 上传文档并建立索引(分片、嵌入、重排)
- 设置召回条数和相似度阈值
- 开启"回答引用片段"功能(如支持)
本地数据组织建议
- 按主题分库:
产品、运营、技术、会议纪要 - 文件命名统一:
日期-主题-版本.md/pdf - 重要文档加版本标记,避免旧内容误召回
对话触发模板
- "基于我的知识库,解释
某概念,并引用具体片段。" - "只使用我上传的文档回答,不做外部推测。"
- "从
项目A知识库里,给出该问题的标准处理流程。"
验收标准
- 回答引用了你上传内容,而非泛泛而谈
- 引用片段和结论一致
- 更新文档后,重新索引可以生效
常见问题
- 回答不准:索引未完成,或问题描述不具体
- 回答太旧:文档已更新但未重建索引
- 不会引用:未开启"引用返回"或召回参数过低
4.3 自动化能力(Scheduler / Automation / Workflow)
适合场景
- 每日/每周自动摘要
- 定时监控并告警
- 固定模板输出(日报、周报、舆情快照)
- 多步骤流程:采集 -> 汇总 -> 生成 -> 推送
安装与配置要点
- 安装自动化/调度类 Skill(scheduler、cron、workflow)
- 配置执行计划(Cron 或自然语言时间)
- 配置任务输入(检索关键词、数据源、知识库)
- 配置任务输出(控制台、文件、消息通道)
- 设置失败重试和告警策略
本地运行注意事项
- 电脑休眠会中断定时任务
- 任务依赖网络,断网会失败
- 建议给关键任务设置"失败通知"
对话触发模板
- "每天 18:00 生成一份行业动态摘要,分 3 段输出:变化、影响、建议。"
- "每周一 9:00 自动汇总上周项目进度,输出 Markdown 周报。"
- "当检索到
关键词新增重大变化时,立即发送提醒。"
验收标准
- 到点自动执行
- 失败后可重试并有记录
- 输出格式稳定,便于复用
常见问题
- 不触发:时区或 Cron 表达式配置错误
- 触发但无结果:上游检索或记忆链路失败
- 结果混乱:模板未固定,提示词不够结构化
4.4 多平台接入能力(Channel Integration)
适合场景
- 你在多个工具里都想用同一个助手
- 团队协作需要在飞书/企微里直接调用
- 移动端和桌面端都要可用
安装与配置要点
- 安装渠道/连接器类 Skill(channel、connector、integration)
- 在目标平台创建机器人应用
- 填写 App ID、Secret、Token、回调地址等参数
- 配置权限范围(消息读取、发送、文件等)
- 进行一次回调验证与消息自测
接入策略建议
- 先接一个主渠道(例如 Web 或飞书),跑通后再扩展
- 不同渠道设置不同"角色提示词",避免输出风格混乱
- 关键操作开启确认机制(避免误触发自动执行)
对话触发模板
- "把这条分析结果推送到
渠道A的群组B。" - "收到
关键词询问时,按 FAQ 模板回复并附文档链接。"
验收标准
- 消息双向收发稳定
- 回调验证通过且日志无明显错误
- 多渠道之间上下文策略清晰(必要时分会话)
常见问题
- 能收不能发:发送权限未开通
- 回调失败:公网映射或签名校验问题
- 延迟高:平台限流或网络波动
5. 本地部署的"最小可用组合"(建议直接照做)
如果你希望尽快落地,建议先做这套 3 步:
-
检索 Skill + 来源强制输出
让回答先可信。
-
记忆 Skill + 一个知识库主题
先导入最常用 10 到 20 份文档,不追求一步到位。
-
每日自动摘要任务
每天固定时间生成一份摘要并保存,形成可复用产出。
跑通这三步后,再扩展多平台接入,整体成功率会更高。
6. 通用排查手册(本地版)
遇到问题时按这个顺序排查,通常最快:
- 看服务是否在线(主服务、模型服务、网络)
- 看 Skill 是否启用(开关状态)
- 看鉴权是否有效(Key、Token、配额)
- 看日志关键词(timeout、unauthorized、rate limit)
- 用最小输入重测(缩短提示词、减少步骤)
三个高频报错思路
- Unauthorized / 401:凭据错或权限不足
- Timeout:网络慢、并发高、超时太短
- Rate Limit:配额触顶,需降频或升级套餐
7. 你可以直接套用的提示词模板
检索模板
"请检索 主题 的最近 7 天更新,输出:
1)3 条关键变化;2)每条的来源链接;3)对我当前项目的影响建议。"
记忆模板
"仅基于我的知识库回答 问题。
如果资料不足请明确指出,并给出还需要补充的文档清单。"
自动化模板
"把 任务主题 设为每天 18:00 自动执行,输出 Markdown,保存到 本地目录,失败后重试 1 次并记录日志。"
多平台模板
"将这次结果同步到 平台/群组,格式为:标题、三条要点、后续动作。"
8. 最后建议:本地用户的升级路线
你现在是本地部署场景,最稳的升级路线是:
第 1 周 :检索跑通,保证"有来源"
第 2 周 :记忆跑通,保证"懂你的资料"
第 3 周 :自动化跑通,保证"定时产出"
第 4 周:多平台接入,保证"随处可用"
这样推进,几乎每周都能看到明确收益,而且不会因为一次性改动太多导致系统不稳定。
附录:Windows PowerShell 命令行实操清单
下面是一份偏"工程化"的命令行操作清单,假设你已经按官方教程在本地成功安装并能启动 OpenClaw(小龙虾)。
命令里的名字如 <skill-name>、<your-api-key> 请按你实际的版本与界面替换。
所有命令都建议在 Windows PowerShell(非 CMD) 中执行,必要时使用"以管理员身份运行"。
A. 基础:确认服务与 CLI 可用
powershell
# 1. 查看当前 Node / npm 版本(可选)
node -v
npm -v
# 2. 查看 openclaw CLI 是否可用
openclaw --version
# 如果提示未找到命令,回到安装教程确认环境变量或重装 CLI
如果你是通过一键脚本安装,本地 CLI 可能安装在用户目录下,确保该路径已加入 PATH。
B. 检索能力:安装与验证(示例命令)
B.1 安装检索类 Skill
powershell
# 搜索包含 "search" 关键字的 Skills
openclaw skills search search
# 示例:安装一个名为 web-search 的检索类 Skill
openclaw skills install web-search
实际环境中,请用
openclaw skills search查到的真实 Skill 名字替换web-search。
B.2 配置检索类 Skill 的 API Key(示意)
具体命令取决于版本,这里给一个通用思路:
powershell
# 打开 Skill 的配置(有的版本支持 CLI 编辑,有的需要 Web 控制台)
openclaw skills config web-search
# 若 CLI 不支持,改为:
# 1. 浏览器打开本地控制台,例如 http://127.0.0.1:18789
# 2. 找到 Skills -> web-search -> Settings
# 3. 填写 API Key / Token(如某搜索服务的密钥)
B.3 命令行触发一次检索任务(如版本支持)
powershell
# 示例:从命令行直接发起一次检索任务
openclaw run skill web-search --query "OpenClaw 最新版本变化" --limit 5
# 预期:
# - 控制台返回包含标题、简介、链接的结果
# - 日志中看到调用成功且无鉴权错误
C. 记忆能力:本地知识库 + 向量索引
C.1 安装记忆类 Skill
powershell
# 搜索包含 "memory" 或 "vector" 的 Skills
openclaw skills search memory
openclaw skills search vector
# 示例:安装一个名为 local-memory 的记忆类 Skill
openclaw skills install local-memory
C.2 准备本地知识库目录
powershell
# 在用户目录下创建一个知识库文件夹
New-Item -ItemType Directory -Path "$env:USERPROFILE\openclaw-kb" -Force
# 把你的文档放进去(支持的类型以官方文档为准,如 .md/.pdf/.docx)
# 示例:复制一个产品说明到该目录
Copy-Item "D:\docs\产品说明书-v1.0.pdf" "$env:USERPROFILE\openclaw-kb\产品说明书-v1.0.pdf"
C.3 配置记忆 Skill 指向该目录
powershell
# 同样分 CLI 或 Web 控制台两种方式:
openclaw skills config local-memory
# 在配置中填入:
# - 数据目录:C:\Users\<你的用户名>\openclaw-kb
# - 是否自动监听文件变化:按需开启/关闭
C.4 触发索引构建(如版本支持命令)
powershell
# 对指定知识库目录执行索引任务
openclaw skills run local-memory --action index --path "$env:USERPROFILE\openclaw-kb"
# 观察输出,确认每个文件都完成了分片和嵌入
D. 自动化能力:配置定时任务
D.1 安装自动化 / 调度类 Skill
powershell
# 搜索包含 scheduler/cron/workflow 的 Skills
openclaw skills search scheduler
openclaw skills search cron
# 示例:安装 cron-scheduler Skill
openclaw skills install cron-scheduler
D.2 在命令行创建一个"每日摘要"任务(示例)
假设你的版本支持通过 CLI 新建任务,可以按类似结构:
powershell
# 新建一个名为 daily-summary 的任务
openclaw tasks create daily-summary `
--schedule "0 18 * * *" `
--skill web-search `
--params '{"query":"行业动态","limit":5}' `
--output "file" `
--output-path "$env:USERPROFILE\openclaw-outputs\daily-summary.md"
# 说明:
# - schedule 使用 Cron 表达式:每天 18:00
# - skill 为上面安装的检索类 Skill 名
# - params 为 JSON 字符串,按 Skill 文档要求编写
如果当前版本的 CLI 不支持这么完整的
tasks create命令,就改在 Web 控制台里的"Automation / Workflows / Tasks"页面按同样思路配置。
D.3 测试任务是否可手动触发
powershell
# 手动执行一次 daily-summary 任务
openclaw tasks run daily-summary
# 然后检查输出目录:
Get-Content "$env:USERPROFILE\openclaw-outputs\daily-summary.md"
E. 多平台接入:以"飞书"为例(流程示意)
这一部分更多是"命令 + 操作流程"的组合,真正的 App ID/Secret 需要你在飞书后台创建应用后获取。
E.1 安装飞书渠道 Skill
powershell
# 搜索包含 lark/feishu 的 Skills
openclaw skills search lark
openclaw skills search feishu
# 示例:安装 feishu-channel Skill
openclaw skills install feishu-channel
E.2 在飞书开发者平台创建机器人应用
- 浏览器打开飞书开放平台
- 创建"企业自建应用"或"机器人"
- 在应用详情页找到:
- App ID / App Secret
- 事件订阅地址(Callback URL)
- 需要勾选的权限(读取消息、发送消息等)
E.3 在命令行或 Web 控制台中配置飞书渠道
powershell
# 如果 CLI 支持渠道配置:
openclaw skills config feishu-channel
# 在交互配置过程中填入:
# - App ID
# - App Secret
# - 验证 Token(如飞书要求)
# - 加密密钥(如开启了加密)
# - 回调地址(一般为你的本地服务外网映射地址)
如需本地暴露服务给飞书访问,你可能还需要一个内网穿透工具(如 frp、ngrok 等),这部分按各自文档配置。
E.4 验证消息收发
- 在飞书应用管理后台,使用"测试消息"功能发送一条文本
- 观察 OpenClaw 日志中是否有对应事件
- 尝试在飞书群里 @ 机器人,发出一个简单指令(如"你好")
- 确认机器人可以正常回复
F. 日常维护:常用命令速查(PowerShell)
powershell
# 查看已安装的所有 Skills
openclaw skills list
# 查看某个 Skill 的详细信息
openclaw skills info web-search
# 禁用 / 启用某个 Skill
openclaw skills disable web-search
openclaw skills enable web-search
# 查看当前所有自动化任务
openclaw tasks list
# 查看某个任务的最近执行日志(如果支持)
openclaw tasks logs daily-summary --tail 100
建议把你常用的命令整理成一个
openclaw-cheatsheet.ps1或.md文件,长期自己维护,方便团队其他人直接复用你的本地配置经验。