🦀 OpenCrabs

自主化、自进化的 AI 智能体。单一 Rust 二进制文件。全渠道支持。

由 Rust 构建的自主、自进化多渠道 AI 智能体。灵感来源于 Open Claw。

    ___                    ___           _
   / _ \ _ __  ___ _ _    / __|_ _ __ _| |__  ___
  | (_) | '_ \/ -_) ' \  | (__| '_/ _` | '_ \(_-`, 切换配置请使用 `-p `。使用 `profile migrate` 在不同配置文件间迁移。支持导出/导入以便分享。Token 锁定隔离机制可防止两个配置文件使用相同的机器人凭据。

### CLI
| 命令 | 说明 |
|---------|-------------|
| `opencrabs` | 启动交互式 TUI (默认) |
| `opencrabs chat` | 启动带有可选 `--session ` 的 TUI 以恢复会话，`--onboard` 强制运行引导向导 |
| `opencrabs run ` | 非交互式执行单个 prompt。`--auto-approve` / `--yolo` 用于无人值守模式。`--format text\|json\|markdown` |
| `opencrabs agent` | 交互式 CLI 智能体 — 终端内多轮对话，不使用 TUI。`-m ` 用于单条消息模式 |
| `opencrabs status` | 系统概览：版本、提供商、渠道、数据库、大脑、cron、动态工具 |
| `opencrabs doctor` | 全面诊断：配置、提供商连接性、数据库、大脑、渠道、PATH 中的 CLI 工具 |
| `opencrabs init` | 初始化配置 (`--force` 覆盖旧配置) |
| `opencrabs config` | 显示当前配置 (`--show-secrets` 以显示密钥) |
| `opencrabs onboard` | 运行入站引导配置向导 |
| `opencrabs channel list` | 列出所有已配置的渠道及其启用/禁用状态 |
| `opencrabs channel doctor` | 对所有启用的渠道运行健康检查 |
| `opencrabs memory list` | 列出大脑文件和记忆条目 |
| `opencrabs memory get ` | 显示特定记忆或大脑文件的内容 |
| `opencrabs memory stats` | 记忆统计信息：文件数、总大小、条目数 |
| `opencrabs session list` | 列出所有包含提供商、模型、Token 计数的会话 (`--all` 包含已存档会话) |
| `opencrabs session get ` | 显示会话详情和最近消息 |
| `opencrabs db init` | 初始化数据库 |
| `opencrabs db stats` | 显示数据库统计信息 |
| `opencrabs db clear` | 清除所有会话和消息 (`--force` 跳过确认) |
| `opencrabs cron add\|list\|remove\|enable\|disable\|test` | 管理定时 cron 任务 |
| `opencrabs logs status\|view\|clean\|open` | 日志管理 |
| `opencrabs service install\|start\|stop\|restart\|status\|uninstall` | 操作系统服务管理 (macOS 使用 launchd，Linux 使用 systemd) |
| `opencrabs daemon` | 以无头守护进程模式运行 — 仅处理渠道，无 TUI |
| `opencrabs completions ` | 生成 shell 自动补全脚本 (bash, zsh, fish, powershell) |
| `opencrabs version` | 打印版本并退出 |

全局标志：`--debug` (启用文件日志记录), `--config ` (自定义配置文件), `--profile ` / `-p ` (以指定名称的配置文件运行)。

### 配置文件 — 多实例 Crab 智能体

在同一个安装路径下运行多个隔离的 OpenCrabs 实例。每个配置文件都拥有独立的配置、大脑文件、记忆、会话、数据库和服务网关。

| 命令 | 说明 |
|---------|-------------|
| `opencrabs profile create ` | 创建一个带有全新配置和大脑文件的新配置文件 |
| `opencrabs profile list` | 列出所有配置文件及其最后使用时间 |
| `opencrabs profile delete ` | 删除一个配置文件及其所有数据 |
| `opencrabs profile export  -o profile.tar.gz` | 将配置文件导出为便携式存档 |
| `opencrabs profile import profile.tar.gz` | 从存档导入配置文件 |
| `opencrabs profile migrate --from  --to ` | 在不同配置文件间复制配置和大脑文件 (不包含数据库或会话) |
| `opencrabs -p ` | 以指定配置文件启动 OpenCrabs |

**默认配置文件：** `~/.opencrabs/` — 工作方式与之前完全一致，无需迁移。从未使用过配置文件的用户不会感知到任何差异。

**命名配置文件** 位于 `~/.opencrabs/profiles//` 下，具备完全的隔离性：

~/.opencrabs/ ├── config.toml # 默认配置文件 ├── opencrabs.db ├── profiles.toml # 配置文件注册表 ├── locks/ # Token 锁定文件 └── profiles/ ├── hermes/ # 命名配置文件 │ ├── config.toml │ ├── keys.toml │