快速开始¶

从零到运行 myopenclaw 的完整流程。

前置要求¶

Docker Desktop 已安装并运行
云盘客户端（Google Drive / OneDrive）已登录并完成本地同步（可选，用于备份）

1. 克隆仓库¶

git clone https://github.com/OuyangWenyu/myopenclaw.git
cd myopenclaw

2. 配置环境变量¶

cp .env.example .env

.env 中需要填写的项目：

变量	必填？	说明
`DEEPSEEK_API_KEY`	推荐	DeepSeek API Key，Claude Code 和 OpenClaw 默认模型使用
`XIAOMI_API_KEY`	可选	小米 MiMo API Key，仅虾酱的 TTS 语音回复用（`mimo-v2.5-tts`）；不填则该能力不可用，其余 agent 已不依赖
`GLM_API_KEY`	可选	智谱 API Key，Hermes 备用模型
`CC_CONNECT_FEISHU_APP_ID` / `SECRET`	可选	cc-connect 飞书应用凭证
`GH_TOKEN`	可选	GitHub PAT，gh CLI 认证用
`OPENCODE_API_KEY`	可选	opencode 专用 Key
`MOONSHOT_API_KEY`	可选	Moonshot API Key，OpenClaw 备份模型
`UNPAYWALL_EMAIL`	可选	Unpaywall 联系邮箱
`LARK_CLI_APP_ID` / `SECRET`	可选	lark-cli 主应用
`LARK_CLI_IDM_APP_ID` / `SECRET`	可选	lark-cli 第二 profile
`DISCORD_BOT_TOKEN`	可选	Hermes coder Discord Bot Token
`DAOYUAN_FEISHU_APP_ID` / `SECRET`	可选	道元·文献学者飞书应用凭证
`FINANCE_FEISHU_APP_ID` / `SECRET`	可选	Finance 飞书应用凭证
`CODER_FEISHU_APP_ID` / `SECRET`	可选	爱码士（hermes-coder）独立飞书应用凭证（可与 `LARK_CLI_IDM_*` 同值）
`UPK_USER` / `UPK_PASS`	可选	Uptime Kuma 账号占位（模板里有，但 `setup-uptime-kuma.sh` 不读取；实际账号在 Web UI 创建）
`YUQUE_TOKEN`	可选	语雀只读 token（`repo:read` + `doc:read`），本机 `yuque-mcp` 服务端用；不填则语雀查询与变更日报不可用（`start.sh` 会警告）
`MCP_YUQUE_MCP_API_KEY`	可选	yuque-mcp 访问 key（服务端与 Hermes/天一客户端共享的单一来源）；配 `YUQUE_MCP_URL` 后才会注册语雀日报 cron

配置云盘路径¶

cp .cloud.conf.example .cloud.conf
# 编辑 .cloud.conf，填写本机云盘实际路径
./scripts/setup-cloud.sh

3. 克隆依赖仓库（可选）¶

部分能力需要额外的仓库。跳过不影响核心服务运行：

./scripts/clone-deps.sh       # 克隆 dailyinfo、aisecretary、git-contribution-stats、yuque_mcp_server

如需 zhixun 知汛助手（水文智能问答飞书机器人），额外克隆：

git clone https://gitcode.com/dlut-water/zhixun-agent.git ../zhixun-agent

依赖关系详见可移植性。

4. 启动服务¶

./scripts/start.sh

首次启动或镜像变更后加 --build：

./scripts/start.sh --build

首次启动自动完成的操作¶

自动操作	目标位置
创建 opencode 配置	`~/.config/opencode/opencode.json`
创建 Claude Code 配置	`~/.claude/settings.json`
创建 cc-connect 配置	`~/.cc-connect/config.toml`
创建 OpenClaw 配置	`~/.openclaw/openclaw.json`
安装 paper-fetch skill	`~/.openclaw/skills/paper-fetch`、`~/.hermes/skills/paper-fetch`
接入 paper-queue（道元）	`~/.hermes/profiles/daoyuan/config.yaml`（MCP 条目）、`~/.hermes/profiles/daoyuan/skills/paper-queue`（symlink）；并清理旧虾酱残留
注册 Uptime Kuma 监控项	`~/.uptime-kuma/kuma.db`（容器已 Up 时才执行）
物化黑名单 API Key	容器内 `/opt/data/secrets/`
生成 himalaya 邮件配置	`~/.hermes/.config/himalaya/config.toml`
生成 ortie Outlook OAuth 配置	`~/.hermes/.config/ortie/config.toml`（首次授权需手动 `ortie auth get`）
生成 cardamum 联系人配置	`~/.hermes/home/.config/cardamum/config.toml`
映射 DEEPSEEK_API_KEY → ANTHROPIC_API_KEY	claude-code 容器环境变量
初始化 lark-cli 配置	`~/.lark-cli/`

启动后：安装宿主机定时任务¶

Docker 容器内的定时任务（备份、晨间四签、语雀日报）由 start.sh 自动注册。宿主机 launchd 定时任务需要手动安装：

# 一键安装所有宿主机定时任务（幂等）
./scripts/launchd/install-all-schedulers.sh

或按需选择：

./scripts/launchd/install-healthchecks-ping.sh # Healthchecks.io 心跳
./scripts/launchd/install-collect-agentops.sh  # AgentOps 健康采集

全部定时任务的总览和时序依赖详见调度系统。

5. 启动 zhixun 知汛助手（可选）¶

知汛是团队侧公共 bot（与天一同类，背后的 zhixun-agent 水文 MCP 是团队服务）；本节是本机可选部署，服务器侧分界见部署到服务器（团队侧）时要看什么。

zhixun 知汛助手是独立 Compose 栈，不与主栈一起拉起。需要先克隆 zhixun-agent 仓库并创建配置：

cp .env.zhixun-bot.example .env.zhixun-bot

编辑 .env.zhixun-bot，必填项：

变量	说明
`ZHIXUN_BOT_FEISHU_APP_ID` / `SECRET`	飞书自建应用凭据
`ZHIXUN_BOT_MODEL_API_KEY`	DeepSeek API Key

启动：

./scripts/start-zhixun-bot.sh --build    # 首次启动（构建 MCP 镜像）
./scripts/start-zhixun-bot.sh            # 后续启动

查看状态：

docker compose --env-file .env.zhixun-bot -f docker-compose.zhixun-bot.yml ps
docker compose --env-file .env.zhixun-bot -f docker-compose.zhixun-bot.yml logs -f openclaw-zhixun

详见 zhixun 知汛助手。

6. 启动 tianyi 天一研发助手（可选）¶

tianyi 天一研发助手同样是独立 Compose 栈（docker-compose.tianyi-bot.yml），但它共享主栈的 myopenclaw-net 网络、复用主栈的 repo-scanner-mcp，所以必须先拉起主栈——start-tianyi-bot.sh 会检查 repo-scanner-mcp 是否在运行，不在就直接退出。

cp .env.tianyi-bot.example .env.tianyi-bot

编辑 .env.tianyi-bot，必填项（脚本只校验这三个，为空或仍是占位符会报错退出）：

变量	说明
`TIANYI_BOT_FEISHU_APP_ID` / `SECRET`	飞书自建应用凭据
`TIANYI_BOT_MODEL_API_KEY`	DeepSeek API Key

启动：

./scripts/start-tianyi-bot.sh --build    # 首次启动
./scripts/start-tianyi-bot.sh            # 后续启动（内部 --force-recreate）

查看状态：

docker compose --env-file .env.tianyi-bot -f docker-compose.tianyi-bot.yml ps
docker compose --env-file .env.tianyi-bot -f docker-compose.tianyi-bot.yml logs -f openclaw-tianyi

数据目录 ~/.openclaw-tianyi（可用 TIANYI_BOT_DATA_DIR 覆盖，但不能落在 ~/.openclaw 内）。

7. 从云盘恢复数据（可选）¶

新机器首次部署可跳过。从旧机器迁移时：

./scripts/restore.sh all latest
./scripts/restore.sh hermes latest
./scripts/restore.sh claude 2026-04-23_090000

如果恢复了 ~/.openclaw/openclaw.json 或 ~/.cc-connect/config.toml，start.sh 不会覆盖它们。

8. 配置渠道¶

按需配置：

cc-connect 飞书：在飞书开发者后台创建应用 → 开启机器人 → 填入 .env 中 CC_CONNECT_FEISHU_* 凭证
OpenClaw 渠道：详见 OpenClaw 渠道
Hermes 渠道：详见 Hermes 渠道
lark-cli 授权：详见飞书 CLI

日常命令¶

./scripts/start.sh                        # 启动所有服务
./scripts/stop.sh                         # 停止所有服务
docker compose ps                         # 查看服务状态
docker compose logs -f hermes             # 查看 Hermes 日志
docker compose logs -f claude-code        # 查看 Claude Code 日志
docker compose exec backup-cron /scripts/backup-all-docker.sh  # 手动备份