@foxden-app/foxclaw 0.3.2 → 0.3.3
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 +6 -0
- package/README_EN.md +6 -0
- package/docs/assets/telegram-preview-en.svg +95 -0
- package/docs/assets/telegram-preview-zh.svg +95 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -26,6 +26,12 @@ FoxClaw（狸爪）的目标很直接：让你用手机控制本机的 Codex，
|
|
|
26
26
|
- 🔒 代码、shell、认证、审批、运行数据全部留在本机，不暴露到公网
|
|
27
27
|
- 👤 只允许一个受信任的 Telegram 用户远程操作
|
|
28
28
|
|
|
29
|
+
## 功能预览
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
手机端不是简单转发消息，而是给 Codex 的常用工作流做了 Telegram 面板：`/setup` 调模型、推理强度、Fast tier、权限和 Agent/Plan 模式；`/auth` 管理多个 Codex 登录候选，触发限制时自动轮转；`/threads`、`/watch` 和审批按钮用于切线程、观察进度和处理权限请求。
|
|
34
|
+
|
|
29
35
|
## 从这里开始
|
|
30
36
|
|
|
31
37
|
- 手头有 Codex、OpenClaw、QwenPaw、Hermes、OpenCode、Kimi CLI 之类能跑 shell 的 agent？推荐走 [Agent 辅助安装](./docs/zh/agent-assisted-install.md)。
|
package/README_EN.md
CHANGED
|
@@ -26,6 +26,12 @@ No public server required. FoxClaw runs on your own computer, talks to `codex ap
|
|
|
26
26
|
- 🔒 Code, shell, auth, approvals, and runtime data stay on your machine — nothing exposed to the public internet
|
|
27
27
|
- 👤 Only one trusted Telegram user can operate the bot
|
|
28
28
|
|
|
29
|
+
## Feature Preview
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
FoxClaw is more than message forwarding. It provides Telegram panels for Codex workflows: `/setup` adjusts model, reasoning, Fast tier, access, and Agent/Plan mode; `/auth` manages multiple Codex auth candidates and rotates them on usage limits; `/threads`, `/watch`, and approval buttons handle thread switching, progress monitoring, and permission requests.
|
|
34
|
+
|
|
29
35
|
## Start Here
|
|
30
36
|
|
|
31
37
|
- Already have a shell-capable agent such as Codex, OpenClaw, QwenPaw, Hermes, OpenCode, or Kimi CLI? Use the [Agent-Assisted Install](./docs/agent-assisted-install.md) first. This is the recommended path.
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="760" viewBox="0 0 1280 760" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">FoxClaw Telegram feature preview</title>
|
|
3
|
+
<desc id="desc">Telegram-style preview of FoxClaw setup and auth management panels.</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
|
|
6
|
+
<feDropShadow dx="0" dy="18" stdDeviation="18" flood-color="#152033" flood-opacity="0.16"/>
|
|
7
|
+
</filter>
|
|
8
|
+
<style>
|
|
9
|
+
.label { font: 600 24px Arial, sans-serif; fill: #111827; }
|
|
10
|
+
.body { font: 500 18px Arial, sans-serif; fill: #243244; }
|
|
11
|
+
.muted { font: 500 15px Arial, sans-serif; fill: #607086; }
|
|
12
|
+
.small { font: 600 14px Arial, sans-serif; fill: #42526a; }
|
|
13
|
+
.button { font: 700 15px Arial, sans-serif; fill: #1f6fb2; }
|
|
14
|
+
.top { font: 700 18px Arial, sans-serif; fill: #fff; }
|
|
15
|
+
.mono { font: 600 16px ui-monospace, SFMono-Regular, Menlo, monospace; fill: #334155; }
|
|
16
|
+
</style>
|
|
17
|
+
</defs>
|
|
18
|
+
<rect width="1280" height="760" rx="0" fill="#f3f7fb"/>
|
|
19
|
+
<circle cx="112" cy="102" r="58" fill="#d7edf9"/>
|
|
20
|
+
<circle cx="1185" cy="660" r="74" fill="#e5f4ec"/>
|
|
21
|
+
<text x="80" y="86" class="label">A mobile control panel for Codex</text>
|
|
22
|
+
<text x="80" y="118" class="body">Send tasks, inspect progress, approve actions, switch threads, and rotate auth accounts from Telegram.</text>
|
|
23
|
+
|
|
24
|
+
<g filter="url(#shadow)" transform="translate(96 164)">
|
|
25
|
+
<rect x="0" y="0" width="520" height="492" rx="36" fill="#17212b"/>
|
|
26
|
+
<rect x="18" y="18" width="484" height="456" rx="28" fill="#dcebf5"/>
|
|
27
|
+
<rect x="18" y="18" width="484" height="58" rx="28" fill="#229ed9"/>
|
|
28
|
+
<text x="48" y="55" class="top">FoxClaw Bot · /setup</text>
|
|
29
|
+
<rect x="44" y="104" width="432" height="236" rx="18" fill="#ffffff"/>
|
|
30
|
+
<text x="70" y="142" class="label">Setup · current thread</text>
|
|
31
|
+
<text x="70" y="176" class="body">Model: GPT-5.5</text>
|
|
32
|
+
<text x="70" y="206" class="body">Reasoning: High</text>
|
|
33
|
+
<text x="70" y="236" class="body">Mode: 📝 Plan</text>
|
|
34
|
+
<text x="70" y="266" class="body">Access: Workspace write</text>
|
|
35
|
+
<text x="70" y="296" class="body">Fast tier: ⚡ enabled</text>
|
|
36
|
+
<text x="70" y="326" class="muted">Each chat/thread can keep its own settings.</text>
|
|
37
|
+
<g transform="translate(44 360)">
|
|
38
|
+
<rect x="0" y="0" width="100" height="42" rx="12" fill="#e9f5ff"/>
|
|
39
|
+
<text x="25" y="27" class="button">⚡ Fast</text>
|
|
40
|
+
<rect x="112" y="0" width="96" height="42" rx="12" fill="#e9f5ff"/>
|
|
41
|
+
<text x="137" y="27" class="button">🔒 Read</text>
|
|
42
|
+
<rect x="220" y="0" width="96" height="42" rx="12" fill="#e9f5ff"/>
|
|
43
|
+
<text x="238" y="27" class="button">✍️ Work</text>
|
|
44
|
+
<rect x="328" y="0" width="104" height="42" rx="12" fill="#e9f5ff"/>
|
|
45
|
+
<text x="350" y="27" class="button">🛠️ Full</text>
|
|
46
|
+
<rect x="0" y="54" width="132" height="42" rx="12" fill="#eaf8ef"/>
|
|
47
|
+
<text x="34" y="81" class="button">📝 Plan</text>
|
|
48
|
+
<rect x="144" y="54" width="132" height="42" rx="12" fill="#eef2ff"/>
|
|
49
|
+
<text x="177" y="81" class="button">Agent</text>
|
|
50
|
+
</g>
|
|
51
|
+
</g>
|
|
52
|
+
|
|
53
|
+
<g filter="url(#shadow)" transform="translate(664 164)">
|
|
54
|
+
<rect x="0" y="0" width="520" height="492" rx="36" fill="#17212b"/>
|
|
55
|
+
<rect x="18" y="18" width="484" height="456" rx="28" fill="#dcebf5"/>
|
|
56
|
+
<rect x="18" y="18" width="484" height="58" rx="28" fill="#229ed9"/>
|
|
57
|
+
<text x="48" y="55" class="top">FoxClaw Bot · /auth</text>
|
|
58
|
+
<rect x="44" y="104" width="432" height="258" rx="18" fill="#ffffff"/>
|
|
59
|
+
<text x="70" y="142" class="label">Auth · account rotation</text>
|
|
60
|
+
<text x="70" y="176" class="body">Current: personal · GPT-5.5</text>
|
|
61
|
+
<text x="70" y="206" class="body">Auto-switches and retries on usage limits.</text>
|
|
62
|
+
<g transform="translate(70 232)">
|
|
63
|
+
<rect x="0" y="0" width="376" height="34" rx="10" fill="#f7fafc"/>
|
|
64
|
+
<text x="14" y="23" class="mono">✅ 1 personal</text>
|
|
65
|
+
<text x="256" y="23" class="small">32% used</text>
|
|
66
|
+
<rect x="0" y="44" width="376" height="34" rx="10" fill="#f7fafc"/>
|
|
67
|
+
<text x="14" y="67" class="mono">✅ 2 team</text>
|
|
68
|
+
<text x="280" y="67" class="small">ready</text>
|
|
69
|
+
<rect x="0" y="88" width="376" height="34" rx="10" fill="#f7fafc"/>
|
|
70
|
+
<text x="14" y="111" class="mono">⏸️ 3 trial</text>
|
|
71
|
+
<text x="256" y="111" class="small">disabled</text>
|
|
72
|
+
</g>
|
|
73
|
+
<g transform="translate(44 386)">
|
|
74
|
+
<rect x="0" y="0" width="120" height="42" rx="12" fill="#e9f5ff"/>
|
|
75
|
+
<text x="31" y="27" class="button">✅ enable</text>
|
|
76
|
+
<rect x="132" y="0" width="120" height="42" rx="12" fill="#fff4e6"/>
|
|
77
|
+
<text x="167" y="27" class="button">⏸️ pause</text>
|
|
78
|
+
<rect x="264" y="0" width="168" height="42" rx="12" fill="#eaf8ef"/>
|
|
79
|
+
<text x="309" y="27" class="button">add auth</text>
|
|
80
|
+
</g>
|
|
81
|
+
</g>
|
|
82
|
+
|
|
83
|
+
<g transform="translate(138 686)">
|
|
84
|
+
<rect x="0" y="-30" width="138" height="46" rx="23" fill="#ffffff"/>
|
|
85
|
+
<text x="25" y="0" class="small">send tasks</text>
|
|
86
|
+
<rect x="160" y="-30" width="150" height="46" rx="23" fill="#ffffff"/>
|
|
87
|
+
<text x="186" y="0" class="small">watch progress</text>
|
|
88
|
+
<rect x="332" y="-30" width="150" height="46" rx="23" fill="#ffffff"/>
|
|
89
|
+
<text x="359" y="0" class="small">tap approvals</text>
|
|
90
|
+
<rect x="504" y="-30" width="150" height="46" rx="23" fill="#ffffff"/>
|
|
91
|
+
<text x="533" y="0" class="small">switch threads</text>
|
|
92
|
+
<rect x="676" y="-30" width="176" height="46" rx="23" fill="#ffffff"/>
|
|
93
|
+
<text x="703" y="0" class="small">rotate accounts</text>
|
|
94
|
+
</g>
|
|
95
|
+
</svg>
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="760" viewBox="0 0 1280 760" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">FoxClaw Telegram 功能预览</title>
|
|
3
|
+
<desc id="desc">Telegram 风格的 FoxClaw setup 和 auth 管理面板示意图。</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
|
|
6
|
+
<feDropShadow dx="0" dy="18" stdDeviation="18" flood-color="#152033" flood-opacity="0.16"/>
|
|
7
|
+
</filter>
|
|
8
|
+
<style>
|
|
9
|
+
.label { font: 600 24px Arial, "Noto Sans CJK SC", sans-serif; fill: #111827; }
|
|
10
|
+
.body { font: 500 18px Arial, "Noto Sans CJK SC", sans-serif; fill: #243244; }
|
|
11
|
+
.muted { font: 500 15px Arial, "Noto Sans CJK SC", sans-serif; fill: #607086; }
|
|
12
|
+
.small { font: 600 14px Arial, "Noto Sans CJK SC", sans-serif; fill: #42526a; }
|
|
13
|
+
.button { font: 700 15px Arial, "Noto Sans CJK SC", sans-serif; fill: #1f6fb2; }
|
|
14
|
+
.top { font: 700 18px Arial, "Noto Sans CJK SC", sans-serif; fill: #fff; }
|
|
15
|
+
.mono { font: 600 16px ui-monospace, SFMono-Regular, Menlo, monospace; fill: #334155; }
|
|
16
|
+
</style>
|
|
17
|
+
</defs>
|
|
18
|
+
<rect width="1280" height="760" rx="0" fill="#f3f7fb"/>
|
|
19
|
+
<circle cx="112" cy="102" r="58" fill="#d7edf9"/>
|
|
20
|
+
<circle cx="1185" cy="660" r="74" fill="#e5f4ec"/>
|
|
21
|
+
<text x="80" y="86" class="label">手机上的 Codex 控制台</text>
|
|
22
|
+
<text x="80" y="118" class="body">发任务、看进度、点审批、切线程、轮转账号，都在 Telegram 面板里完成。</text>
|
|
23
|
+
|
|
24
|
+
<g filter="url(#shadow)" transform="translate(96 164)">
|
|
25
|
+
<rect x="0" y="0" width="520" height="492" rx="36" fill="#17212b"/>
|
|
26
|
+
<rect x="18" y="18" width="484" height="456" rx="28" fill="#dcebf5"/>
|
|
27
|
+
<rect x="18" y="18" width="484" height="58" rx="28" fill="#229ed9"/>
|
|
28
|
+
<text x="48" y="55" class="top">FoxClaw Bot · /setup</text>
|
|
29
|
+
<rect x="44" y="104" width="432" height="236" rx="18" fill="#ffffff"/>
|
|
30
|
+
<text x="70" y="142" class="label">Setup · 当前线程</text>
|
|
31
|
+
<text x="70" y="176" class="body">模型：GPT-5.5</text>
|
|
32
|
+
<text x="70" y="206" class="body">推理强度：High</text>
|
|
33
|
+
<text x="70" y="236" class="body">模式：📝 Plan</text>
|
|
34
|
+
<text x="70" y="266" class="body">权限：Workspace write</text>
|
|
35
|
+
<text x="70" y="296" class="body">Fast tier：⚡ 开启</text>
|
|
36
|
+
<text x="70" y="326" class="muted">每个聊天/线程都可以独立配置。</text>
|
|
37
|
+
<g transform="translate(44 360)">
|
|
38
|
+
<rect x="0" y="0" width="100" height="42" rx="12" fill="#e9f5ff"/>
|
|
39
|
+
<text x="25" y="27" class="button">⚡ Fast</text>
|
|
40
|
+
<rect x="112" y="0" width="96" height="42" rx="12" fill="#e9f5ff"/>
|
|
41
|
+
<text x="135" y="27" class="button">🔒 只读</text>
|
|
42
|
+
<rect x="220" y="0" width="96" height="42" rx="12" fill="#e9f5ff"/>
|
|
43
|
+
<text x="239" y="27" class="button">✍️ 默认</text>
|
|
44
|
+
<rect x="328" y="0" width="104" height="42" rx="12" fill="#e9f5ff"/>
|
|
45
|
+
<text x="345" y="27" class="button">🛠️ 完全</text>
|
|
46
|
+
<rect x="0" y="54" width="132" height="42" rx="12" fill="#eaf8ef"/>
|
|
47
|
+
<text x="34" y="81" class="button">📝 Plan</text>
|
|
48
|
+
<rect x="144" y="54" width="132" height="42" rx="12" fill="#eef2ff"/>
|
|
49
|
+
<text x="177" y="81" class="button">Agent</text>
|
|
50
|
+
</g>
|
|
51
|
+
</g>
|
|
52
|
+
|
|
53
|
+
<g filter="url(#shadow)" transform="translate(664 164)">
|
|
54
|
+
<rect x="0" y="0" width="520" height="492" rx="36" fill="#17212b"/>
|
|
55
|
+
<rect x="18" y="18" width="484" height="456" rx="28" fill="#dcebf5"/>
|
|
56
|
+
<rect x="18" y="18" width="484" height="58" rx="28" fill="#229ed9"/>
|
|
57
|
+
<text x="48" y="55" class="top">FoxClaw Bot · /auth</text>
|
|
58
|
+
<rect x="44" y="104" width="432" height="258" rx="18" fill="#ffffff"/>
|
|
59
|
+
<text x="70" y="142" class="label">Auth · 多账号轮转</text>
|
|
60
|
+
<text x="70" y="176" class="body">当前：personal · GPT-5.5</text>
|
|
61
|
+
<text x="70" y="206" class="body">限制触发时自动切换并重试。</text>
|
|
62
|
+
<g transform="translate(70 232)">
|
|
63
|
+
<rect x="0" y="0" width="376" height="34" rx="10" fill="#f7fafc"/>
|
|
64
|
+
<text x="14" y="23" class="mono">✅ 1 personal</text>
|
|
65
|
+
<text x="256" y="23" class="small">32% used</text>
|
|
66
|
+
<rect x="0" y="44" width="376" height="34" rx="10" fill="#f7fafc"/>
|
|
67
|
+
<text x="14" y="67" class="mono">✅ 2 team</text>
|
|
68
|
+
<text x="280" y="67" class="small">ready</text>
|
|
69
|
+
<rect x="0" y="88" width="376" height="34" rx="10" fill="#f7fafc"/>
|
|
70
|
+
<text x="14" y="111" class="mono">⏸️ 3 trial</text>
|
|
71
|
+
<text x="256" y="111" class="small">disabled</text>
|
|
72
|
+
</g>
|
|
73
|
+
<g transform="translate(44 386)">
|
|
74
|
+
<rect x="0" y="0" width="120" height="42" rx="12" fill="#e9f5ff"/>
|
|
75
|
+
<text x="31" y="27" class="button">✅ 启用</text>
|
|
76
|
+
<rect x="132" y="0" width="120" height="42" rx="12" fill="#fff4e6"/>
|
|
77
|
+
<text x="163" y="27" class="button">⏸️ 暂停</text>
|
|
78
|
+
<rect x="264" y="0" width="168" height="42" rx="12" fill="#eaf8ef"/>
|
|
79
|
+
<text x="307" y="27" class="button">添加账号</text>
|
|
80
|
+
</g>
|
|
81
|
+
</g>
|
|
82
|
+
|
|
83
|
+
<g transform="translate(158 686)">
|
|
84
|
+
<rect x="0" y="-30" width="138" height="46" rx="23" fill="#ffffff"/>
|
|
85
|
+
<text x="25" y="0" class="small">发任务</text>
|
|
86
|
+
<rect x="160" y="-30" width="138" height="46" rx="23" fill="#ffffff"/>
|
|
87
|
+
<text x="185" y="0" class="small">看进度</text>
|
|
88
|
+
<rect x="320" y="-30" width="138" height="46" rx="23" fill="#ffffff"/>
|
|
89
|
+
<text x="345" y="0" class="small">点审批</text>
|
|
90
|
+
<rect x="480" y="-30" width="138" height="46" rx="23" fill="#ffffff"/>
|
|
91
|
+
<text x="505" y="0" class="small">切线程</text>
|
|
92
|
+
<rect x="640" y="-30" width="168" height="46" rx="23" fill="#ffffff"/>
|
|
93
|
+
<text x="675" y="0" class="small">多账号轮转</text>
|
|
94
|
+
</g>
|
|
95
|
+
</svg>
|