OpenClaw_学习笔记

此文档来源于B站"编程不良人"博主的视频资料汇总，发布此平台的目的主要是为个人笔记所用。

1 安装相关

更改windows默认脚本策略

cmd 复制代码

# 查询
 Get-ExecutionPolicy
# 更改
Set-ExecutionPolicy RemoteSigned

安装命令

cmd 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

验证

cmd 复制代码

openclaw --version

完整向导会引导 你选择模型提供商、设置 API key，并配置 Gateway 网关、安装定时任务。整个过程大约需要 2 分钟。记住要开科学上网和终端代理

cmd 复制代码

openclaw onboard --install-daemon
# channel可以先跳过，后续接入飞书
# web search 可以注册个 Tavily Search 来接入，也可以先跳过

启动网关

复制代码

openclaw gateway run

验证 Gateway 网关正在运行

cmd 复制代码

openclaw gateway status

打开仪表板

cmd 复制代码

openclaw dashboard

常用命令

cmd 复制代码

openclaw chat           # 打开终端聊天界面
openclaw configure 		# 配置
openclaw update 		# 升级版本

2 接入飞书

前往飞书开发者平台

复制代码

https://open.feishu.cn/app?lang=zh-CN

创建企业自建应用 -> 添加应用能力 -> 机器人 -> 左侧权限管理 -> 开通权限 -> 批量导入权限 -> 确认

复制代码

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

安装飞书插件

shell 复制代码

openclaw plugins search "feishu"
openclaw plugins install clawhub:@openclaw/feishu
openclaw gateway restart

飞书开放平台：凭证与基础信息 -> 获取App ID 和 App Secret，前往openclaw绑定飞书

shell 复制代码

openclaw configure
#  channel -> add or update  ->  Feishu/Lark -> Enter App ID and App secret manually -> Feishu -> group chat policy(个人电脑选择Disabled) -> 配置成功后重启gateway
openclaw gateway restart

飞书开放平台：事件与回调 -> 事件配置 -> 订阅方式 -> 长连接 -> 验证长连接成功 -> 保存

飞书开放平台：事件与回调-> 事件配置 -> 添加事件 -> im.chat(机器人进群、机器人退群) -> im.message(消息已读、消息撤回、接收消息) -> 版本管理与发布 -> 保存

飞书开放平台：事件与回调 -> 回调配置-> 订阅方式 -> 长连接 -> 验证长连接成功 -> 保存

飞书开放平台：事件与回调 -> 回调配置 -> 卡片回传交互

此时就可以在飞书平台和机器人发起对话了，第一次对话机器人会要求 OpenClaw 配置下密钥

复制代码

openclaw pairing approve feishu xxxxx
openclaw gateway restart

观察openclaw后台日志，可能会要求开启应用身份权限/用户身份权限（我们之前遗漏的权限），点击链接可打开飞书开放平台去开启。

成功实现飞书接入openclaw

3 开启web search

markdown 复制代码

# 注册 https://tavily.com 每月 1000 次免费搜索
openclaw configure --section web
# 选 provider: tavily
# 输入你的 TAVILY_API_KEY

4 目录说明

OpenClaw 在本地运行时，会在用户目录下生成一个工作目录，用于存储 Agent 、任务、设备、配置、日志等数据。

以下为典型目录说明：

shell 复制代码

PS C:\Users\25726\.openclaw> dir

    目录: C:\Users\25726\.openclaw

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----          2026/5/5     15:10                agents
d-----          2026/5/5     15:54                canvas
d-----         2026/5/12      1:23                devices
d-----          2026/5/5     15:54                identity
d-----          2026/5/5     15:10                logs
d-----          2026/5/5     14:27                plugins
d-----          2026/5/5     15:54                tasks
d-----         2026/5/12      0:01                tui
d-----          2026/5/5     15:10                workspace
-a----         2026/5/12      1:18            466 gateway.cmd
-a----         2026/5/12      1:18           1497 openclaw.json
-a----         2026/5/12      1:14           1337 openclaw.json.bak
-a----          2026/5/5     15:53            361 openclaw.json.bak.1
-a----          2026/5/5     15:10            251 openclaw.json.bak.2
-a----         2026/5/12      1:21           1497 openclaw.json.last-good
-a----         2026/5/12      1:21             49 update-check.json

目录/文件	类型	说明	典型内容/示例
openclaw.json	JSON配置文件	主配置文件，定义系统运行参数	模型配置、工具权限、Agent策略、插件启用
openclaw.json.bak.*	JSON备份文件	配置备份，可回滚	.bak,.bak1,.bak2
update-check.json	JSON文件	更新检查记录	最近检查时间、版本信息、是否有可用更新
agents	文件夹	存储 AI Agent 配置	agent.json、prompt.md、tools.json
memory	文件夹	存储 AI 长期记忆数据	用户偏好、历史任务、上下文信息
completions	文件夹	AI 历史生成记录	代码生成记录、对话输出、任务结果
cron	文件夹	定时任务配置	定时任务JSON，如每天 02:00 执行任务
delivery-queue	文件夹	任务队列	待执行任务，Agent 分发队列
devices	文件夹	存储连接设备信息	设备ID、连接状态、最后在线时间
credentials	文件夹	系统凭据	API token、OAuth信息、服务密钥
extensions	文件夹	插件扩展	GitHub、Docker、数据库插件等
feishu	文件夹	飞书集成配置	Wehook、机器人、组织应用配置
identity	文件夹	用户身份信息	用户ID、登录信息、Token
canvas	文件夹	AI交互画布数据	AI任务流程、生成内容、操作记录
logs	文件夹	系统运行日志	AI执行日志、系统错误、Agent状态
workspace	文件夹	默认工作目录	AI生成代码、项目文件、脚本执行

4.1 workspace 工作空间

文件/文件夹	类型	说明	内容概述
.git	文件夹	Git 仓库	存储版本控制信息
.openclaw	文件夹	OpenClaw 内部配置	存储 AI Agent、插件、工作数据的内部状态
USER.mAGENTS.md**	Markdown	Agent说明文档	记录所有 AI Agent 的定义、功能、用途
BOOTSTRAP.md	Markdown	启动指南	系统或 Agent 启动流程说明，快速上手文档
exports	文件夹	导出数据	存储用户或系统导出的结果文件，例如 AI输出、日志、配置
HEARTBEAT.md	Markdown	心跳机制说明	记录系统或 Agent 的在线状态、心跳机制与监控说明
IDENTITY.md	Markdown	用户身份说明	记录用户管理、身份信息、权限控制说明
SOUL.md	Markdown	AI 核心逻辑 / 灵魂	描述AI的核心思路、决策逻辑或推理流程
TOOLS.md	Markdown	工具说明	记录 OpenClaw 可用工具列表及用法，例如文件操作、Shell、数据库
USER.md	Markdown	用户使用指南	给用户的操作说明、常用指令、功能演示

4.2 SOUL.md --- 灵魂文件

SOUL.md 是助手的性格说明书，它决定了助手是谁、怎么说话、什么该做什么不该做

markdown 复制代码

# 你是[助手名字]

你是[助手名字]，[主人名字] 的 AI 私人助手。你的形象是[形象描述]。

## 性格
- [性格特点 1]
- [性格特点 2]
- [性格特点 3]
- [性格特点 4]

## 说话风格
- 简洁直接，不啰嗦
- 可以用 emoji，但克制
- 技术术语保留英文
- **重要信息用加粗标注**

## 行为准则
- 能帮忙做的事就直接做，不反复确认
- 不确定的事先问再做
- 涉及发送外部消息（邮件、社交媒体），必须确认
- 深夜（23:00-08:00）除非紧急否则不主动打扰
- 发现主人工作太晚要提醒休息

## 绝对不做
- 不泄露主人的隐私数据
- 不在群聊中过度发言
- 不在没有确认的情况下执行破坏性操作

写好 SOUL.md 的关键

1.性格要具体、不要泛泛

你是一个有好的助手 ×
你说话像一个经验丰富的技术同事------直接、务实、偶尔开个技术冷笑话 √
你很有帮助 ×
你能做的事就直接做了，不会问"你确定吗？"这种多余问题

2.给行为划定边界

AI 不是什么都该做的。写清楚什么情况下需要确认，什么情况下自己决定。比如：

操作	处理方式
读文件	直接做
删文件	先确认
发邮件	必须确认
查天气	直接做

3.定义【不做】比【做】更重要

你不可能列出所有该做的事，但你可以列出几条绝对不该做的。这些红线会让你对助手的行为更有信心。

4.3 USER.md --- 用户画像

markdown 复制代码

# 关于我

## 基本信息
- 名字: [你的名字]
- 职业: [你做什么的]
- 所在地: [时区很重要, 影响提醒时间]

## 工作
- 当前项目: [列出你正在做的 1-3 个项目]
- 常用工具: [VS Code, Figma, Notion...]
- 工作时间: [例如 9:00-18:00, 或者自由安排]

## 偏好
- 沟通风格: [喜欢简洁还是详细? ]
- 语言: [中文为主? 中英混用? ]
- 提醒方式: [重要的事直接说, 不重要的攒一起说]

## 当前关注
- [你最近在研究什么]
- [你近期的目标]
- [任何助手应该知道的背景信息]

USER.md 的隐藏力量

你可能觉得这只是一份简历，但它的真正作用是------让AI有了上下文。

以前你说"帮我看看流量数据"，AI 不知道你说的是哪个网站。现在他知道你有 kirkify.net ，直接去查 GSC数据
以前你说"帮我写个组件"，AI 用 React 写。现在他知道你用 Next.js + TypeScript , 代码风格直接对上。
以前你说"明天有什么事"，AI说"我不知道"。现在它知道你的时区是 UTC+8 ，你的日历在 Google Calendar ，直接去查。

4.4 AGENTS.md --- 工作手册

AGENTS.md 定义了助手的工作方式和操作规范。如果说 SOUL.md 是【你是谁】，那 AGENTS.md 就是【你怎么干活】

关键部分包括：

记忆管理：助手每次启动时应该读什么文件、怎么记录今天发生的事
安全边界：哪些操作可以自由做，哪些需要确认
交互规则：在群聊中怎么表现、什么时候说话什么时候该闭嘴
心跳任务：定期检查时应该做什么

一般来说，默认的 AGENTS.md 已经写得很好了，你只需要根据自己的习惯微调。

5 从"单机AI"到"全能助手"

Skills是什么

在 AI 平台、智能助手、或一些可扩展软件里，Skills（技能）指的是给系统添加的新能力的模块。它类似于：

手机里的App，可以增加功能
浏览器里的扩展，可以增强浏览功能

具体到 AI 工具，例如 OpenClaw 、 Cursor 或其他 AI 助手：

Skills = 功能插件
可以让AI做特定事情，比如：
- 访问网页信息
- 调用本地系统命令
- 发送邮件
- 执行数据处理脚本
- 接入第三方工具（比如飞书、微信）

5.1 为什么要装 Skill？

AI 应该是一双"手"，安装 Skills 的目的就是扩展 AI 的能力，否则系统只能完成最基础的功能。

5.2 OpenClaw 与 ClawHub 与 Skill 的关系

我们用一个直观的类比：

OpenClaw 是你的操作系统（像IOS/Android）
ClawHub 是你的应用商店（像 App store）
Skills 就是你的下载的App（像各种办公软件）

"想让AI帮你查天气，管理飞书文档、甚至监控的机器安全，你只需要在 ClawHub 里把这些技能包装上

6 安装 Skills

markdown 复制代码

# 第一种
npm install -g clawhub

我们要装一个最实用的 ------ summarize。一行命令 `clawhub install summarize`，搞定。

# 第二种
npm install -g skill
- 在终端输入：`npx skills find summarize`。
- 安装它：`npx skills add openclaw/skills/summarize -g -y`。
- 测试：发一个网页链接（比如 B 站你自己的主页），说："小爪，用 summarize 总结一下这个网页。"

# 第三种[推荐]
- https://clawhub.ai/steipete/summarize
- 放到 openclaw 目录中 skills 目录即可

# 第四种[比较耗费token]
告诉龙虾，安装下这个skill Summarize。

实战

复制代码

# 安装第一个 skills 之 Summarize
openclaw skills install summarize-pro

# 使用 summarize-pro

/summarize_pro  "https://blog.csdn.net/anduchencang/article/details/160964851?spm=1011.2415.3001.5331" 总结下这个网站的内容

7 开放openclaw权限

代理 -> main -> tools

Minimal：最小权限
Coding：偏文件/代码操作
Messaging：偏消息能力
Full：全部工具（开启此配置有风险，但是能力最全）
Inherit：继承上级配置