本地安装

开发者启动路径

四步启动本地 MathClaw 运行环境

安装依赖、准备 workspace、启动 gateway、打开 console，四步完成本地部署。

Python 包共享 workspaceGatewayConsole

01

安装依赖

创建虚拟环境，以 editable 模式安装 MathClaw。

02

准备 workspace

创建 sessions、memory 和 cron 所需的目录结构。

03

启动 gateway

指定 workspace 和通道，启动代理运行时。

04

打开 console

让控制台连接到同一个 workspace，确保数据一致。

1. 安装依赖

python -m venv .venv
. .venv/bin/activate
pip install -e .

2. 准备工作区

mkdir -p workspace/sessions
mkdir -p workspace/memory
mkdir -p workspace/cron

3. 启动 gateway

mathclaw gateway \
  --workspace ./workspace \
  --channel wecom

4. 启动控制台

cd console
MATHCLAW_CONSOLE_WORKSPACE=../workspace python serve.py

默认控制台地址：

http://127.0.0.1:6006

启动后确认事项

• gateway 启动时无模型或通道报错
• console 能正常打开运行状态、定时任务和记忆页面
• 进行一次真实交互后，workspace 中生成 session 和 memory 文件

为什么要显式传入 workspace

• 避免 console 和 gateway 指向不同目录
• 所有页面读取同一份数据，保证一致性
• 使用仓库相对路径，方便在不同机器间迁移