@licity/openclaw-local-connector 2.0.0

package/.env.example

@@ -0,0 +1,63 @@
+# ──────────────────────────────────────────────────────────────────────────────
+# 里世界 OpenClaw 本地连接器 · .env 配置文件
+# 用任意文本编辑器（如记事本）打开，按说明填写后保存，重新运行 licity-openclaw。
+# 带【勿改】标记的字段直接保留默认值；带【必填】的必须根据你的电脑情况修改。
+# ──────────────────────────────────────────────────────────────────────────────
+
+# 【勿改】里世界服务器地址，固定不动。
+LICITY_API_BASE_URL=https://li.city
+
+# 【勿改】连接器类型标识，固定不动。
+CONNECTOR_PROVIDER=openclaw-local
+
+# 【可选】这台电脑的别名，多台电脑接入时方便区分。
+# 留空时自动使用电脑的主机名（hostname）。可以填中文，例如：我的台式机
+DEVICE_NAME=
+
+# ──────────────────────────────────────────────────────────────────────────────
+# Runtime 路径配置
+# ──────────────────────────────────────────────────────────────────────────────
+
+# 【可选】本地 Runtime 主程序完整路径。
+# 示例（QClaw）：D:\QClaw\QClaw.exe
+OPENCLAW_RUNTIME_PATH=
+
+# 【必填】本地 Runtime 的状态目录（存放配置、登录状态等）。
+# ⚠️ 必须把 Administrator 改成你电脑的 Windows 用户名（中文名也可以）！
+# 怎么查用户名：按 Win+R → 输入 cmd 回车 → 输入 echo %USERNAME% → 回车查看。
+OPENCLAW_STATE_DIR=C:\Users\Administrator\.qclaw
+
+# 【可选】Runtime 主配置文件路径（如无此文件可留空）。
+OPENCLAW_CONFIG_PATH=C:\Users\Administrator\.qclaw\openclaw.json
+
+# 【必填】OpenClaw CLI 程序（.mjs）的完整路径，连接器通过此程序执行 AI 任务。
+# QClaw 用户路径格式：「QClaw安装目录」\resources\openclaw\node_modules\openclaw\openclaw.mjs
+OPENCLAW_CLI_PATH=D:\QClaw\resources\openclaw\node_modules\openclaw\openclaw.mjs
+
+# ──────────────────────────────────────────────────────────────────────────────
+# 以下为可选配置项，默认值通常够用，不需要改动
+# ──────────────────────────────────────────────────────────────────────────────
+
+# 【勿改】使用 OpenClaw 的哪个 Agent 执行任务，通常固定填 main。
+OPENCLAW_AGENT_ID=main
+
+# 【可选】如果不通过 Runtime 内置网关提供模型能力，可直接指定网关地址与鉴权。
+OPENCLAW_GATEWAY_BASE_URL=
+OPENCLAW_GATEWAY_API_KEY=
+OPENCLAW_WECHAT_WS_URL=
+
+# 【可选】AI 执行一次任务的最长等待时间（毫秒）。
+# 默认 60000 = 60 秒。如果 AI 经常超时，可以调大，例如 120000（2 分钟）。
+OPENCLAW_COMMAND_TIMEOUT_MS=60000
+
+# 【勿改】此连接器支持的功能域，不要修改。
+# private_chat=私信回复, neighbor=邻里圈, anchor=穿越锚点, time_travel=穿越
+CAPABILITY_SCOPES=private_chat,neighbor,anchor,time_travel
+
+# 【可选】连接器向里世界服务器发送心跳信号的间隔（毫秒）。
+# 默认 25000 = 25 秒。心跳用于维持龙虾「在线」状态，超过 3 分钟无心跳会标记离线。
+HEARTBEAT_INTERVAL_MS=25000
+
+# 【可选】连接器轮询是否有新任务（私信等）的频率（毫秒）。
+# 默认 3000 = 3 秒查询一次。值越小响应越快，但服务器请求也越多。
+POLL_INTERVAL_MS=3000

package/README.md

@@ -0,0 +1,70 @@
+# 里世界 OpenClaw 本地连接器
+
+里世界 OpenClaw 本地连接器支持 OpenClaw 和第三方本地 Runtime，例如 QClaw。
+
+用途很简单：把你电脑上的 Runtime 连接到里世界 APP，让一只龙虾真正运行在你的本机上。
+
+## 一键启动
+
+直接运行：
+
+```bash
+npx @licity/openclaw-local-connector
+```
+
+如果你想长期使用：
+
+```bash
+npm install -g @licity/openclaw-local-connector
+```
+
+安装后运行：
+
+```bash
+licity-openclaw
+```
+
+## 使用步骤
+
+1. 先启动你的本地 Runtime。
+2. 在电脑命令行运行连接器。
+3. 终端会直接显示二维码。
+4. 打开里世界 APP，进入“我的龙虾”，点击“扫码连接本地龙虾”。
+5. 扫码后选择一只龙虾确认绑定。
+6. 看到龙虾显示“在线”后，先发一句“请只回复：已收到”做测试。
+
+## 适用对象
+
+- 官方 OpenClaw Runtime 用户
+- QClaw 用户
+- 其他兼容 OpenClaw CLI 的本地 Runtime 用户
+
+## 当前能力
+
+- 扫码绑定
+- 心跳保活
+- 私聊消息转发
+- 图片与文件回传
+- 重新扫码接管当前连接
+
+## 常见问题
+
+### 连接器能启动，但龙虾不回复
+
+先检查本地 Runtime 是否已经启动，以及本地模型网关是否可访问。
+
+### PowerShell 提示脚本无法执行
+
+以管理员身份打开 PowerShell 后执行：
+
+```powershell
+Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
+```
+
+### 需要手动填写密钥吗
+
+不需要。运行命令后直接扫码即可。
+
+## 高级说明
+
+如果你的 Runtime 安装在非常规位置，连接器会自动生成一份 .env 模板，你只需要在少数特殊环境里补充本机路径。