一文手把手教你用OpenClaw打造專屬AI助手:從安裝到自定義Skills全過(guò)程
前言
本文從零開(kāi)始搭建一個(gè)屬于你自己的 OpenClaw AI 助手,并教你如何編寫自定義 Skill,讓這只龍蝦真正為你干活。
一、環(huán)境準(zhǔn)備
| 依賴 | 版本要求 |
|---|---|
| Node.js | ≥ 22 |
| 操作系統(tǒng) | macOS / Linux / Windows (WSL2) |
| LLM API Key | Claude / GPT / 其他兼容模型 |
Windows 用戶強(qiáng)烈建議使用 WSL2,原生 Windows 支持還不夠穩(wěn)定。
二、安裝與初始化
2.1 通過(guò) npm 安裝(推薦)
# 全局安裝 npm install -g openclaw@latest # 驗(yàn)證安裝 openclaw --version # 運(yùn)行引導(dǎo)向?qū)? openclaw onboard --install-daemon
引導(dǎo)向?qū)?huì)依次幫你完成:
- Gateway 守護(hù)進(jìn)程安裝(launchd/systemd)
- 工作空間目錄創(chuàng)建
- 聊天通道配置(選擇你要接入的平臺(tái))
- LLM API Key 配置
- 基礎(chǔ) Skills 安裝
2.2 從源碼構(gòu)建(開(kāi)發(fā)者)
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 首次運(yùn)行會(huì)自動(dòng)安裝 UI 依賴 pnpm build pnpm openclaw onboard --install-daemon # 開(kāi)發(fā)模式(TS 文件變更自動(dòng)重載) pnpm gateway:watch
三、核心配置文件詳解
安裝完成后,你的工作空間大致長(zhǎng)這樣:
~/openclaw/ ├── SOUL.md # Agent 的"靈魂",定義人格和行為準(zhǔn)則 ├── IDENTITY.md # 身份信息 ├── USER.md # 你的個(gè)人偏好 ├── HEARTBEAT.md # 定時(shí)任務(wù)配置 ├── memory/ # 持久化記憶目錄 │ └── MEMORY.md # 記憶索引 └── skills/ # 技能插件目錄
3.1 SOUL.md —— 給龍蝦定規(guī)矩
這是 OpenClaw 最有意思的設(shè)計(jì)之一。你可以用自然語(yǔ)言定義 Agent 的行為:
# Soul ## 基本原則 - 你是我的私人技術(shù)助手,專注于后端開(kāi)發(fā)和 DevOps - 回復(fù)使用中文,技術(shù)術(shù)語(yǔ)保留英文 - 簡(jiǎn)潔直接,不要廢話 ## 行為邊界 - 未經(jīng)確認(rèn)不要執(zhí)行危險(xiǎn)的 Shell 命令(rm -rf、drop table 等) - 涉及金錢操作時(shí)必須二次確認(rèn) - 不要主動(dòng)訪問(wèn)我未授權(quán)的目錄 ## 風(fēng)格 - 像一個(gè)靠譜的同事,不是客服 - 可以適當(dāng)幽默
3.2 HEARTBEAT.md —— 定時(shí)任務(wù)
# Heartbeat ## 每日晨報(bào) (07:30) - 匯總昨天的 Git commit - 列出今天的日歷事件 - 檢查服務(wù)器監(jiān)控面板是否有異常 ## 每周五下午 (17:00) - 生成本周工作周報(bào)草稿
四、接入聊天平臺(tái)
以 Telegram 為例:
4.1 創(chuàng)建 Telegram Bot
- 在 Telegram 中找到 @BotFather
- 發(fā)送
/newbot,按提示創(chuàng)建 - 獲取 Bot Token
4.2 配置 OpenClaw
在引導(dǎo)向?qū)е羞x擇 Telegram,或手動(dòng)編輯配置:
openclaw channel add telegram --token YOUR_BOT_TOKEN
配置完成后,給你的 Bot 發(fā)消息就能和 OpenClaw 對(duì)話了。
其他平臺(tái)(Slack、Discord、飛書(shū)等)流程類似,向?qū)Ф加幸龑?dǎo)。
五、編寫自定義 Skill(重點(diǎn))
Skills 是 OpenClaw 的靈魂。一個(gè) Skill 本質(zhì)上就是一個(gè) Markdown 文件,告訴 Agent 如何完成某類任務(wù)。
5.1 基礎(chǔ) Skill 示例:Git 日?qǐng)?bào)生成器
在 skills/ 目錄下創(chuàng)建 git-daily-report.md:
# Skill: Git 日?qǐng)?bào)生成器 ## 觸發(fā)條件 當(dāng)用戶說(shuō)"生成日?qǐng)?bào)"或"今天做了什么"時(shí)觸發(fā)。 ## 執(zhí)行步驟 1. 執(zhí)行以下命令獲取今天的 commit 記錄: ```bash git log --since="today 00:00" --pretty=format:"%h - %s (%an)" --all
按以下格式整理輸出:
- 按倉(cāng)庫(kù)分組
- 每個(gè) commit 一行,包含簡(jiǎn)短描述
- 底部統(tǒng)計(jì)總 commit 數(shù)
輸出格式:
?? 今日工作日?qǐng)?bào) (YYYY-MM-DD) ## 項(xiàng)目A - abc1234 - 修復(fù)登錄頁(yè)面樣式問(wèn)題 - def5678 - 添加用戶權(quán)限校驗(yàn) ## 項(xiàng)目B - ghi9012 - 優(yōu)化數(shù)據(jù)庫(kù)查詢性能 --- 總計(jì):3 個(gè)提交
### 5.2 進(jìn)階 Skill 示例:服務(wù)器健康檢查
```markdown
# Skill: 服務(wù)器健康檢查
## 觸發(fā)條件
當(dāng)用戶說(shuō)"檢查服務(wù)器"或由 HEARTBEAT 定時(shí)觸發(fā)。
## 執(zhí)行步驟
1. 檢查目標(biāo)服務(wù)器列表(從 USER.md 中讀取 server_list)
2. 對(duì)每臺(tái)服務(wù)器執(zhí)行:
```bash
curl -s -o /dev/null -w "%{http_code}" https://{server_url}/health匯總結(jié)果:
- ? 正常(HTTP 200)
- ?? 響應(yīng)慢(> 2s)
- ? 異常(非 200 或超時(shí))
如果有異常服務(wù)器,主動(dòng)通過(guò)當(dāng)前聊天通道告警,格式:
?? 服務(wù)器異常告警 ? api-server-03: HTTP 502 (響應(yīng)時(shí)間: 5.2s) ? db-replica-02: 連接超時(shí) 其余 8 臺(tái)服務(wù)器運(yùn)行正常 ?
### 5.3 使用 ClawHub 社區(qū)技能 除了自己寫,你也可以從社區(qū)技能市場(chǎng)安裝現(xiàn)成的 Skill: ```bash # 瀏覽熱門技能 openclaw skills search "email" # 安裝技能 openclaw skills install @community/email-manager
六、記憶系統(tǒng)詳解
OpenClaw 的記憶系統(tǒng)是它區(qū)別于普通聊天機(jī)器人的關(guān)鍵。
memory/ ├── MEMORY.md # 記憶索引和摘要 ├── conversations/ # 對(duì)話歷史 ├── facts/ # 提取的事實(shí)(如:用戶偏好 Python 3.12) └── diary/ # Agent 的"日記"
記憶基于 SQLite 做語(yǔ)義搜索,Agent 會(huì)自動(dòng):
- 從對(duì)話中提取關(guān)鍵事實(shí)
- 在后續(xù)對(duì)話中檢索相關(guān)記憶
- 定期整理和壓縮過(guò)期記憶
你也可以手動(dòng)管理:
# 查看記憶 openclaw memory list # 刪除特定記憶 openclaw memory forget "某條不需要的記憶" # 導(dǎo)出記憶 openclaw memory export --format json
七、安全最佳實(shí)踐
本地運(yùn)行 = 你的機(jī)器暴露給了 Agent,務(wù)必注意:
# 1. 配置 DM 配對(duì)模式,防止陌生人訪問(wèn) # 默認(rèn)已開(kāi)啟,確認(rèn)一下: openclaw config get dmPolicy # 應(yīng)該返回 "pairing" # 2. 審查已安裝的 Skills openclaw skills list --verbose # 3. 運(yùn)行安全檢查 openclaw doctor # 4. 保持更新 openclaw update --channel stable
八、實(shí)用技巧
多模型切換:可以配置多個(gè) LLM,按任務(wù)類型自動(dòng)選擇
openclaw models add claude-sonnet --provider anthropic openclaw models add gpt-4o --provider openai openclaw models set-default claude-sonnet
調(diào)試模式:排查問(wèn)題時(shí)開(kāi)啟 verbose
openclaw gateway --verbose
Canvas 功能:OpenClaw 支持渲染實(shí)時(shí) Canvas,適合可視化展示
openclaw agent --message "畫一個(gè)系統(tǒng)架構(gòu)圖" --canvas
九、總結(jié)
OpenClaw 的上手門檻其實(shí)不高,核心就三步:
- 安裝 + 配置 API Key
- 接入你常用的聊天平臺(tái)
- 編寫或安裝 Skills
真正的價(jià)值在于 Skills + Memory 的組合。隨著你使用時(shí)間越長(zhǎng),這只龍蝦就越了解你,越能幫你干活。
建議從簡(jiǎn)單的 Skill 開(kāi)始寫起,比如日?qǐng)?bào)生成、提醒事項(xiàng),慢慢擴(kuò)展到更復(fù)雜的自動(dòng)化工作流。
以上就是一文手把手教你用OpenClaw打造專屬 AI 助手:從安裝到自定義Skills全流程的詳細(xì)內(nèi)容,更多關(guān)于OpenClaw打造專屬AI助手的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章

OpenClaw Skills完全指南:手把手教你與實(shí)戰(zhàn)應(yīng)用
最近 AI 圈最火的話題莫過(guò)于 OpenClaw 了——這個(gè)開(kāi)源 AI 代理框架正在悄悄改變我們與 AI 互動(dòng)的方式,沒(méi)有 Skills 的 OpenClaw 只是個(gè)能聊天的工具,裝上 Skills 后,它才2026-03-24
openclaw安裝skills報(bào)錯(cuò)的6大解決方案(適用macOS/Windows/Linux)
本文將全面解析openclaw安裝skills報(bào)錯(cuò)clawhub: command not found的解決方法,涵蓋Windows/macOS/Linux平臺(tái)的6大原因和12種解決方案,有需要的小伙伴可以跟隨小編一起學(xué)習(xí)2026-03-15
Mac安裝和配置OpenClaw的超詳細(xì)保姆級(jí)教程(附 skills安裝)
OpenClaw是一個(gè)開(kāi)源的AI助手框架,支持多模型接入和技能擴(kuò)展,適用于多渠道聊天,文章詳細(xì)介紹了Mac上安裝和配置OpenClaw的步驟,包括安裝OpenClaw CLI、驗(yàn)證安裝、完成onboard2026-03-12
OpenClaw Skills無(wú)法安裝/安裝報(bào)錯(cuò)的4步排查法(macOS/Windows/Linux通用)
OpenClaw Skills 無(wú)法安裝,通常由權(quán)限不足、路徑錯(cuò)誤、網(wǎng)絡(luò)連通性問(wèn)題或依賴缺失四類原因?qū)е拢ㄟ^(guò)逐步排查可在 10 分鐘內(nèi)解決,本文覆蓋全平臺(tái)的系統(tǒng)性排查方法,適用于2026-03-12
OpenClaw Skills 進(jìn)階實(shí)戰(zhàn)指南(前端開(kāi)發(fā)者的AI技能庫(kù)搭建)
本文詳細(xì)介紹了如何配置和使用OpenClaw的技能插件,特別是針對(duì)前端開(kāi)發(fā)場(chǎng)景,它提供了按需構(gòu)建技能的選擇策略、多種安裝技能的方法,以及2026年最受歡迎的OpenClaw技能推薦,此2026-03-11
openclaw的skills開(kāi)發(fā)規(guī)范以及OpenClaw skills安裝流程
OpenClaw通過(guò)“Skills”機(jī)制實(shí)現(xiàn)高度可擴(kuò)展性,每個(gè)Skill由“能力描述+執(zhí)行邏輯”組成,開(kāi)發(fā)者需編寫SKILL.md文件或添加Python/TypeScript腳本實(shí)現(xiàn)功能,下面從開(kāi)發(fā)規(guī)范與安裝2026-03-10
本文介紹了OpenClawSkills的四種安裝方法分別是手動(dòng)下載安裝、通過(guò)飛書(shū)/聊天工具安裝、命令行安裝和WebUI圖形化安裝,每種方法都有其優(yōu)缺點(diǎn),適用于不同的場(chǎng)景,感興趣的朋友2026-03-10
OpenClaw/Clawdbot必裝10大Skills指南:從部署到技能精通
本文推薦的10大必裝Skills,覆蓋了搜索、自動(dòng)化、部署、分析四大核心場(chǎng)景,通過(guò)合理搭配,可將OpenClaw從普通問(wèn)答助手升級(jí)為能執(zhí)行真實(shí)任務(wù)的智能工作系統(tǒng)——無(wú)論是職場(chǎng)辦2026-03-09
一文分享最適合新手先裝的20個(gè)OpenClaw Skills
這兩天,越來(lái)越多人開(kāi)始折騰 OpenClaw,很多人第一次上手時(shí),最興奮的一件事就是裝 Skills,看著社區(qū)里一排排工具,感覺(jué)像剛進(jìn)五金倉(cāng)庫(kù),什么都想拿一點(diǎn),下面小編就和大家簡(jiǎn)2026-03-09
最近 OpenClaw 是真的火,裝機(jī)量蹭蹭漲,Skills 市場(chǎng)一打開(kāi),13000 多個(gè) Skill 擺在你面前,不知道如何選擇,今天為大家?guī)?lái)了OpenClaw最值得裝的10個(gè)Skills推薦,一起看看2026-03-09











