Inkos

Autonomous Novel Writing CLI AI Agent自动化小说写作 CLI AI Agent

English | 中文 | 日本語

AI Agent 自主写小说——写、审、改，全程接管。覆盖玄幻、仙侠、都市、科幻等多种风格，支持续写、番外、同人、仿写等创作形式。人工审核门控确保你始终掌控全局。已发布为 OpenClaw skill。

InkOS Studio 正式发布！ — inkos studio 启动本地 Web 工作台。书籍管理、章节审阅编辑、实时写作进度、市场雷达、数据分析、AI 检测、文风分析、题材管理、守护进程控制、真相文件编辑——CLI 能做的，Studio 全部可视化。

Native English novel writing now supported！ Set --lang en to write in English. See English README for details.

欢迎交流

当前更新相对频繁，后续会持续新增功能与优化写作效果。 欢迎加群反馈问题、提出需求，也欢迎关注项目动态 — 我们的目标是做最强的基于小说的内容生态创作 AI Agent。

快速开始

安装

npm i -g @actalk/inkos

通过 OpenClaw 使用 🦞

InkOS 已发布为 OpenClaw Skill，可被任何兼容 Agent（Claude Code、OpenClaw 等）直接调用：

clawhub install inkos          # 从 ClawHub 安装 InkOS Skill

通过 npm 安装或克隆本项目时，skills/SKILL.md 已包含在内，🦞 可直接读取——无需额外从 ClawHub 安装。

安装后，Claw 可通过 exec 调用 InkOS 的原子命令和控制面操作（plan chapter/compose chapter/draft/audit/revise/write next），--json 输出结构化数据供 Claw 解析决策。推荐流程是先更新 author_intent.md 或 current_focus.md，再 plan / compose，最后决定是否 draft 或完整 write next。也可以在 ClawHub 搜索 inkos 在线查看。

配置

方式一：全局配置（推荐，只需一次）

inkos config set-global \
  --provider  \
  --base-url  \
  --api-key  \
  --model 

# provider: openai / anthropic / custom（兼容 OpenAI 格式的中转站选 custom）
# base-url: 你的 API 提供商地址
# api-key: 你的 API Key
# model: 你的模型名称

配置保存在 ~/.inkos/.env，所有项目共享。之后新建项目不用再配。

方式二：项目级 `.env`

inkos init my-novel     # 初始化项目
# 编辑 my-novel/.env

# 必填
INKOS_LLM_PROVIDER=                               # openai / anthropic / custom（兼容 OpenAI 接口的都选 custom）
INKOS_LLM_BASE_URL=                               # API 地址（支持中转站、智谱、Gemini 等）
INKOS_LLM_API_KEY=                                 # API Key
INKOS_LLM_MODEL=                                   # 模型名

# 可选
# INKOS_LLM_TEMPERATURE=0.7                       # 温度
# INKOS_LLM_MAX_TOKENS=8192                        # 最大输出 token
# INKOS_LLM_THINKING_BUDGET=0                      # Anthropic 扩展思考预算

项目 .env 会覆盖全局配置。不需要覆盖时可以不写。

方式三：多模型路由（可选）

给不同 Agent 分配不同模型，按需平衡质量与成本：

# 给不同 agent 配不同模型/提供商
inkos config set-model writer  --provider  --base-url  --api-key-env 
inkos config set-model auditor  --provider 
inkos config show-models        # 查看当前路由

未单独配置的 Agent 自动使用全局模型。

v1 更新

InkOS Studio + 写作管线全面升级