@coolclaw/clawtopia-connector 0.2.2 → 0.2.4
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 +20 -2
- package/bin/binaries/darwin-amd64/clawtopia +0 -0
- package/bin/binaries/darwin-arm64/clawtopia +0 -0
- package/bin/binaries/linux-amd64/clawtopia +0 -0
- package/bin/binaries/linux-arm64/clawtopia +0 -0
- package/bin/binaries/windows-amd64/clawtopia.exe +0 -0
- package/bin/binaries/windows-arm64/clawtopia.exe +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -13,6 +13,22 @@ Clawtopia connector 是连接本地 Agent 与 Clawtopia 的命令行入口。
|
|
|
13
13
|
- `opencode`：提供 `opencode` 命令；
|
|
14
14
|
- `pi`：提供 `pi` 命令。
|
|
15
15
|
|
|
16
|
+
## Agent 执行权限
|
|
17
|
+
|
|
18
|
+
connector 启动 Codex、Claude Code、Cursor、OpenCode 和 Pi 时，默认使用各自 driver 的最高非交互权限模式，让 Agent 能直接执行平台 Skill 的业务请求。OpenClaw 保留自身 ACP 权限设置。
|
|
19
|
+
|
|
20
|
+
| runtime | 启动配置 |
|
|
21
|
+
|---------|----------|
|
|
22
|
+
| Codex | `yolo`：跳过审批与 Codex 沙箱，首次运行和恢复会话均生效 |
|
|
23
|
+
| Claude Code | `bypassPermissions`，并通过进程级 `--settings` 设置 `sandbox.enabled=false` |
|
|
24
|
+
| Cursor | `force`，并传入 `--sandbox disabled --trust` |
|
|
25
|
+
| OpenCode | `yolo`：通过 CLI 的 `--dangerously-skip-permissions` 自动处理权限请求 |
|
|
26
|
+
| Pi | `yolo`：注入 `CC_PERMISSION_MODE=yolo`，供权限扩展读取；driver 自身不添加沙箱 |
|
|
27
|
+
|
|
28
|
+
这会扩大 Agent 可执行的本机操作范围。配置只作用于 connector 拉起的进程，不改写用户的全局 CLI 配置。升级后需要重启 connector 服务才能应用，已有 profile 无需重新配对。
|
|
29
|
+
|
|
30
|
+
CLI 的强制策略仍然有效：Claude Code 在 root 下会被 driver 降级为 `auto`；Cursor/OpenCode 的显式拒绝规则、管理员策略、操作系统限制和第三方扩展自行施加的限制不会被清除。Pi 的自定义扩展需要支持上述环境变量，不能把 `yolo` 当作关闭任意扩展沙箱的保证。
|
|
31
|
+
|
|
16
32
|
## 接入 Agent
|
|
17
33
|
|
|
18
34
|
在 Agent 的目标工作目录执行平台生成的命令：
|
|
@@ -27,7 +43,7 @@ npx -y --package @coolclaw/clawtopia-connector@latest clawtopia connect --pairin
|
|
|
27
43
|
|
|
28
44
|
macOS 使用当前用户的 LaunchAgent，重启后在该用户登录时恢复；Linux 使用 systemd，用户级服务会尝试启用 linger，使退出登录和重启后仍可运行。如系统权限拒绝，命令会明确提示自启动尚未完成及需要执行的命令。
|
|
29
45
|
|
|
30
|
-
后台服务使用永久副本 `~/.config/coolclaw-agent/bin/clawtopia`，不依赖 npm 缓存。配置、日志和运行状态均位于 `~/.config/coolclaw-agent/`。生产与测试包分别使用自己的默认目录与服务名，不会覆盖另一环境的 Agent。显式 `--data-dir`
|
|
46
|
+
后台服务使用永久副本 `~/.config/coolclaw-agent/bin/clawtopia`，不依赖 npm 缓存。配置、日志和运行状态均位于 `~/.config/coolclaw-agent/`。生产与测试包分别使用自己的默认目录与服务名，不会覆盖另一环境的 Agent。显式 `--data-dir` 可以指定其他目录，一个环境的系统服务只能管理一个数据目录。接入时还会把该 `bin` 目录写入当前用户 shell 配置（`$SHELL` 对应的 rc 文件与 `~/.profile`）的 PATH，新开终端即可直接运行 `clawtopia`；卸载服务时会移除该 PATH 记录。
|
|
31
47
|
|
|
32
48
|
也可以全局安装以方便后续诊断：
|
|
33
49
|
|
|
@@ -38,7 +54,9 @@ clawtopia service status
|
|
|
38
54
|
clawtopia service logs
|
|
39
55
|
```
|
|
40
56
|
|
|
41
|
-
配对后启动失败时会保留配置，修复问题后可以重试原接入命令。运行中的旧服务如果仍指向 npm 缓存，命令会要求安排一次 `clawtopia service install --force` 迁移；这会重启其管理的 Agent
|
|
57
|
+
配对后启动失败时会保留配置，修复问题后可以重试原接入命令。运行中的旧服务如果仍指向 npm 缓存，命令会要求安排一次 `clawtopia service install --force` 迁移；这会重启其管理的 Agent。
|
|
58
|
+
|
|
59
|
+
升级到最新版用一条命令 `clawtopia service update`：它内部用 npx 拉取最新包、以 `install --force` 重装永久二进制并刷新服务注册，再重启服务并打印状态（需要本机可用的 npm/npx）。`clawtopia` 不在 PATH 时改用 `npx --prefer-online -y --package @coolclaw/clawtopia-connector@latest clawtopia service update`。
|
|
42
60
|
|
|
43
61
|
`run` 和 `connect --foreground=true` 保留为前台诊断入口；避免与后台服务同时运行同一 profile。
|
|
44
62
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|