適用於 Openclaw 的 工作階段重新命名

一種專門用於透過更新工作階段歷史記錄儲存或後端路徑來重新命名和組織 OpenClaw 聊天工作階段的實用程式。

maverick-software
v1.0.0
Apr 12, 2026
0
871
0

安裝與下載

1. ClawHub CLI

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

npx clawhub@latest install session-rename

2. 手動安裝

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

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

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

3. 提示詞安裝

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

請幫我使用 Clawhub 安裝 session-rename。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

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

什麼是 工作階段重新命名?

工作階段重新命名 skill 為開發人員和 AI 代理提供了一種可靠的方法,用於在 OpenClaw 生態系統中管理聊天工作階段識別。透過鎖定 session_history.displayName 記錄,此 skill 可確保工作區保持整潔且易於導航。它旨在處理跨不同代理實例對活動或封存工作階段進行重新命名、重新標記或重新命名的請求。

該 skill 專為直接對接 OpenClaw 架構而構建,架起了用戶意圖與資料庫完整性之間的橋樑。無論是透過內建的 sessions.rename 後端路徑使用,還是透過外科手術式的 SQLite 更新,它都優先考慮資料安全性與精確性,確保只修改預期的工作階段元資料,同時保留核心 sessionId。

工作階段重新命名 應用場景

  • 將通用聊天工作階段重新命名為描述性專案標題,以便更好地進行組織。
  • 當多個代理在不同實例中執行時,更正工作階段標籤。
  • 在完成特定任務或里程碑後,自動重新命名聊天記錄。
  • 當標準 UI 路徑不可用或無回應時,更新工作階段歷史元資料。

工作階段重新命名 運作原理

  1. 該 skill 識別擁有目標工作階段的特定 OpenClaw 實例和代理 ID。
  2. 它定位與該實例關聯的活動 history.db 檔案,通常位於 ~.openclaw 目錄下。
  3. 系統在 session_history 表中搜尋活動列,按 sessionKey 和最近更新的時間戳進行篩選。
  4. 它執行有針對性的 SQL 更新來更改 displayName 並更新 updatedAt 時間戳。
  5. 該 skill 透過從資料庫中讀取更新後的記錄來驗證更改。
  6. 最後,它提供確認訊息,如果前端未立即顯示更改,則建議重新整理 UI。

工作階段重新命名 設定指南

要在 Openclaw Skills 框架內使用此工具,請確保您擁有讀/寫 OpenClaw 應用程式資料目錄的必要權限。如果 OpenClaw CLI 已啟用,則無需額外安裝。

要手動測試資料庫連線和路徑,您可以使用以下指令定位歷史資料庫:

# 尋找特定代理的工作階段歷史資料庫
ls ~\.openclaw\agents\<agent-id>\sessions\history.db

請確保您的環境中安裝了 sqlite3 和 python3 以進行直接的 DB 重新命名模式操作。

工作階段重新命名 資料結構與分類體系

該 skill 與結構化的 SQLite 架構進行互動,以確保 Openclaw Skills 之間的一致性。以下是主要的資料對應:

表 欄位 類型 描述
session_history sessionId TEXT (PK) 工作階段的唯一識別碼。
session_history sessionKey TEXT 識別代理實例的鍵。
session_history displayName TEXT 面向用戶的工作階段標題。
session_history status TEXT 目前狀態(例如,'active','archived')。
session_history updatedAt INTEGER 毫秒級的 Unix 時間戳。

工作階段重新命名 進階特性

  • 外科手術式 SQLite 更新:執行高精度的 Python/SQLite 指令碼來修改記錄,而不影響全域工作階段狀態。
  • 多實例支援:能夠遍歷不同的代理特定目錄以找到正確的歷史記錄儲存。
  • 回退邏輯:如果找不到明確的 'active' 狀態,則自動尋找最近使用過的工作階段。
  • 後端整合:支援 OpenClaw 閘道伺服器中內建的 sessions.rename 方法,以實現更安全的應用程式級更改。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*