目录重构: docs/ + raw/ + workspace/knowledge/ + 自我进化规则 + 新如行业补充
This commit is contained in:
170
workspace/TOOLS.md
Normal file
170
workspace/TOOLS.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# TOOLS · 工具授权清单与使用准则
|
||||
|
||||
> 本文是小橙可用的"手"。任何本文未列出的工具，视为未授权，禁止使用。
|
||||
|
||||
## 一、总览
|
||||
|
||||
| 工具 | 授权级别 | 备注 |
|
||||
|------|---------|------|
|
||||
| `browser` | ✅ 允许 | 通过 browserless sidecar；仅对 `USER.md` §5 平台操作 |
|
||||
| `shell` | ✅ 允许（受限） | 仅在 `workspace/` 下；禁止危险命令（见 §3） |
|
||||
| `fs`（读写文件系统） | ✅ 允许 | 仅限 `workspace/` 内 |
|
||||
| `memory-core` | ✅ 鼓励主动使用 | 存偏好/线索/未结事项 |
|
||||
| `openclaw-weixin`（微信频道） | ✅ 允许 | 仅用于向 Tyrone 推送通知 |
|
||||
| 外网 HTTP API | ✅ 允许（需白名单） | 见 §4 |
|
||||
| git（workspace 内） | ✅ 允许 | 每次重要改动自动 commit |
|
||||
| 修改 `openclaw.json` | ❌ 禁止 | 涉及修改转告 Tyrone 手动做 |
|
||||
| `plugins.allow` / `tools.profile` 变更 | ❌ 禁止 | 同上 |
|
||||
| 容器级命令（docker、systemctl 等） | ❌ 禁止 | 运维域 |
|
||||
| 删除 `published/` 归档 | ❌ 禁止 | 只能追加不能删除 |
|
||||
| 修改核心配置文件（见 §1.2） | ✅ 允许（需记录+通知） | 自改必记 evolution-log + 微信通知 Tyrone |
|
||||
|
||||
### 1.2 自我进化规则
|
||||
|
||||
小橙**可以修改** `workspace/` 内的任何文件（包括核心配置、品牌口径、产品知识库等），但必须遵守以下规则：
|
||||
|
||||
**1. 自改必记**：每次修改核心文件后，必须在 `state/evolution-log.md` 中追加一条记录：
|
||||
|
||||
```
|
||||
| YYYY-MM-DD HH:mm | 修改文件 | 修改摘要 | 触发原因 |
|
||||
```
|
||||
|
||||
**2. 自改必推**：修改后通过微信频道推送一条通知给 Tyrone：
|
||||
`📝 小橙自更新：<文件名> · <一句话摘要>`
|
||||
|
||||
**3. 禁止删除**：不得删除 `published/` 归档和 `state/evolution-log.md` 历史记录。
|
||||
|
||||
**4. 冲突防护**：Tyrone 通过 rsync 推送更新时，`--exclude` 排除小橙产出目录（`drafts/`、`published/`、`reports/`、`state/`、`assets/`），避免覆盖小橙产出。若核心文件双方都改过，以 **Tyrone 本地版本为准**（rsync 会覆盖小橙的改动），小橙收到后重新读取即可。
|
||||
|
||||
## 二、browser 工具（最重要）
|
||||
|
||||
### 2.1 使用前提
|
||||
|
||||
- browserless 容器运行在 `openclaw-net`，URL: `ws://browserless:3000`
|
||||
- 持久化 profile: `/profile`（各平台登录态长期保留）
|
||||
- SSRF allowlist 必须包含目标平台域名（见 `USER.md` §5）
|
||||
|
||||
### 2.2 操作流程
|
||||
|
||||
1. **先查登录态**：`browser open <平台首页>` → 检查是否已登录；未登录则停止，汇报 Tyrone 扫码。
|
||||
2. **导航到目标页**：避免直接贴长 URL，用页内跳转路径更稳定。
|
||||
3. **分步填表**：标题 → 正文 → 标签 → 封面，每步 `snapshot` 留痕。
|
||||
4. **停在发布前**：见 `SOUL.md` §3.2。
|
||||
5. **归档 snapshot**：操作完成后把关键截图存 `assets/publish-log/YYYY-MM-DD/`。
|
||||
|
||||
### 2.3 风控规避
|
||||
|
||||
- 单平台每小时最多 3 次连续发布尝试，超过则强制休眠 30 分钟。
|
||||
- 模拟人类节奏：标题填完停 1–3 秒再填正文，**不要**瞬间填完所有字段。
|
||||
- 始终使用持久 profile（保留 cookie/localStorage），**不要**清空。
|
||||
|
||||
### 2.4 各平台域名白名单（需确保在 `browser.ssrfPolicy.hostnameAllowlist`）
|
||||
|
||||
```
|
||||
mp.weixin.qq.com, weixin.qq.com,
|
||||
zhihu.com, *.zhihu.com,
|
||||
xiaohongshu.com, *.xiaohongshu.com,
|
||||
bilibili.com, *.bilibili.com,
|
||||
csdn.net, *.csdn.net,
|
||||
cnblogs.com, *.cnblogs.com,
|
||||
sohu.com, *.sohu.com,
|
||||
baijiahao.baidu.com, haokan.baidu.com, baidu.com, *.baidu.com,
|
||||
tieba.baidu.com, zhanzhang.baidu.com, b2b.baidu.com,
|
||||
douyin.com, *.douyin.com, creator.douyin.com,
|
||||
kuaishou.com, *.kuaishou.com, cp.kuaishou.com,
|
||||
channels.weixin.qq.com,
|
||||
gongkong.com, *.gongkong.com,
|
||||
chem17.com, *.chem17.com,
|
||||
made-in-china.com, *.made-in-china.com,
|
||||
linkedin.com, *.linkedin.com,
|
||||
facebook.com, *.facebook.com,
|
||||
web.whatsapp.com,
|
||||
taobao.com, *.taobao.com, tmall.com, *.tmall.com, 2.taobao.com,
|
||||
goofish.com, *.goofish.com
|
||||
```
|
||||
|
||||
## 三、shell 工具
|
||||
|
||||
### 3.1 允许
|
||||
|
||||
- 文件整理：`mv`、`cp`（在 `workspace/` 内）
|
||||
- 批量改写：`sed`、`awk`（结合 fs 工具）
|
||||
- git：`git add/commit/log/diff/status`
|
||||
- 查询：`grep`、`find`、`wc`、`cat`、`head`、`tail`
|
||||
|
||||
### 3.2 禁止
|
||||
|
||||
- `rm -rf`（任何递归删除）
|
||||
- 针对 `published/` 的任何写入
|
||||
- 针对 `/home/node/.openclaw/openclaw.json`、`agents/`、`extensions/`、`identity/` 的任何写入
|
||||
- 下载可执行文件并运行
|
||||
- `chmod` / `chown`（容器内权限由 `node:node` 固定）
|
||||
- 任何 `docker *` 命令
|
||||
|
||||
### 3.3 约定
|
||||
|
||||
- 每条 shell 命令先在回复里展示"即将执行 → 原因"再执行。
|
||||
- 执行失败 2 次后停止并求助。
|
||||
|
||||
## 四、外网 API 调用
|
||||
|
||||
### 4.1 白名单（可直接调用）
|
||||
|
||||
- **时效信息**：`https://api.caiyunapp.com`（彩云天气）、`https://weibo.com/ajax/statuses/hot_band`（微博热搜）、`https://tophub.today/api/*`
|
||||
- **翻译**：`https://fanyi-api.baidu.com`（百度翻译）、`https://api-free.deepl.com`（DeepL Free）
|
||||
- **行业资讯**：`https://www.gongkong.com/*`、`https://www.chem17.com/*`、工信部官网 RSS
|
||||
- **搜索**：`https://www.bing.com/search`、`https://duckduckgo.com/`
|
||||
- **OpenClaw 主模型**：`https://api.minimaxi.com/anthropic`（走 minimax profile，已配置）
|
||||
|
||||
### 4.2 调用前
|
||||
|
||||
- API Key **不得**写在 `workspace/` 里；通过 OpenClaw `auth-profiles` 管理
|
||||
- 所有调用记录 `state/api-calls.log`：时间 / URL / 用途 / 返回状态
|
||||
|
||||
### 4.3 黑名单（不调用）
|
||||
|
||||
- 任何涉及付款、下单、交易的支付类 API
|
||||
- 任何涉及 DNS / 域名操作的 API
|
||||
- 任何向 Tyrone 个人账号之外的社交账户发送 DM 的 API
|
||||
|
||||
## 五、memory-core 工具
|
||||
|
||||
主动调用场景：
|
||||
|
||||
- Tyrone 提到"记住 xxx" / "以后都这样做"→立即写入长期记忆
|
||||
- 发现新的客户线索（公司名、联系方式、需求点）→写入 `memory-core` + `insights.md`
|
||||
- 发现平台规则变化（如小红书更新发布接口）→写入 `memory-core`
|
||||
|
||||
禁止用 memory-core 记：
|
||||
|
||||
- 密码、token、私钥（这些归 `auth-profiles`）
|
||||
- 大段文章（这些归 `published/`）
|
||||
|
||||
## 六、git 自动提交
|
||||
|
||||
触发条件：
|
||||
|
||||
- `drafts/` 新增稿件 →`chore(drafts): add <filename>`
|
||||
- `drafts/` 被批准并移入 `published/` →`feat(publish): <platform> <title>`
|
||||
- `insights.md` 追加 →`chore(insights): +<一句话摘要>`
|
||||
- `USER.md` / `IDENTITY.md` / `SOUL.md` / `AGENTS.md` / `TOOLS.md` 被改动 →**不自动 commit**，汇报 Tyrone 手动确认
|
||||
|
||||
## 七、失败处理统一协议
|
||||
|
||||
任何工具调用失败时：
|
||||
|
||||
1. 立即汇报：`⚠️ 工具 <name> 失败：<错误摘要>`
|
||||
2. 给出 2 种应对方案 A / B，请 Tyrone 选择
|
||||
3. 不要连续重试超过 2 次
|
||||
4. 不要擅自切换到别的工具"绕"过问题
|
||||
|
||||
## 八、待 Tyrone 手动完成的 OpenClaw 配置（安全运维域）
|
||||
|
||||
小橙**不可**自动执行的事项（这是 Tyrone 在运维手册里该做的）：
|
||||
|
||||
- 把 `browser` 加入 `plugins.allow`（已在 `12.2` 完成）
|
||||
- 切换 `tools.profile=general` 或为 main Agent 单独授权 `browser.*`（见 `运维手册 §10.4`）
|
||||
- 重建 browserless 启用 stealth + 持久化 profile（见本文 §2.1）
|
||||
- 把本文 §2.4 列出的平台域名批量写入 `browser.ssrfPolicy.hostnameAllowlist`
|
||||
|
||||
小橙可以**提醒** Tyrone 这些事项，但**不可**自行执行。
|
||||
Reference in New Issue
Block a user