mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-03 23:53:29 +08:00
ada4cd75a3
* docs(zh-CN): sync Chinese docs with latest upstream changes * update --------- Co-authored-by: neo <neo.dowithless@gmail.com>
80 lines
1.8 KiB
Markdown
80 lines
1.8 KiB
Markdown
---
|
||
description: 启动 NanoClaw 代理 REPL —— 一个由 claude CLI 驱动的持久、会话感知的 AI 助手。
|
||
---
|
||
|
||
# Claw 命令
|
||
|
||
启动一个交互式 AI 代理会话，该会话将会话历史持久化到磁盘，并可选择加载 ECC 技能上下文。
|
||
|
||
## 使用方法
|
||
|
||
```bash
|
||
node scripts/claw.js
|
||
```
|
||
|
||
或通过 npm：
|
||
|
||
```bash
|
||
npm run claw
|
||
```
|
||
|
||
## 环境变量
|
||
|
||
| 变量 | 默认值 | 描述 |
|
||
|----------|---------|-------------|
|
||
| `CLAW_SESSION` | `default` | 会话名称（字母数字 + 连字符） |
|
||
| `CLAW_SKILLS` | *(空)* | 要加载为系统上下文的技能名称，以逗号分隔 |
|
||
|
||
## REPL 命令
|
||
|
||
在 REPL 内部，直接在提示符下输入这些命令：
|
||
|
||
```
|
||
/clear Clear current session history
|
||
/history Print full conversation history
|
||
/sessions List all saved sessions
|
||
/help Show available commands
|
||
exit Quit the 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
|
||
# Start default session
|
||
node scripts/claw.js
|
||
|
||
# Named session
|
||
CLAW_SESSION=my-project node scripts/claw.js
|
||
|
||
# With skill context
|
||
CLAW_SKILLS=tdd-workflow,security-review node scripts/claw.js
|
||
```
|