From 3b5868d79f02098ea0f3efd457a826e84ee8dfe0 Mon Sep 17 00:00:00 2001 From: karuo Date: Fri, 13 Mar 2026 15:42:52 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=84=20=E5=8D=A1=E8=8B=A5AI=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=202026-03-13=2015:42=20|=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=EF=BC=9A=E6=B0=B4=E6=A1=A5=E5=B9=B3=E5=8F=B0=E5=AF=B9=E6=8E=A5?= =?UTF-8?q?=E3=80=81=E5=8D=A1=E6=9C=A8=E3=80=81=E8=BF=90=E8=90=A5=E4=B8=AD?= =?UTF-8?q?=E6=9E=A2=E3=80=81=E8=BF=90=E8=90=A5=E4=B8=AD=E6=9E=A2=E5=8F=82?= =?UTF-8?q?=E8=80=83=E8=B5=84=E6=96=99=E3=80=81=E8=BF=90=E8=90=A5=E4=B8=AD?= =?UTF-8?q?=E6=9E=A2=E5=B7=A5=E4=BD=9C=E5=8F=B0=20|=20=E6=8E=92=E9=99=A4?= =?UTF-8?q?=20>20MB:=2011=20=E4=B8=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 02_卡人（水）/水桥_平台对接/接收短信/SKILL.md | 44 ++++- .../木叶_视频内容/视频切片/脚本/visual_enhance.py | 8 +- .../10、使用手册/OpenClaw控制台/01-系统概述.md | 74 ++++++++ .../10、使用手册/OpenClaw控制台/02-快速入门.md | 77 +++++++++ .../OpenClaw控制台/03-界面与基础操作.md | 68 ++++++++ .../OpenClaw控制台/04-模型与Provider配置.md | 81 +++++++++ .../OpenClaw控制台/05-飞书与CloudBoot集成.md | 74 ++++++++ .../10、使用手册/OpenClaw控制台/06-常见问题.md | 77 +++++++++ .../10、使用手册/OpenClaw控制台/README.md | 33 ++++ 开发文档/10、使用手册/README.md | 24 +++ 运营中枢/scripts/smsonline_receive_sms.py | 158 +++++++++++++++++ .../参考资料/smsonline_付费接码平台_API参考.md | 159 ++++++++++++++++++ 运营中枢/工作台/gitea_push_log.md | 1 + 运营中枢/工作台/代码管理.md | 1 + 14 files changed, 871 insertions(+), 8 deletions(-) create mode 100644 开发文档/10、使用手册/OpenClaw控制台/01-系统概述.md create mode 100644 开发文档/10、使用手册/OpenClaw控制台/02-快速入门.md create mode 100644 开发文档/10、使用手册/OpenClaw控制台/03-界面与基础操作.md create mode 100644 开发文档/10、使用手册/OpenClaw控制台/04-模型与Provider配置.md create mode 100644 开发文档/10、使用手册/OpenClaw控制台/05-飞书与CloudBoot集成.md create mode 100644 开发文档/10、使用手册/OpenClaw控制台/06-常见问题.md create mode 100644 开发文档/10、使用手册/OpenClaw控制台/README.md create mode 100644 开发文档/10、使用手册/README.md create mode 100644 运营中枢/scripts/smsonline_receive_sms.py create mode 100644 运营中枢/参考资料/smsonline_付费接码平台_API参考.md diff --git a/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md b/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md index 07640fde..ad1cbedd 100644 --- a/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md +++ b/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md @@ -97,8 +97,44 @@ SMS: [PUBG] code: 697881. Valid for 3 minutes. --- -## 六、参考资料与扩展 +## 六、付费接码平台（SMSOnline · 推荐用于注册） -- **流程史记**：`运营中枢/参考资料/giffgaff发短信收短信_流程史记.md`（giffgaff 发短信到临时号时的操作与保号）。 -- **接码操作说明**：`运营中枢/参考资料/receivesms收短信_操作.md`（命令行用法摘要）。 -- **扩展**：若需按「发件人名字」或关键词过滤短信，可在本目录下扩展脚本（解析 `from-link` 或短信内容），并在本 SKILL 更新「要获取的网站短信类型」说明。 +### 6.1 平台信息 + +- **网站**：[premium.smsonline.cloud](https://premium.smsonline.cloud) / [smsonline.io](https://smsonline.io) +- **API 参考**：`运营中枢/参考资料/smsonline_付费接码平台_API参考.md` +- **API Key**：`2w9hva2mzvbubw5sj3vqwkuv9ib43ku29okhwyragkx4o2kgzw7eb9oy8pjh4gc3` + +### 6.2 脚本与用法 + +```bash +cd /Users/karuo/Documents/个人/卡若AI/运营中枢/scripts + +# 查看支持的国家 +python3 smsonline_receive_sms.py --list-countries + +# 查看支持的服务（Soul、bilibili 等） +python3 smsonline_receive_sms.py --list-services + +# 查看某国+某服务的可用号码与价格 +python3 smsonline_receive_sms.py --country-id 1 --service-id 2 --products + +# 完整流程：取号 → 轮询收验证码（最多 2 分钟）→ 超时自动退费 +python3 smsonline_receive_sms.py --country-id 1 --service-id 2 +``` + +### 6.3 防扣费规则（强制） + +1. 轮询 get-sms 最多 **120 秒**，超时 → 自动调 `change-status(status=4)` 取消退费。 +2. 收到验证码并使用后 → 调 `change-status(status=3)` 确认完成。 +3. 不重复获取同一号：先取消旧订单再取新号。 +4. 首次调试加 `&test=1` 不扣费。 + +--- + +## 七、参考资料与扩展 + +- **giffgaff 流程史记**：`运营中枢/参考资料/giffgaff发短信收短信_流程史记.md` +- **receivesms 免费接码**：`运营中枢/参考资料/receivesms收短信_操作.md` +- **SMSOnline 付费接码 API**：`运营中枢/参考资料/smsonline_付费接码平台_API参考.md` +- **扩展**：若需按「发件人名字」或关键词过滤短信，可在本目录下扩展脚本。 diff --git a/03_卡木（木）/木叶_视频内容/视频切片/脚本/visual_enhance.py b/03_卡木（木）/木叶_视频内容/视频切片/脚本/visual_enhance.py index e89761f6..2cd3cfa7 100644 --- a/03_卡木（木）/木叶_视频内容/视频切片/脚本/visual_enhance.py +++ b/03_卡木（木）/木叶_视频内容/视频切片/脚本/visual_enhance.py @@ -39,10 +39,10 @@ PANEL_Y = VH - PANEL_H - 30 FPS = 8 CURRENT_SEED = "default" -GLASS_TOP = (12, 15, 26, 248) -GLASS_BTM = (8, 10, 20, 252) -GLASS_BORDER = (255, 255, 255, 26) -GLASS_INNER = (255, 255, 255, 12) +GLASS_TOP = (10, 12, 22, 230) +GLASS_BTM = (6, 8, 16, 230) +GLASS_BORDER = (255, 255, 255, 18) +GLASS_INNER = (255, 255, 255, 8) SOUL_GREEN = (0, 210, 106) ACCENT_A = (0, 200, 140, 255) diff --git a/开发文档/10、使用手册/OpenClaw控制台/01-系统概述.md b/开发文档/10、使用手册/OpenClaw控制台/01-系统概述.md new file mode 100644 index 00000000..d9e0adac --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/01-系统概述.md @@ -0,0 +1,74 @@ +## 01 系统概述 + +> [OpenClaw 控制台使用手册](README.md) > 系统概述 + +--- + +## 1.1 OpenClaw/Cloud Boot 在本机中的角色 + +OpenClaw 控制台可以理解为一层「本地 AI 网关 + 控制台」： + +- 向上：对接飞书、Cloud Boot（卡若消息中枢）、浏览器等「前端入口」。 +- 中间：作为 **统一网关**，负责会话管理、通道路由、使用量统计。 +- 向下：调用本机 **Ollama** 或云端 API（如 v0，间接使用 Claude 等模型）。 + +在你当前的配置中： + +- 主模型为 **`ollama/qwen2.5:3b`**（本机小模型），Provider 为 `ollama`。 +- 网关监听在本机 **18789 端口**。 +- 所有「通过 OpenClaw 的对话」最终都会落到本机 Ollama 或其他你配置的 Provider。 + +--- + +## 1.2 核心组件与数据流 + +整体数据流可以简化为三层： + +1. **入口层（Client）** + - 浏览器打开 `http://127.0.0.1:18789/config` 的控制面板进行对话。 + - 飞书/Cloud Boot 通过 `feishu_openclaw_bridge.py` 转发消息到网关。 + +2. **网关层（OpenClaw Gateway）** + - 进程来源：Docker 容器或 `openclaw gateway start` 命令。 + - 端口：`18789`。 + - 职责： + - 管理会话与对话历史； + - 按配置选择 Provider（如 `ollama`、`v0`）和具体模型； + - 记录使用情况（tokens、费用等，视 Provider 能力而定）。 + +3. **模型层（Providers）** + - 本机 Provider：`ollama`（`http://localhost:11434`），模型如 `qwen2.5:3b`。 + - 备选 Provider：`v0` 等云端 API（如启用）。 + +--- + +## 1.3 配置文件与持久化位置 + +关键配置写在本机用户目录下： + +| 项目 | 位置 | 说明 | +|------|------|------| +| OpenClaw 主配置 | `~/.openclaw/openclaw.json` | 包含网关端口、默认 Provider、默认模型等。 | +| clawdbot 源码 | `开发/8、小工具/clawdbot` | 包含 UI 前端、飞书桥接脚本等。 | +| 飞书桥接脚本 | `feishu_openclaw_bridge.py` | 将飞书消息转成 OpenClaw 可理解的请求。 | + +网关重启不会丢失配置，因为主要设置保存在上述配置文件中。 + +--- + +## 1.4 与卡若AI/Cloud Boot 的关系 + +- 卡若AI 是「大脑与规则集合」； +- OpenClaw 是「本地网关与路由器」； +- Cloud Boot/飞书机器人是「对外入口」。 + +典型链路可以描述为： + +> 飞书消息/Cloud Boot → `feishu_openclaw_bridge.py` → OpenClaw 网关（18789） → Provider（Ollama/qwen2.5:3b 或 v0）→ 返回结果 → 飞书/Cloud Boot 展示 + +--- + +上一篇：无 | 下一篇：[02 快速入门](02-快速入门.md) + +返回 [章节目录](README.md) + diff --git a/开发文档/10、使用手册/OpenClaw控制台/02-快速入门.md b/开发文档/10、使用手册/OpenClaw控制台/02-快速入门.md new file mode 100644 index 00000000..06e9890b --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/02-快速入门.md @@ -0,0 +1,77 @@ +## 02 快速入门 + +> [OpenClaw 控制台使用手册](README.md) > 快速入门 + +--- + +## 2.1 前置条件检查 + +在使用前，请确保： + +| 项目 | 要求 | 检查方法 | +|------|------|----------| +| 操作系统 | macOS（当前本机环境） | 无需额外操作 | +| clawdbot 仓库 | 已存在 | 路径为 `开发/8、小工具/clawdbot` | +| 网关 | 已经在 18789 端口运行（推荐） | 访问 `http://127.0.0.1:18789/health` 应返回 200 | +| Ollama | 已安装并运行 | 终端执行 `curl -s http://localhost:11434/api/tags` 能返回模型列表 | + +--- + +## 2.2 启动网关与控制面板 + +有两种常见方式： + +### 方式一：使用已有网关（推荐） + +1. 确认网关已启动（Docker 或其他方式）。 +2. 在终端或 Spotlight 中打开控制面板： + + ```bash + open http://127.0.0.1:18789/config + ``` + +3. 浏览器中应出现 OpenClaw 控制台首页。 + +### 方式二：使用 openclaw 命令启动网关 + +当 18789 端口没有服务时，可以手动启动： + +```bash +openclaw gateway start +# 或指定端口（如需）： +openclaw gateway --port 18789 +``` + +然后浏览器访问： + +```text +http://127.0.0.1:18789/config +``` + +--- + +## 2.3 验证 AI 模型是否可用 + +1. 在浏览器中打开控制面板。 +2. 新建一个会话，发送一条简单消息，例如： + - “你现在使用的是哪个模型？” +3. 若返回正常回答且使用量统计中可以看到 `provider: ollama`、`model: ollama/qwen2.5:3b`，说明当前本地模型工作正常。 + +如对模型有疑问，可在后续章节中查看「模型与 Provider 配置」。 + +--- + +## 2.4 常用地址速查 + +| 功能 | 地址 | +|------|------| +| 控制面板 | `http://127.0.0.1:18789/config` | +| 健康检查 | `http://127.0.0.1:18789/health` | +| 飞书桥接状态（若启用） | `http://127.0.0.1:8888/` | + +--- + +上一篇：[01 系统概述](01-系统概述.md) | 下一篇：[03 界面与基础操作](03-界面与基础操作.md) + +返回 [章节目录](README.md) + diff --git a/开发文档/10、使用手册/OpenClaw控制台/03-界面与基础操作.md b/开发文档/10、使用手册/OpenClaw控制台/03-界面与基础操作.md new file mode 100644 index 00000000..552c5b30 --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/03-界面与基础操作.md @@ -0,0 +1,68 @@ +## 03 界面与基础操作 + +> [OpenClaw 控制台使用手册](README.md) > 界面与基础操作 + +--- + +## 3.1 控制面板首页结构 + +打开 `http://127.0.0.1:18789/config` 后，主要区域通常包括： + +| 区域 | 作用 | +|------|------| +| 左侧导航栏 | 切换「聊天」「概述」「频道」「会话」「技能」「配置」「日志」等模块。 | +| 上方会话栏 | 显示当前选中的会话和快速切换入口。 | +| 右侧主区域 | 展示聊天内容、使用统计、配置表单等。 | + +不同版本 UI 会略有差异，但核心导航和模块名称基本一致。 + +--- + +## 3.2 聊天模块 + +1. 在左侧选择「聊天」或类似入口。 +2. 右侧主区域显示消息记录与输入框。 +3. 常用操作： + - 输入消息并回车发送； + - 重命名会话； + - 在使用统计中查看当前会话的 Provider 与模型。 + +> 提示：如果你想确认当前对话走的是本地 Ollama，留意使用信息中的 `provider: ollama` 和 `model: ollama/qwen2.5:3b`。 + +--- + +## 3.3 配置模块（Models） + +1. 左侧进入「配置」→「Models」（AI 模型配置与提供商）。 +2. 在这里你可以： + - 查看当前默认 Provider 和默认模型； + - 为不同 Provider（如 `ollama`、`v0`）配置 baseUrl、API Key 等； + - 设置主模型与备用模型。 + +详细的模型配置说明见「04 模型与 Provider 配置」。 + +--- + +## 3.4 频道与技能模块（与 Cloud Boot/飞书相关） + +1. 「频道」模块：配置不同来源的消息通道，例如飞书、Cloud Boot 等。 +2. 「技能」模块：启用或禁用某些技能脚本、查看技能状态。 + +这些模块与 `feishu_openclaw_bridge.py` 和 Cloud Boot 的集成配合使用，具体操作在「05 飞书与 Cloud Boot 集成」中说明。 + +--- + +## 3.5 日志与排查入口 + +1. 在左侧选择「日志」或类似入口，可以查看网关运行时的错误和请求记录。 +2. 当出现模型调用失败、Provider 报错等问题时，优先查看这里的最新日志行，以快速定位是： + - Provider 配置问题； + - 网络或 API Key 问题； + - 本机 Ollama 未启动等。 + +--- + +上一篇：[02 快速入门](02-快速入门.md) | 下一篇：[04 模型与 Provider 配置](04-模型与Provider配置.md) + +返回 [章节目录](README.md) + diff --git a/开发文档/10、使用手册/OpenClaw控制台/04-模型与Provider配置.md b/开发文档/10、使用手册/OpenClaw控制台/04-模型与Provider配置.md new file mode 100644 index 00000000..8c40bc34 --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/04-模型与Provider配置.md @@ -0,0 +1,81 @@ +## 04 模型与 Provider 配置 + +> [OpenClaw 控制台使用手册](README.md) > 模型与 Provider 配置 + +--- + +## 4.1 当前默认模型与 Provider（本机状态） + +根据 `clawdbot/references/Claw中Ollama配置说明.md`，当前本机默认配置为： + +| 项 | 值 | +|----|----| +| 主模型 | `ollama/qwen2.5:3b` | +| Provider | 内置 `ollama`（本机 `http://localhost:11434`） | +| 认证方式 | `auth.profiles["ollama:local"]`，`mode: "api_key"` | +| 配置文件 | `~/.openclaw/openclaw.json` | + +本机已存在模型：`qwen2.5:1.5b`、`qwen2.5:3b`、`nomic-embed-text:latest`，默认用 `qwen2.5:3b`。 + +--- + +## 4.2 在控制面板中切换 Ollama 模型 + +1. 打开 `http://127.0.0.1:18789/config`。 +2. 左侧进入「配置」→「Models」。 +3. 在「代理默认模型」处选择或填写其中一种： + - `ollama/qwen2.5:3b`（当前默认） + - `ollama/qwen2.5:1.5b` + - `ollama/nomic-embed-text:latest`（一般用于嵌入，不建议当主对话模型） +4. 保存配置，新建的会话将使用新模型。 + +> 注意：如果在会话中没有立刻感知到变化，请新建会话再测试。 + +--- + +## 4.3 确保 Ollama 服务运行 + +如果模型调用失败，首先确认 Ollama 是否在本机运行： + +```bash +curl -s http://localhost:11434/api/tags +``` + +预期结果：返回一个包含模型列表的 JSON。如果无返回或报错： + +- 尝试从启动项中打开 Ollama 应用； +- 或在菜单中选择「Open Ollama」并确认服务已启动。 + +--- + +## 4.4 配置 v0/Claude 作为备选 Provider（可选） + +当你希望在本地模型之外，保留一个云端模型作为后备时，可以添加 v0 Provider： + +1. 在控制面板「配置」→「Models」中新增一个 Provider： + - 基础 URL：`https://api.v0.dev/v1` + - 模型 ID：`v0-1.5-md` 或 `v0-1.5-lg`（不要再使用 `v0-1.0-md`） + - API 密钥：你的 v0 secret。 +2. 将该 Provider 标记为 **fallback**，而主 Provider 仍保持为 `ollama` 的 `qwen2.5:3b`。 + +数据流将变为： + +- 正常情况下优先使用本机 `ollama/qwen2.5:3b`。 +- 当本机调用失败时，由网关自动尝试 fallback Provider（如 v0，对接 Claude 等）。 + +--- + +## 4.5 常见配置错误与排查 + +| 症状 | 可能原因 | 排查建议 | +|------|----------|----------| +| 所有对话都报超时或 500 | Ollama 未启动，或 baseUrl 配错 | 使用 `curl` 测本机接口；检查 `~/.openclaw/openclaw.json` 中的 Provider 配置。 | +| 仅部分会话报错 | 某个 Provider 或模型配置不完整 | 在「配置 → Models」中检查该 Provider 的 baseUrl、API Key、模型 ID。 | +| 使用量统计中 Provider 一直是 unknown | 会话未正确记录 Provider 字段 | 升级 OpenClaw 版本或检查日志，确认请求是否被中间层改写。 | + +--- + +上一篇：[03 界面与基础操作](03-界面与基础操作.md) | 下一篇：[05 飞书与 Cloud Boot 集成](05-飞书与CloudBoot集成.md) + +返回 [章节目录](README.md) + diff --git a/开发文档/10、使用手册/OpenClaw控制台/05-飞书与CloudBoot集成.md b/开发文档/10、使用手册/OpenClaw控制台/05-飞书与CloudBoot集成.md new file mode 100644 index 00000000..6b20e1a6 --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/05-飞书与CloudBoot集成.md @@ -0,0 +1,74 @@ +## 05 飞书与 Cloud Boot 集成 + +> [OpenClaw 控制台使用手册](README.md) > 飞书与 Cloud Boot 集成 + +--- + +## 5.1 集成目标 + +本部分说明 Cloud Boot/飞书 发送的一条消息，如何通过本机的 OpenClaw 网关与 Ollama 模型完成应答： + +> 飞书/Cloud Boot → `feishu_openclaw_bridge.py` → OpenClaw 网关（18789）→ Provider（Ollama/qwen2.5:3b 或其他）→ 返回结果 → 飞书/Cloud Boot 展示 + +这样，外部看到的是 Cloud Boot/飞书机器人，实际「大脑」运行在本机 OpenClaw + Ollama 上。 + +--- + +## 5.2 关键组件与文件 + +| 组件 | 位置 | 作用 | +|------|------|------| +| 飞书桥接脚本 | `开发/8、小工具/clawdbot/feishu_openclaw_bridge.py` | 接收飞书回调，转发到 OpenClaw 网关。 | +| 一键启动脚本 | `开发/8、小工具/clawdbot/start_feishu_frpc.sh` | 启动飞书桥接服务与 frpc。 | +| frpc 配置 | `开发/8、小工具/clawdbot/frp_tunnel/client/frpc.toml` | 配置内网穿透，将本机服务暴露给 Cloud Boot/外网。 | +| OpenClaw 网关 | `http://127.0.0.1:18789/` | 统一对接 Provider 的网关。 | + +--- + +## 5.3 启动飞书桥接与 frpc + +在本机终端执行： + +```bash +cd /Users/karuo/Documents/开发/8、小工具/clawdbot +./start_feishu_frpc.sh +``` + +脚本会完成： + +1. 启动一个 FastAPI/Uvicorn 服务，运行 `feishu_openclaw_bridge.py`； +2. 启动 `frpc`，根据 `frpc.toml` 将本机端口映射到外网，以便 Cloud Boot/飞书可以访问。 + +> 注意：首次使用前需要根据你的服务器与域名情况，正确填写 `frpc.toml` 与飞书应用配置（回调 URL 等）。 + +--- + +## 5.4 消息流转示意 + +以一条来自飞书的消息为例： + +1. 用户在飞书/Cloud Boot 中发送消息； +2. 飞书服务器将消息 POST 到你配置的回调 URL； +3. 该 URL 实际指向 `feishu_openclaw_bridge.py` 提供的 HTTP 接口； +4. 桥接脚本将消息转换为 OpenClaw 支持的请求格式（会话 ID、角色、文本等）； +5. 请求发送到本机 `http://127.0.0.1:18789` 的 OpenClaw 网关； +6. 网关根据当前模型配置，将请求路由到 Provider（默认是 `ollama/qwen2.5:3b`）； +7. 得到回复后，网关将结果返回给桥接脚本，再由桥接脚本回传给飞书； +8. 最终，用户在 Cloud Boot/飞书中看到 AI 的回复。 + +--- + +## 5.5 常见问题与排查建议 + +| 症状 | 可能原因 | 排查建议 | +|------|----------|----------| +| 飞书回调 500 或超时 | 桥接服务未启动或端口被防火墙拦截 | 确认 `start_feishu_frpc.sh` 是否运行；检查本机 8888 端口和 frpc 日志。 | +| 飞书提示签名错误 | 飞书应用密钥或校验 Token 配置不一致 | 对照飞书开发者后台，检查 `feishu_openclaw_bridge.py` 中的配置。 | +| Cloud Boot 能打开界面但无回复 | OpenClaw 18789 未运行或 Provider 报错 | 访问 `http://127.0.0.1:18789/health`；查看 OpenClaw 日志与模型配置。 | + +--- + +上一篇：[04 模型与 Provider 配置](04-模型与Provider配置.md) | 下一篇：[06 常见问题（FAQ）](06-常见问题.md) + +返回 [章节目录](README.md) + diff --git a/开发文档/10、使用手册/OpenClaw控制台/06-常见问题.md b/开发文档/10、使用手册/OpenClaw控制台/06-常见问题.md new file mode 100644 index 00000000..4cc807df --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/06-常见问题.md @@ -0,0 +1,77 @@ +## 06 常见问题（FAQ） + +> [OpenClaw 控制台使用手册](README.md) > 常见问题（FAQ） + +--- + +## 6.1 控制面板打不开怎么办？ + +**现象**：访问 `http://127.0.0.1:18789/config` 显示无法连接。 + +可能原因与处理： + +| 原因 | 处理方式 | +|------|----------| +| 网关未启动 | 按「02 快速入门」中的方式启动网关：`openclaw gateway start` 或启动相关 Docker 容器。 | +| 端口被占用或改动 | 确认实际网关端口（例如配置为其他端口），按实际端口访问；或调整为 18789。 | +| 本机防火墙限制 | 临时关闭或放行本地 18789 端口后重试。 | + +--- + +## 6.2 对话返回 500 或报错信息 + +**现象**：在控制面板中对话报 500，或 Cloud Boot 上看到「系统错误」。 + +排查顺序： + +1. 查看 OpenClaw 的「日志」模块，找到最近一条错误。 +2. 根据错误信息判断是 Provider 报错还是网关自身异常。 +3. 若是 v0 相关错误： + - 检查 baseUrl 是否为 `https://api.v0.dev/v1`； + - 检查模型 ID 是否为 `v0-1.5-md` 或 `v0-1.5-lg`； + - 检查 API Key 是否有效，Billing/配额是否正常。 +4. 若是 Ollama 报错： + - 使用 `curl -s http://localhost:11434/api/tags` 确认服务与模型是否正常。 + +--- + +## 6.3 模型似乎没变，仍然是旧模型 + +**现象**：在「配置 → Models」中修改了默认模型，但对话中感觉没变化。 + +处理方式： + +- 修改默认模型后，**新建一个会话** 测试； +- 在使用统计或调试信息中确认 `model:` 字段是否为预期值； +- 如仍无变化，检查 `~/.openclaw/openclaw.json` 中是否有覆盖默认配置的字段。 + +--- + +## 6.4 飞书/Cloud Boot 收不到回复 + +**现象**：Cloud Boot/飞书消息发送成功，但长时间没有任何回复。 + +排查建议： + +1. 确认 `start_feishu_frpc.sh` 是否已执行，桥接服务是否在运行； +2. 在浏览器访问 `http://127.0.0.1:8888/`（若有提供状态页）查看桥接健康状态； +3. 检查 frpc 日志，确认外网穿透是否正常； +4. 检查飞书开发者后台中配置的回调 URL 与签名设置是否与本地配置匹配； +5. 在 OpenClaw 日志中查看是否有收到对应请求。 + +--- + +## 6.5 如何确认当前到底用的是本机小模型还是云端模型？ + +- 在控制面板中查看会话的使用信息： + - 若显示 `provider: ollama` 且 `model: ollama/qwen2.5:3b`，则在用本机小模型。 + - 若显示 v0 或其他云端 Provider，则为云端模型。 +- 也可以直接在对话中提问，例如： + - “你当前使用的 Provider 和模型名称是什么？” + +--- + +上一篇：[05 飞书与 Cloud Boot 集成](05-飞书与CloudBoot集成.md) | 下一篇：无 + +返回 [章节目录](README.md) + diff --git a/开发文档/10、使用手册/OpenClaw控制台/README.md b/开发文档/10、使用手册/OpenClaw控制台/README.md new file mode 100644 index 00000000..049880ea --- /dev/null +++ b/开发文档/10、使用手册/OpenClaw控制台/README.md @@ -0,0 +1,33 @@ +## OpenClaw 控制台使用手册 + +**版本**：v1.0 | **更新日期**：2026年3月 | **适用环境**：本机 macOS + Docker/OpenClaw 网关 + Ollama + +> 本手册介绍本地 OpenClaw 控制台（Cloud Boot）的工作原理、启动方式、模型配置、与飞书/Cloud Boot 的集成和常见问题。 + +--- + +## 章节目录 + +| 编号 | 章节 | 文件 | 说明 | +|------|------|------|------| +| 01 | 系统概述 | [01-系统概述.md](01-系统概述.md) | OpenClaw 的角色、组件与整体架构 | +| 02 | 快速入门 | [02-快速入门.md](02-快速入门.md) | 启动网关与控制台、基本健康检查 | +| 03 | 界面与基础操作 | [03-界面与基础操作.md](03-界面与基础操作.md) | 控制台主要页面与常用操作说明 | +| 04 | 模型与 Provider 配置 | [04-模型与Provider配置.md](04-模型与Provider配置.md) | Ollama、本地模型与 v0/云端模型配置 | +| 05 | 飞书与 Cloud Boot 集成 | [05-飞书与CloudBoot集成.md](05-飞书与CloudBoot集成.md) | 飞书桥接脚本、frpc 与 Cloud Boot 调用链路 | +| 06 | 常见问题（FAQ） | [06-常见问题.md](06-常见问题.md) | 启动失败、模型报错、HTTP 500 等排查 | + +--- + +## 系统访问入口与支持 + +- 控制面板入口：`http://127.0.0.1:18789/config` +- 健康检查：`http://127.0.0.1:18789/health` +- 本地项目路径：`开发/8、小工具/clawdbot` + +如需扩展本手册（新增章节/截图），请遵守 `usage-manual-writer` 的目录与命名规范。 + +--- + +返回 [使用手册总目录](../README.md) + diff --git a/开发文档/10、使用手册/README.md b/开发文档/10、使用手册/README.md new file mode 100644 index 00000000..d606cb6b --- /dev/null +++ b/开发文档/10、使用手册/README.md @@ -0,0 +1,24 @@ +## 使用手册总目录 + +> 本目录汇总卡若AI 相关系统的使用手册入口。 + +**版本**：v1.0.0 | **更新日期**：2026年3月 + +--- + +## 系统列表 + +| 系统 | 手册目录 | 说明 | +|------|----------|------| +| OpenClaw 控制台（Cloud Boot） | [OpenClaw控制台/README.md](OpenClaw控制台/README.md) | 本地 AI 网关与控制台，用于统一管理模型与通道（含 Cloud Boot/飞书桥接）。 | + +--- + +## 手册编写规范（摘要） + +- 每个系统使用独立子目录（如 `OpenClaw控制台/`）。 +- 每个目录必须包含 `README.md` 作为章节索引。 +- 章节文件统一使用 `{两位数}-{章节名}.md` 命名，如 `01-系统概述.md`。 +- 内容中优先使用表格描述配置项、字段和状态说明。 +- 截图统一放在上级目录的 `截图/` 中，通过相对路径引用。 + diff --git a/运营中枢/scripts/smsonline_receive_sms.py b/运营中枢/scripts/smsonline_receive_sms.py new file mode 100644 index 00000000..75592ed6 --- /dev/null +++ b/运营中枢/scripts/smsonline_receive_sms.py @@ -0,0 +1,158 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +SMSOnline 付费接码自动化脚本：取号 → 轮询收验证码 → 超时自动退号。 +用法： + python3 smsonline_receive_sms.py --country 中国 --service Soul + python3 smsonline_receive_sms.py --country-id 1 --service-id 2 + python3 smsonline_receive_sms.py --list-countries + python3 smsonline_receive_sms.py --list-services +""" +import json +import sys +import time +import urllib.request +import argparse + +API_KEY = "2w9hva2mzvbubw5sj3vqwkuv9ib43ku29okhwyragkx4o2kgzw7eb9oy8pjh4gc3" +BASE = "https://smsonline.io/api/v1/virtual-number" +TIMEOUT_SEC = 120 +POLL_INTERVAL = 5 +PROXY = None # 如需代理："http://127.0.0.1:7897" + + +def api(endpoint, **params): + params["apiKey"] = API_KEY + qs = "&".join(f"{k}={v}" for k, v in params.items()) + url = f"{BASE}/{endpoint}?{qs}" + req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"}) + if PROXY: + handler = urllib.request.ProxyHandler({"https": PROXY, "http": PROXY}) + opener = urllib.request.build_opener(handler) + else: + opener = urllib.request.build_opener() + with opener.open(req, timeout=20) as r: + data = json.loads(r.read().decode("utf-8")) + if data.get("status") == -1: + print(f"API ERROR: {data}", file=sys.stderr) + return data + + +def list_countries(): + data = api("get-countries") + if isinstance(data, dict) and "data" in data: + for c in data["data"]: + print(f" {c.get('id', '?')}\t{c.get('name', '?')}") + else: + print(json.dumps(data, indent=2, ensure_ascii=False)) + + +def list_services(): + data = api("get-services") + if isinstance(data, dict) and "data" in data: + for s in data["data"]: + print(f" {s.get('id', '?')}\t{s.get('name', '?')}") + else: + print(json.dumps(data, indent=2, ensure_ascii=False)) + + +def get_products(country_id, service_id): + data = api("get-products", countryId=country_id, serviceId=service_id) + if isinstance(data, dict) and "data" in data: + for p in data["data"]: + print(f" operator={p.get('operatorId','?')} price={p.get('price','?')} stock={p.get('count','?')}") + else: + print(json.dumps(data, indent=2, ensure_ascii=False)) + return data + + +def buy_number(country_id, service_id, operator_id): + data = api("buy-service", countryId=country_id, serviceId=service_id, operatorId=operator_id) + return data + + +def get_sms(order_id): + data = api("get-sms", id=order_id) + return data + + +def cancel_order(order_id): + data = api("change-status", id=order_id, status=4) + return data + + +def finish_order(order_id): + data = api("change-status", id=order_id, status=3) + return data + + +def receive_sms_flow(country_id, service_id, operator_id=None): + """完整流程：买号→轮询→超时退号。""" + if not operator_id: + prod = api("get-products", countryId=country_id, serviceId=service_id) + if isinstance(prod, dict) and "data" in prod and prod["data"]: + operator_id = prod["data"][0].get("operatorId", 0) + price = prod["data"][0].get("price", "?") + print(f"选择运营商 {operator_id}，价格 {price}") + else: + print("无可用运营商/库存", file=sys.stderr) + return None, None + print(f"正在购买号码（country={country_id}, service={service_id}, operator={operator_id}）…") + buy = buy_number(country_id, service_id, operator_id) + order_id = buy.get("data", {}).get("id") or buy.get("id") + number = buy.get("data", {}).get("number") or buy.get("number") + if not order_id: + print(f"购买失败：{buy}", file=sys.stderr) + return None, None + print(f"号码：{number} 订单：{order_id}") + print(f"请在目标网站用该号码发验证码，轮询中（最多 {TIMEOUT_SEC} 秒）…", flush=True) + start = time.time() + code = None + while time.time() - start < TIMEOUT_SEC: + time.sleep(POLL_INTERVAL) + elapsed = int(time.time() - start) + sms = get_sms(order_id) + sms_text = sms.get("data", {}).get("sms") or sms.get("sms") + sms_code = sms.get("data", {}).get("code") or sms.get("code") + if sms_text or sms_code: + code = sms_code or sms_text + print(f"\n收到验证码！({elapsed}s)") + print(f" 号码：{number}") + print(f" 验证码/短信：{code}") + finish_order(order_id) + print(" 订单已标记完成。") + return number, code + print(f" 等待中 {elapsed}s…", flush=True) + print(f"\n超时 {TIMEOUT_SEC}s 未收到验证码，正在取消退费…") + cancel_order(order_id) + print(" 订单已取消（退费）。") + return number, None + + +def main(): + p = argparse.ArgumentParser(description="SMSOnline 付费接码") + p.add_argument("--list-countries", action="store_true") + p.add_argument("--list-services", action="store_true") + p.add_argument("--country-id", type=int) + p.add_argument("--service-id", type=int) + p.add_argument("--operator-id", type=int, default=None) + p.add_argument("--products", action="store_true") + p.add_argument("--proxy", default=None, help="如 http://127.0.0.1:7897") + args = p.parse_args() + global PROXY + if args.proxy: + PROXY = args.proxy + if args.list_countries: + list_countries() + elif args.list_services: + list_services() + elif args.products and args.country_id and args.service_id: + get_products(args.country_id, args.service_id) + elif args.country_id and args.service_id: + receive_sms_flow(args.country_id, args.service_id, args.operator_id) + else: + p.print_help() + + +if __name__ == "__main__": + main() diff --git a/运营中枢/参考资料/smsonline_付费接码平台_API参考.md b/运营中枢/参考资料/smsonline_付费接码平台_API参考.md new file mode 100644 index 00000000..169783d9 --- /dev/null +++ b/运营中枢/参考资料/smsonline_付费接码平台_API参考.md @@ -0,0 +1,159 @@ +# SMSOnline 付费接码平台 · API 参考文档 + +> 平台：premium.smsonline.cloud / smsonline.io +> API Key：`2w9hva2mzvbubw5sj3vqwkuv9ib43ku29okhwyragkx4o2kgzw7eb9oy8pjh4gc3` +> 更新：2026-03-13 +> 来源：[smsonline.io/api-docs](https://smsonline.io/api-docs) + [premium.smsonline.cloud](https://premium.smsonline.cloud) + +--- + +## 一、Base URL + +``` +https://smsonline.io/api/v1 +``` + +> 若 premium 域名可访问，则用 `https://premium.smsonline.cloud/api/v1`（接口一致）。 +> 当前 premium 域名在本机 SSL 不通，备选用 smsonline.io。 + +--- + +## 二、鉴权 + +所有请求带 `apiKey` 参数（GET query string）： + +``` +?apiKey=你的KEY +``` + +--- + +## 三、完整接口列表 + +### 1. 获取支持的国家 + +``` +GET /virtual-number/get-countries?apiKey=KEY +``` + +返回：国家列表（含 countryId、国家名）。 + +### 2. 获取支持的服务（App/网站） + +``` +GET /virtual-number/get-services?apiKey=KEY +``` + +返回：服务列表（含 serviceId、服务名，如 Soul、bilibili、WhatsApp 等）。 + +### 3. 获取产品（某国家+某服务的可用号码/价格） + +``` +GET /virtual-number/get-products?apiKey=KEY&countryId=ID&serviceId=ID +``` + +参数： +- `countryId`：国家 ID（从接口 1 获取） +- `serviceId`：服务 ID（从接口 2 获取） + +返回：可用运营商列表、价格、库存。 + +### 4. 购买号码（获取一个临时号码） + +``` +GET /virtual-number/buy-service?apiKey=KEY&countryId=ID&serviceId=ID&operatorId=ID +``` + +参数： +- `countryId`：国家 ID +- `serviceId`：服务 ID +- `operatorId`：运营商 ID（从接口 3 获取） + +返回：分配的号码、订单 ID（后续取短信/退号用）。 + +**测试模式**：在 URL 末尾加 `&test=1`，不扣费、不分配真实号。 + +### 5. 获取短信验证码 + +``` +GET /virtual-number/get-sms?apiKey=KEY&id=订单ID +``` + +参数： +- `id`：买号时返回的订单 ID + +返回： +- 若已收到短信 → 返回验证码内容 +- 若未收到 → 返回等待状态（需轮询） + +**轮询策略**：每 5 秒请求一次，最多轮询 2 分钟（24 次）。 + +### 6. 修改订单状态（取消/完成/退号） + +``` +GET /virtual-number/change-status?apiKey=KEY&id=订单ID&status=STATUS +``` + +参数： +- `id`：订单 ID +- `status`：目标状态码 + - `3` = 已完成（确认使用，不退费） + - `4` = 取消（未收到短信，退费） + - `5` = 退款（出错退费） + +**关键**：超过 2 分钟未收到验证码 → 调 `change-status` 传 `status=4` 取消退费。 + +--- + +## 四、完整使用流程（从取号到收码到退号） + +``` +① get-countries → 拿 countryId（如中国=?） +② get-services → 拿 serviceId（如 Soul=?） +③ get-products → 拿 operatorId + 价格 +④ buy-service → 拿到号码 + 订单 id +⑤ 用该号码在目标网站发送验证码 +⑥ 轮询 get-sms（每 5 秒一次，最多 2 分钟） + ├── 收到验证码 → 使用 → change-status(id, status=3) 确认完成 + └── 超时未收到 → change-status(id, status=4) 取消退费 +``` + +--- + +## 五、防扣费规则（强制） + +1. **2 分钟超时自动退号**：轮询 get-sms 最多 120 秒（24 次 × 5 秒间隔），超时未收到验证码 → 立即调 `change-status(status=4)` 取消。 +2. **收到验证码后确认**：验证码用完后调 `change-status(status=3)` 标记完成。 +3. **不重复获取同一个号**：每次 buy-service 只分配新号；若之前取过的号还在等待中，不要再 buy 新的（先取消旧的再取新号）。 +4. **测试先用 test 模式**：首次调试在 URL 加 `&test=1`，确认流程正确后再去掉。 + +--- + +## 六、充值方式 + +1. 登录 [premium.smsonline.cloud](https://premium.smsonline.cloud)（需翻墙/代理）。 +2. 进入账户页 → 充值/Top Up。 +3. 支持：加密货币（USDT/BTC 等）、信用卡、支付宝（视站点当前支持）。 +4. 充值后余额即时到账，通过 API 购买号码时自动扣除。 + +--- + +## 七、当前网络问题 + +- `premium.smsonline.cloud` 在本机（macOS + Clash TUN）SSL 握手失败，无法直连。 +- `smsonline.io` 主站 API 可访问，但你的 API Key 是 premium 站注册的，在主站不通用（提示 invalid key）。 +- **解决方案**： + - 在浏览器里（已走 Clash 规则组）登录 premium 站确认 API Key 是否正确、是否已充值。 + - 或在 premium 站的「API」页面查看是否有另一个 Base URL。 + - 若 premium 站持续不通，可考虑联系客服确认 API 端点，或改用 smsonline.io 主站重新注册获取该站的 key。 + +--- + +## 八、脚本位置 + +- 自动化脚本：`运营中枢/scripts/smsonline_receive_sms.py`（待 API 连通后写入） +- 接收短信 Skill：`02_卡人（水）/水桥_平台对接/接收短信/SKILL.md`（待更新） + +--- + +*归位：运营中枢/参考资料 · 卡若AI* diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index e20bb117..05e9f098 100644 --- a/运营中枢/工作台/gitea_push_log.md +++ b/运营中枢/工作台/gitea_push_log.md @@ -330,3 +330,4 @@ | 2026-03-13 14:15:28 | 🔄 卡若AI 同步 2026-03-13 14:15 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | | 2026-03-13 14:17:49 | 🔄 卡若AI 同步 2026-03-13 14:17 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | | 2026-03-13 14:27:42 | 🔄 卡若AI 同步 2026-03-13 14:27 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | +| 2026-03-13 14:45:12 | 🔄 卡若AI 同步 2026-03-13 14:45 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index f75ef647..33846e59 100644 --- a/运营中枢/工作台/代码管理.md +++ b/运营中枢/工作台/代码管理.md @@ -333,3 +333,4 @@ | 2026-03-13 14:15:28 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 14:15 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-13 14:17:49 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 14:17 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-13 14:27:42 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 14:27 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | +| 2026-03-13 14:45:12 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 14:45 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |