KitchenOwl API
Use scripts/kitchenowl-api.sh for KitchenOwl operations without relying on the web UI.
Prerequisites
Quick configuration
Supported environment variables:
- -
KITCHENOWL_URL (e.g. https://kitchenowl.example.com) [preferred] - INLINECODE5 (Bearer token; access token or long-lived token)
- INLINECODE6 (optional)
- INLINECODE7 (legacy compatibility)
Main commands
CODEBLOCK0
Recommended flow for shopping-list tasks
- 1. Run
probe. - Run
login (if no valid token is available). - Use
request against shopping-list endpoints of the target instance. - If endpoint paths are unknown, start from
request GET /api and/or check instance docs.
Operational notes
- - Some instances use reverse proxies with broken redirects (example:
/api -> http://localhost/api/). - In that case, force the correct
--base-url or fix proxy settings server-side. - The script does not print plain-text passwords.
- Tokens are stored locally only in
~/.config/kitchenowl-api/session.json.
KitchenOwl API
使用 scripts/kitchenowl-api.sh 执行 KitchenOwl 操作，无需依赖 Web 界面。
前提条件
快速配置
支持的环境变量：
- - KITCHENOWLURL（例如 https://kitchenowl.example.com）[推荐]
- KITCHENOWLTOKEN（Bearer 令牌；访问令牌或长期令牌）
- KITCHENOWLREFRESHTOKEN（可选）
- KITCHENOWLBASEURL（旧版兼容）
主要命令
bash
1) 探测有用的 API 端点
{baseDir}/scripts/kitchenowl-api.sh probe --base-url https://kitchenowl.example.com
2) 登录（将令牌保存在 ~/.config/kitchenowl-api/session.json 中）
{baseDir}/scripts/kitchenowl-api.sh login \
--base-url https://kitchenowl.example.com \
--username USERNAME \
--password PASSWORD \
--device openclaw
3) 通用认证 REST 调用
{baseDir}/scripts/kitchenowl-api.sh request GET /api/user
4) 带 JSON 请求体的 REST 调用
{baseDir}/scripts/kitchenowl-api.sh request POST /api/auth/llt \
--json {device:openclaw-llt}
5) GraphQL 查询（如果实例支持）
{baseDir}/scripts/kitchenowl-api.sh graphql \
--query {
typename }
购物清单任务的推荐流程
- 1. 运行 probe。
- 运行 login（如果没有有效令牌）。
- 使用 request 访问目标实例的购物清单端点。
- 如果端点路径未知，从 request GET /api 开始，并/或查看实例文档。
操作说明
- - 某些实例使用带有错误重定向的反向代理（例如：/api -> http://localhost/api/）。
- 在这种情况下，强制使用正确的 --base-url 或在服务端修复代理设置。
- 脚本不会打印明文密码。
- 令牌仅本地存储在 ~/.config/kitchenowl-api/session.json 中。
