dwclaw-cli 1.0.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +119 -23
- package/dist/bundle.js +358 -184
- package/dist/main.js +1 -1
- package/docker/.env +9 -27
- package/docker/Dockerfile +1 -1
- package/docker/docker-compose.yml +6 -6
- package/docker/entrypoint.sh +2 -2
- package/package.json +2 -2
- /package/docker/{agent-template.json → duclaw.json} +0 -0
package/README.md
CHANGED
|
@@ -1,36 +1,132 @@
|
|
|
1
|
-
#
|
|
2
|
-
1. config enviroment
|
|
3
|
-
cp .env.example .env
|
|
1
|
+
# Duclaw
|
|
4
2
|
|
|
5
|
-
|
|
3
|
+
AI Agent 管理框架 — 支持飞书 Channel、团队协作、定时任务、Skill 扩展、Web 管理界面。
|
|
6
4
|
|
|
7
|
-
|
|
5
|
+
使用 Anthropic 标准协议（兼容 Claude / GLM / Kimi 等），一行命令启动你的 AI Agent。
|
|
8
6
|
|
|
9
|
-
|
|
7
|
+
## Quick Start
|
|
10
8
|
|
|
11
|
-
|
|
9
|
+
```bash
|
|
10
|
+
# 安装
|
|
11
|
+
npm install -g dwclaw-cli
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
# 初始化项目
|
|
14
|
+
mkdir my-agent && cd my-agent
|
|
15
|
+
duclaw init
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
# 编辑配置（见下方说明）
|
|
18
|
+
# 启动
|
|
19
|
+
duclaw start
|
|
20
|
+
```
|
|
16
21
|
|
|
17
|
-
|
|
22
|
+
## 配置
|
|
18
23
|
|
|
19
|
-
|
|
20
|
-
支持多用户，各种组织顺序参考下面：
|
|
21
|
-
{app} : {module} : {userId} : {scope?} : {id?}
|
|
22
|
-
agent:mem:${userId}:${date?}:${cron_title?}
|
|
24
|
+
`duclaw init` 会生成以下文件：
|
|
23
25
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
id? 可选 - 具体标识 cron_title、messageId 等
|
|
26
|
+
| 文件 | 说明 |
|
|
27
|
+
|------|------|
|
|
28
|
+
| `duclaw.json` | Channel 配置（飞书 appId / appSecret） |
|
|
29
|
+
| `.env` | LLM API、Redis、OSS 等环境变量 |
|
|
30
|
+
| `skills/` | 自定义技能目录 |
|
|
30
31
|
|
|
32
|
+
### duclaw.json
|
|
31
33
|
|
|
32
|
-
|
|
34
|
+
```json
|
|
35
|
+
{
|
|
36
|
+
"channels": {
|
|
37
|
+
"feishu": {
|
|
38
|
+
"enabled": true,
|
|
39
|
+
"appId": "YOUR_FEISHU_APP_ID",
|
|
40
|
+
"appSecret": "YOUR_FEISHU_APP_SECRET"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
```
|
|
33
45
|
|
|
46
|
+
### .env (必填项)
|
|
34
47
|
|
|
35
|
-
|
|
36
|
-
|
|
48
|
+
```bash
|
|
49
|
+
# LLM 配置（Anthropic 兼容协议）
|
|
50
|
+
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
|
|
51
|
+
export ANTHROPIC_AUTH_TOKEN="your-api-key"
|
|
52
|
+
export ANTHROPIC_MODEL="claude-sonnet-4-20250514"
|
|
53
|
+
|
|
54
|
+
# Redis
|
|
55
|
+
export REDIS_URL="redis://localhost:6379"
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
支持的 LLM 提供商（只要兼容 Anthropic Messages API）：
|
|
59
|
+
|
|
60
|
+
| 提供商 | BASE_URL | 示例模型 |
|
|
61
|
+
|--------|----------|----------|
|
|
62
|
+
| Anthropic | `https://api.anthropic.com` | `claude-sonnet-4-20250514` |
|
|
63
|
+
| 智谱 GLM | `https://open.bigmodel.cn/api/anthropic` | `glm-5` |
|
|
64
|
+
| Kimi | `https://api.moonshot.cn/anthropic` | `kimi-k2.5` |
|
|
65
|
+
|
|
66
|
+
> 如果 API 使用 Bearer Token 风格，需额外设置 `ANTHROPIC_AUTH_STYLE="bearer"`
|
|
67
|
+
|
|
68
|
+
## 飞书机器人配置
|
|
69
|
+
|
|
70
|
+
1. 前往 [飞书开放平台](https://open.feishu.cn/app) 创建应用
|
|
71
|
+
2. 添加权限：`im:message`（消息读写）
|
|
72
|
+
3. 添加事件订阅：`im.message.receive_v1`，订阅方式选择 **长连接**
|
|
73
|
+
4. 发布应用版本
|
|
74
|
+
5. 将 appId 和 appSecret 填入 `duclaw.json`
|
|
75
|
+
|
|
76
|
+
## CLI 命令
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
duclaw init [目录] # 初始化项目
|
|
80
|
+
duclaw start # 启动服务
|
|
81
|
+
duclaw # 等同于 start
|
|
82
|
+
duclaw --help # 帮助
|
|
83
|
+
duclaw --version # 版本
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## 数据目录
|
|
87
|
+
|
|
88
|
+
运行时数据默认存储在 `~/.duclaw/`：
|
|
89
|
+
|
|
90
|
+
| 路径 | 说明 | 环境变量覆盖 |
|
|
91
|
+
|------|------|-------------|
|
|
92
|
+
| `~/.duclaw/cron/jobs.json` | 定时任务配置 | `JOB_PATH` |
|
|
93
|
+
| `~/.duclaw/cron/` | 任务执行历史 | `JOB_HISTORY_DIR` |
|
|
94
|
+
| `~/.duclaw/data/` | 临时文件 | `APP_TEMP_DIR` |
|
|
95
|
+
|
|
96
|
+
## Docker 部署
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
cd docker
|
|
100
|
+
# 编辑 .env 和 duclaw.json
|
|
101
|
+
docker compose up -d
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
详见 [docker/README.md](docker/README.md)。
|
|
105
|
+
|
|
106
|
+
## 开发
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
git clone <repo>
|
|
110
|
+
cd agent-template-ts
|
|
111
|
+
pnpm install
|
|
112
|
+
|
|
113
|
+
# 复制并编辑配置
|
|
114
|
+
cp .env.example .env
|
|
115
|
+
# 编辑 duclaw.json
|
|
116
|
+
|
|
117
|
+
# 启动开发
|
|
118
|
+
pnpm start
|
|
119
|
+
|
|
120
|
+
# 构建
|
|
121
|
+
pnpm build
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## 依赖
|
|
125
|
+
|
|
126
|
+
- Node.js >= 18
|
|
127
|
+
- Redis（无密码）
|
|
128
|
+
- 飞书开放平台应用（用于 Channel 接入）
|
|
129
|
+
|
|
130
|
+
## License
|
|
131
|
+
|
|
132
|
+
Private
|