適用於 Openclaw 的 AstrBot 插件開發

一份全面的開發者指南，用於建立符合審核要求的 AstrBot 插件，涵蓋命令、LLM 工具與多代理整合。

camera-2018

v1.0.0

Apr 12, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install astrbot-plugin-dev-skill

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 astrbot-plugin-dev-skill。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 AstrBot 插件開發？

此 Openclaw Skills 資源為建立強大、高效能的 AstrBot 生態系統插件提供了技術框架。它專注於「審核優先」的開發流程，確保所有插件滿足 astr-plugin-reviewer 的嚴格要求，同時利用最新的 Star 類架構。該技能涵蓋了從初始 metadata 配置到進階 AI 驅動功能的整個生命週期。

透過遵循這些模式，開發者可以建立不僅功能齊全，且已為官方插件市場做好準備的插件。內容強調非同步 I/O、統一日誌記錄與簡潔的訊息鏈處理，從而實現從簡單的自動回覆到由大語言模型驅動的複雜多代理工作流等複雜的機器人互動。

AstrBot 插件開發應用場景

建立符合官方插件市場提交標準的新 AstrBot 插件。
將自訂 LLM 工具與代理整合到現有的聊天機器人工作流中。
將舊版機器人擴充遷移到現代非同步 Star 架構。
為機器人功能實作持久化資料儲存與配置管理。
使用自動參數解析與型別提示建立跨平台機器人命令。

AstrBot 插件開發運作原理

透過定義 metadata.yaml 檔案作為身份事實來源來初始化插件結構。
建立 main.py 檔案並實作繼承自 Star 基類的類別，以便自動發現。
使用諸如 @filter.command 之類的最佳化裝飾器註冊命令與篩選器，以處理使用者輸入。
利用 AstrBot 上下文存取核心 API，包括日誌記錄、會話管理與特定於平台的驅動程式。
使用 httpx 或 aiohttp 實作非同步網路呼叫，以確保機器人效能不被阻塞。
根據審核清單驗證實作，以確保在部署前具備相容性與穩定性。

AstrBot 插件開發設定指南

要開始使用本 Openclaw Skills 指南進行開發，請確保您的環境已為 AstrBot 開發做好準備。建立一個遵循 astrbot_plugin_[name] 命名約定的目錄並初始化所需檔案。

# Create plugin directory
mkdir astrbot_plugin_myskill && cd astrbot_plugin_myskill

# Initialize core files
touch main.py metadata.yaml requirements.txt

使用 pip 安裝必要的開發依賴項，以確保您的環境符合 AstrBot 核心要求。

AstrBot 插件開發資料結構與分類體系

插件結構經過嚴格定義，以確保與 Openclaw Skills 與 AstrBot 審核員的相容性：

檔案	類型	描述
`metadata.yaml`	YAML	包含插件名稱、版本、作者與儲存庫連結。
`main.py`	Python	繼承自 Star 類別的主要邏輯檔案。
`_conf_schema.json`	JSON	定義使用者的配置 UI 與設定架構。
`requirements.txt`	Text	列出插件所需的所有外部 Python 函式庫。
`data/`	Directory	透過 StarTools.get_data_dir() 存取的本地持久化目錄。