note

• OpenClaw = 大模型大脑 + 能动手的手脚 + 本地隐私 + 开源免费，帮你把电脑上的重复活儿全自动化。
• 关于openclaw。openclaw 之外，要关注的是：1）学会写skill；2）继续关注 skill 的生成、挖掘、增强；3）训练模型对skill的调用能力
• openclaw架构总结：
  • 核心架构：以 Gateway（网关） 为中心的控制平面，统一管理所有通信与调度。
  • 大脑引擎：事件驱动的Agentic Loop，处理从接收、推理、调用工具到回复的全流程。
  • 生态连接：通过 Channels（频道） 系统，将AI能力无缝集成到Telegram、Slack、WhatsApp等用户现有社交平台。
  • 执行能力：分层设计的 工具（Tools）系统，结合精细的策略管道，实现安全可控的自动化操作。
  • 后台基石：定时任务系统和智能上下文管理，支撑系统的长期稳定运行与复杂对话。

一、OpenClaw

它是能动手做事的开源 AI 智能体，不是只会聊天的机器人，更像你的免费数字员工。
它和普通 AI（ChatGPT/Claude）的区别
普通 AI：只说不做，给你方案、写文案、回答问题
OpenClaw：能说会做，听懂指令后自动操作电脑 / 软件 / 系统，帮你把事干完
核心特点（大白话版）
✅ 本地优先：数据存在你电脑，不上云端，隐私更安全
✅ 零代码：用大白话发指令，不用写脚本、不用懂技术
✅ 真・执行：能操作文件、发邮件、整理文件夹、控制软件、调用 API
✅ 会规划：复杂任务自动拆成小步骤，还能生成子代理分工干
✅ 开源免费：GitHub 上可直接用，社区还在疯狂加功能

举几个例子（一看就懂）
“把桌面所有 PDF 按月份整理到对应文件夹” → 自动分类、移动、重命名
“给客户发跟进邮件，抄送老板，附件是上周报告” → 自动写邮件、发邮件
“提取这 10 个 Excel 里的销售数据，汇总成周报” → 自动读表、计算、生成文档
“每天早上 9 点帮我同步飞书待办、查天气、发日报” → 定时自动执行

一句话总结：
OpenClaw = 大模型大脑 + 能动手的手脚 + 本地隐私 + 开源免费，帮你把电脑上的重复活儿全自动化。

相关原理：

• openclaw架构总结：
  • 核心架构：以 Gateway（网关） 为中心的控制平面，统一管理所有通信与调度。
  • 大脑引擎：事件驱动的Agentic Loop，处理从接收、推理、调用工具到回复的全流程。
  • 生态连接：通过 Channels（频道） 系统，将AI能力无缝集成到Telegram、Slack、WhatsApp等用户现有社交平台。
  • 执行能力：分层设计的 工具（Tools）系统，结合精细的策略管道，实现安全可控的自动化操作。
  • 后台基石：定时任务系统和智能上下文管理，支撑系统的长期稳定运行与复杂对话。

具体展开的架构图：

二、安装和部署

1、OpenClaw 安装部署指南

一、环境要求

项目	要求
Node.js	≥ 22.x
包管理器	pnpm（推荐）或 npm
操作系统	macOS / Linux / Windows

# 检查 Node.js 版本
node -v

# 安装 pnpm（如果没有）
npm install -g pnpm

二、获取项目

# 方式1：克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

三、安装依赖

pnpm install
# 或
npm install

四、构建项目

pnpm build

构建过程会自动执行：

• A2UI bundle 打包
• TypeScript 编译（tsdown）
• Plugin SDK 类型声明生成
• 资源文件复制

五、运行安装向导

pnpm openclaw onboard --install-daemon

这会：

• 安装守护进程
• 启动 Gateway 服务
• 生成访问令牌
• 引导初始配置

六、设备配对

# 查看待配对设备
pnpm openclaw devices list

# 批准配对请求（替换为实际的 request-id）
pnpm openclaw devices approve <request-id>

七、启动使用

方式	命令/地址
Web控制台	pnpm openclaw dashboard
终端界面	pnpm openclaw tui
查看状态	pnpm openclaw channels status

八、常用命令速查

# 查看帮助
pnpm openclaw --help

# 查看配置
pnpm openclaw config get gateway.auth.token

# 诊断问题
pnpm openclaw doctor

# 重启网关
pkill -f openclaw-gateway
pnpm openclaw gateway run --bind loopback --port 18789

九、目录结构

openclaw/
├── src/           # 源代码
├── dist/          # 构建输出
├── extensions/    # 插件扩展
├── docs/          # 文档
└── scripts/       # 构建脚本

十、注意事项

1. 配置警告：如果看到 duplicate plugin id detected 警告，是插件重复注册，不影响使用
2. 配置文件位置：~/.openclaw/openclaw.json
3. 默认端口：18789
4. 日志查看：tail -f /tmp/openclaw-gateway.log

三、相关命令

1、启动 Gateway

# 后台启动 gateway（绑定本地回环，端口 18789）
nohup openclaw gateway run --bind loopback --port 18789 --force > /tmp/openclaw-gateway.log 2>&1 &

在 macOS 上，也可以通过 OpenClaw Mac 应用 或 scripts/restart-mac.sh 脚本启动。

---

2、关闭 Gateway

pkill -9 -f openclaw-gateway

---

3、常用命令列表

用途	命令
检查状态	openclaw channels status --probe
深度状态检查	openclaw channels status --all
配置设置	openclaw config set <key> <value>
诊断问题	openclaw doctor
登录	openclaw login
更新到最新版	sudo npm i -g openclaw@latest
查看日志	tail -n 120 /tmp/openclaw-gateway.log
验证端口监听	ss -ltnp | rg 18789

---

4、开发环境命令

用途	命令
安装依赖	pnpm install
开发模式运行 CLI	pnpm openclaw ... 或 pnpm dev
类型检查/构建	pnpm build
运行测试	pnpm test
代码检查	pnpm check
格式化代码	pnpm format:fix

四、OpenClaw 新手必备 10 大技能推荐

OpenClaw 的核心优势在于其 “技能包 (Skills)” 系统。这就像一个万能工具箱，AI 能够根据任务动态调用最合适的工具，实现“专具专用，高效不卡顿”。目前社区已有数百个技能，令人眼花缭乱。

为了帮助新手快速上手，基于 2026 年 ClawHub 热门榜、社区精选及 X/Reddit 的真实反馈，筛选出 10 个最值得安装的技能。

---

1、最建议新手使用的 10 个技能

这份名单遵循 “低风险、高实用、效果立竿见影” 的原则。所选技能大多来自 @steipete 等靠谱作者，安装量高、Star 多，且恶意报告极少。

序号	技能名	核心功能	推荐理由
1	self-improving-agent	让 Agent 记住错误、自我迭代、越用越聪明	ClawHub 热门榜第一 (46k+ installs)，新手极易感知智能提升
2	tavily-search	联网搜索 (基于 Tavily API 优化)	Agent 的“眼睛”，无此技能则无法获取实时信息 (37k+ installs)
3	gog	集成 Google Workspace (Gmail, 日历, Drive, Docs)	办公自动化神器，快速体验实际效果 (46k+ installs)
4	github	GitHub 集成 (基于 gh CLI)	管理代码、Issue、PR，开发者入门必备 (35k+ installs)
5	summarize	总结 URL、PDF、图片、YouTube、音频	信息消化利器，大幅提升研究效率 (36k+ installs)
6	find-skills	让 Agent 自己搜索并推荐/安装技能	解决“不知道装什么”的核心痛点，新手友好
7	ontology / agent-memory	结构化记忆/知识图谱	让 Agent“记住你”，提升长期交互体验 (35k+ installs)
8	weather	查询天气 (无需 API Key)	极简、零配置，新手首次测试成功率 100%，建立信心 (29k+ installs)
9	proactive-agent	增强 Agent 主动性，自主规划任务	让 Agent 从“被动问答”转向“主动帮忙” (中文社区特别推荐)
10	skill-vetter / security-audit	安装前扫描技能代码，防范恶意行为	安全第一，社区共识的“后悔没先装”类技能

---

2、新手安装建议顺序

切勿一次性全部安装，建议按以下顺序逐步添加：

强烈建议：先用 clawhub install skill-vetter 安装安全扫描技能，确保后续安装环境安全。

阶段	核心目标	建议安装顺序
第一阶段	安全保障 + 基础智能	1. skill-vetter (安全扫描) 2. tavily-search (联网能力) 3. self-improving-agent + proactive-agent (基础智能)
第二阶段	生产力提升	4. gog 或 github (根据日常需求二选一) 5. summarize + find-skills (信息处理与技能发现)
第三阶段	体验优化	6. ontology / agent-memory (长期记忆) 7. weather (测试与玩耍)

安装命令：

# 基本安装
clawhub install <skill-slug>

# 或使用 npx
npx clawhub@latest install <skill-slug>

---

3、实用小贴士

1. 探索社区：先去 https://www.clawhub.ai/ 浏览 热门 (Trending) 榜单，关注安装量和作者信誉。
2. 主动搜索：使用 clawhub search "beginner" OR "essential" 自行发现更多适合新手的技能。
3. 生效与重启：安装新技能后，需新开 Session (重启 OpenClaw) 才能生效。
4. 性能管理：切勿一次性启用过多技能，以免 Token 消耗剧增或性能下降。建议先熟练使用 3-5 个，再逐步增加。
5. 安全第一：
   • 尽量在隔离环境 (如 Docker) 中运行。
   • 切勿授予敏感权限。
   • 定期运行 clawhub update --all 更新所有技能至最新安全版本。

五、openclaw经验总结之速查表

【openclaw经验总结之速查表】工作都在 .openclaw/workspace 里面完成, 这里面的几个文件至关重要:
AGENTS.md: Agent 行为手册 — 定义每次会话的启动流程：1. 先读 SOUL.md（了解自己是谁）2. 再读 USER.md（了解在帮谁）3. 读取 memory/ 中的近期日记还包含记忆管理规则、文件组织规则、工具使用规范等

HEARTBEAT.md: 心跳任务配置 — 定义 Agent 周期性自主执行的任务文件为空或仅含注释时跳过心跳调用）

IDENTITY.md: Agent 身份卡片 — 名字、物种/类型、性格基调、标志性 Emoji、头像路径

SOUL.md: Agent 的"灵魂" — 核心人格定义，包含：Core Truths（行为准则）、Boundaries（行为边界）、Vibe（性格风格）、擅长领域、Continuity（持续性规则）

TOOLS.md: 本地工具备忘录 — 记录用户环境特有的设备、SSH 主机、TTS 偏好等（与 skills/ 分开，避免共享技能时泄露个人基础设施信息）

USER.md: 用户档案 — 主人的名字、称呼、时区、个人偏好和上下文笔记，ref:https://weibo.com/2169039837/QvoEDaIjS

Reference

[1] https://github.com/openclaw/openclaw#
[2] OpenClaw爆火两周后，它的用法已经比科幻世界还离谱了
[3] awesome-openclaw-tutorial:从零开始玩转OpenClaw：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南（github版）:https://github.com/xianyu110/awesome-openclaw-tutorial,https://awesome.tryopenclaw.asia
[4] 最适合新手安装的10个小龙虾🦞 skills来了
[5] https://docs.openclaw.ai/zh-CN
[6] 一文了解｜火山引擎 OpenClaw 安全最佳实践
[7] https://www.cert.org.cn/publish/main/11/2026/20260312144519429724511/20260312144519429724511_.html