80 lines
1.8 KiB
Markdown
80 lines
1.8 KiB
Markdown
|
---
|
|||
|
|
description: 啟動 NanoClaw agent REPL — 由 claude CLI 驅動的具備工作階段感知能力的持久型 AI 助手。
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Claw 指令
|
|||
|
|
|
|||
|
|
啟動互動式 AI agent 工作階段，將對話歷史記錄持久化到磁碟，並可選擇載入 ECC 技能上下文。
|
|||
|
|
|
|||
|
|
## 使用方式
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
node scripts/claw.js
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或透過 npm：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run claw
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 環境變數
|
|||
|
|
|
|||
|
|
| 變數 | 預設值 | 描述 |
|
|||
|
|
|----------|---------|-------------|
|
|||
|
|
| `CLAW_SESSION` | `default` | 工作階段名稱 (英數字 + 連字號) |
|
|||
|
|
| `CLAW_SKILLS` | *(空)* | 以逗號分隔的技能名稱，作為系統上下文載入 |
|
|||
|
|
|
|||
|
|
## REPL 指令
|
|||
|
|
|
|||
|
|
在 REPL 內部，直接提示字元處輸入以下指令：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
/clear 清除目前工作階段歷史
|
|||
|
|
/history 列印完整對話歷史
|
|||
|
|
/sessions 列出所有存檔的工作階段
|
|||
|
|
/help 顯示可用指令
|
|||
|
|
exit 退出 REPL
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 運作原理
|
|||
|
|
|
|||
|
|
1. 讀取 `CLAW_SESSION` 環境變數以選擇具名工作階段 (預設：`default`)
|
|||
|
|
2. 從 `~/.claude/claw/{session}.md` 載入對話歷史
|
|||
|
|
3. (選擇性) 從 `CLAW_SKILLS` 環境變數載入 ECC 技能上下文
|
|||
|
|
4. 進入阻斷式提示迴圈 — 每個使用者訊息都會連同完整歷史發送給 `claude -p`
|
|||
|
|
5. 回應會追加到工作階段檔案中，以便在重新啟動後保持持久性
|
|||
|
|
|
|||
|
|
## 工作階段儲存
|
|||
|
|
|
|||
|
|
工作階段以 Markdown 檔案形式儲存在 `~/.claude/claw/`：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
~/.claude/claw/default.md
|
|||
|
|
~/.claude/claw/my-project.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
每一輪的格式為：
|
|||
|
|
|
|||
|
|
```markdown
|
|||
|
|
### [2025-01-15T10:30:00.000Z] 使用者
|
|||
|
|
這個函式的作用是什麼？
|
|||
|
|
---
|
|||
|
|
### [2025-01-15T10:30:05.000Z] 助手
|
|||
|
|
這個函式計算...
|
|||
|
|
---
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 範例
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 啟動預設工作階段
|
|||
|
|
node scripts/claw.js
|
|||
|
|
|
|||
|
|
# 具名工作階段
|
|||
|
|
CLAW_SESSION=my-project node scripts/claw.js
|
|||
|
|
|
|||
|
|
# 帶有技能上下文
|
|||
|
|
CLAW_SKILLS=tdd-workflow,security-review node scripts/claw.js
|
|||
|
|
```
|