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

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











